claude-code-prompt-plunderer: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

This repository contains a Python utility for analyzing Claude Code conversation history stored in JSONL files. The tool extracts user prompts from conversation logs and provides analysis capabilities including deduplication and statistical summaries.

Project Structure

• plunder_prompts.py - Main Python script that extracts and analyzes user prompts from Claude Code conversation JSONL files
• prompts/ - Directory containing 5 creative prompt analysis templates
  • slash_command_discovery.md - Suggests custom Claude Code slash commands based on usage patterns
  • style_tengu.md - Creates ASCII Tengu character representing prompting personality
  • frequency_chart.md - Generates ASCII visualizations of prompt patterns
  • evolution_timeline.md - Shows prompting style evolution over time
  • personality_report.md - Produces personality analysis based on prompting patterns
  • README.md - Documentation for using the prompt templates
• examples/ - Sample output files demonstrating the tool's capabilities
  • sample_output.json - Example JSON output from the extraction tool
  • sample_output.md - Example Markdown analysis output

Commands

Running the Script

# Basic usage (uses default settings)
python3 plunder_prompts.py

# Specify custom base directory for Claude conversations
python3 plunder_prompts.py --base-dir /path/to/claude/projects

# Filter prompts by length
python3 plunder_prompts.py --min-length 100 --max-length 500

# Specify custom output file
python3 plunder_prompts.py --output ./my_prompts.json

Using Prompt Analysis Templates

After extracting prompts, use the analysis templates with Claude Code:

# Discover potential slash commands from your usage patterns
claude "$(cat prompts/slash_command_discovery.md)"

# Generate ASCII Tengu character representing your style
claude "$(cat prompts/style_tengu.md)"

# Create frequency charts and visualizations
claude "$(cat prompts/frequency_chart.md)"

# View your prompting evolution timeline
claude "$(cat prompts/evolution_timeline.md)"

# Get personality analysis based on prompts
claude "$(cat prompts/personality_report.md)"