Thinking Log Plugin for Claude Code

A Claude Code plugin that automatically creates and maintains THINKING_LOG.md files documenting Claude's reasoning process, decisions, and problem-solving approach during implementation tasks.

Features

• Structured Documentation: Organized entries with Flow, Thinking, Decision, Action, Result format
• Visual Diagrams: Mermaid diagrams for flowcharts, sequence diagrams, mind maps, and git graphs
• Privacy-Aware: Default storage outside project source to avoid committing AI files
• Slash Command: /thinking-log for quick access to common operations
• Auto-Trigger: Skill activates automatically during complex implementations

Installation

From GitHub

/plugin https://github.com/mduongvandinh/claude-thinking-log-plugin

Manual Installation

1. Clone or download this repository
2. Copy to your Claude Code plugins directory:

   cp -r thinking-log-plugin ~/.claude/plugins/

Usage

Slash Command

# Initialize a new thinking log
/thinking-log init

# Add an entry
/thinking-log add --title "Implemented authentication"

# Add session summary
/thinking-log summary

# Show log status
/thinking-log show

Automatic Skill Activation

The skill automatically activates when:

• User requests documentation of thinking/reasoning process
• Working on complex multi-step implementations
• User mentions "thinking log", "reasoning log", "decision log"
• Creating audit trails for code changes

File Structure

thinking-log-plugin/
├── .claude-plugin/
│   └── plugin.json           # Plugin manifest
├── commands/
│   └── thinking-log.md       # /thinking-log command
├── skills/
│   └── thinking-log/
│       ├── SKILL.md          # Main skill definition
│       └── references/
│           ├── advanced-patterns.md   # Complex diagram patterns
│           └── starter-template.md    # New log template
└── README.md

THINKING_LOG.md Structure

# Thinking Log - {Project Name}

## Session: {DATE}

### {Timestamp} - {Task Title}

**Flow:**
[Mermaid diagram]

**Thinking:**
[Raw reasoning]

**Decision:** [What was decided]
**Action:** [What was done]
**Result:** [Outcome]

Entry Types

Type	Use Case
Analysis	Understanding code/requirements
Decision	Choosing between alternatives
Implementation	Tracking build steps
Error Resolution	Documenting troubleshooting
Branch/Merge	Git operations

Mermaid Diagram Types

Diagram	Syntax	Best For
Flowchart	flowchart LR/TD	Process flows
Sequence	sequenceDiagram	API interactions
Mind Map	mindmap	Concepts/architecture
Git Graph	gitGraph	Branch strategy

Storage Location

Default (recommended):

~/.claude/projects/{project-name}/docs/THINKING_LOG.md

Project-local (with --project flag):

{project-root}/docs/THINKING_LOG.md

The default location keeps AI-related files outside project source, useful when:

• Project policies prohibit AI-generated files
• Multiple developers share the project
• You want thinking logs private

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

License

MIT License

Author

DINHDV (https://www.facebook.com/m.duongvandinh)

Links

• Claude Code Documentation
• Mermaid Diagram Syntax
• Claude Code Plugins Guide