thoughtbox-dot-claude

A comprehensive, reusable .claude/ configuration folder for Claude Code CLI. This repository contains a curated collection of skills, commands, hooks, plugins, agents, and a learning memory system to enhance Claude Code workflows.

Quick Start

Copy the .claude/ folder into any project:

# Clone and copy
git clone https://github.com/Kastalien-Research/thoughtbox-dot-claude.git
cp -r thoughtbox-dot-claude/.claude/ /path/to/your/project/

What's Included

/agents - Custom Sub-Agents

Specialized agents for specific tasks:

• meta-agent.md - Generates new sub-agent configuration files from descriptions
• fact-checking-agent.md - Verifies claims in documentation against sources of truth
• reasoning-evaluator.md - Evaluates reasoning quality and logical consistency

/ai_docs - Reference Documentation

Curated documentation for AI context:

• Anthropic docs - Claude Code hooks, subagents, custom commands, output styles
• OpenAI quick start - Reference for OpenAI API patterns
• Memory system design - Full design documentation for the memory system
• uv single-file scripts - Python scripting patterns

/bin - Memory CLI Tools

Command-line utilities for the memory system:

Command	Description
memory-add	Add new learnings to memory
memory-query	Search memory for relevant patterns
memory-stats	View memory system statistics
memory-rank	Rank memory entries by relevance
memory-pipe	Pipe content into memory

/commands - Slash Commands (Skills)

Organized collection of 60+ slash commands:

Core Categories

Category	Description	Key Commands
analysis/	Code analysis & insights	/context-aware-review, /knowledge-graph, /evolution-tracker
clear-thought/	Structured thinking	/think-solve, /think-debug, /think-decide, /think-create
debugging/	Systematic debugging	/systematic-debug, /distributed-debug, /temporal-debug
development/	Code generation	/implementation-variants, /spec-to-test, /implement-spec
exploration/	Solution discovery	/parallel-explorer
loops/	OODA loop building blocks	Authoring, exploration, verification, refinement loops
meta/	Higher-order frameworks	/ulysses-protocol, /virgil-protocol, /learning-accelerator
orchestration/	Multi-agent coordination	/swarm-intelligence, /meta-orchestrator, /adaptive-workflow
research/	Research workflows	/docs-researcher
speckit.*	Specification workflows	/speckit.specify, /speckit.plan, /speckit.tasks, /speckit.implement
startup/	Session initialization	/prime, /metacursor, /metaclaude
synthesis/	Pattern extraction	/pattern-synthesizer, /knowledge-fusion, /wisdom-distillation
toolscontext/	MCP tool context	/exa, /firecrawl, /context7
workflows/	MCP orchestration	/mcp-workflow, /mcp-chain, /mcp-orchestrate

Memory Commands

• /memory-start - Initialize memory system
• /memory-add-quick - Quick add to memory
• /memory-search - Search memory

/hooks - Lifecycle Hooks

Event-driven shell scripts for Claude Code:

Hook	Trigger	Purpose
pre_tool_use.sh	Before tool execution	Block dangerous git operations, validate commands
post_tool_use.sh	After tool execution	Log operations, track file access
session_start.sh	Session begins	Load context, show memory status
session_end_memory.sh	Session ends	Prompt for learning capture
user_prompt_submit.sh	User submits prompt	Pre-process user input
git-validator.sh	Permission requests	Advanced git validation (block/approve/prompt)
notification.sh	Various events	Desktop notifications
track_file_access.sh	File operations	Track which files agents access
memory_pattern_detector.sh	Periodic	Identify memory gaps and patterns

Protection Features:

• Blocks force pushes and direct pushes to protected branches
• Prevents dangerous rm -rf operations
• Validates commit message format
• Logs all git operations for audit trail

/hooks-alternate - Alternative Hook Set

Alternative hook implementations with additional utilities:

• utils/llm/ - LLM API wrappers (Anthropic, OpenAI, Ollama)
• utils/tts/ - Text-to-speech integrations (ElevenLabs, OpenAI, pyttsx3)

/output-styles - Response Formatting

Customize Claude's output format:

Style	Description
ultra-concise.md	Minimal, essential information only
bullet-points.md	Structured bullet point format
markdown-focused.md	Rich markdown formatting
table-based.md	Tabular data presentation
yaml-structured.md	YAML-formatted responses
html-structured.md	HTML-formatted output
tts-summary.md	Optimized for text-to-speech
genui.md	Generative UI components

/plugins - Claude Code Plugins

Modular extensions with commands and agents:

agent-sdk-dev

• Command: /new-sdk-app - Scaffold new Agent SDK projects
• Agents: SDK verifiers for Python and TypeScript

commit-commands

• Commands: /commit, /commit-push-pr, /clean_gone
• Purpose: Streamlined git workflows

feature-dev

• Command: /feature-dev - 7-phase feature development workflow
• Agents: code-explorer, code-architect, code-reviewer

pr-review-toolkit

• Command: /review-pr - Comprehensive PR review
• Agents: code-reviewer, silent-failure-hunter, code-simplifier, comment-analyzer, pr-test-analyzer, type-design-analyzer

security-guidance

• Purpose: Security-focused hooks and validation

/rules - Learning Memory System

A living memory system that improves over time:

rules/
├── 00-meta.md              # How the memory system works
├── TEMPLATE.md             # Template for new rules
├── active-context/         # Current work focus
│   └── current-focus.md
├── infrastructure/         # System-level patterns
│   ├── firebase.md
│   └── hooks-calibration.md
├── lessons/                # Time-stamped learnings
│   └── 2026-01-version-control-safety.md
├── testing/                # Testing conventions
│   └── behavioral-tests.md
└── tools/                  # Tool-specific patterns
    └── thoughtbox.md

Key Features:

• Path-specific auto-loading: Rules load automatically when working on matching files
• Freshness tags: Hot (2 weeks), Warm (3 months), Cold (>3 months), Archived
• Calibration metrics: Track discovery time, coverage gaps, repeated issues
• Progressive learning: Memory improves with each agent interaction

/skills - Reusable Skills

Domain expertise modules:

Skill	Description
docker/	Multi-stage builds, security, optimization
effect-ts/	Effect-TS functional TypeScript patterns
firebase-firestore/	Firebase Admin SDK and Firestore
gcp-cloud-run/	Google Cloud Run deployment
mcp-builder/	Building MCP servers
mcp-client-builder/	Building MCP clients
skill-creator/	Creating new skills
thoughtbox-expertise/	ThoughtBox MCP server patterns
thoughtbox-mcp/	Building thoughtbox-style MCP servers
zod4/	Zod 4 schema validation

/status_lines - Status Line Scripts

Python scripts for custom Claude Code status lines (v2, v3, v4 variants).

/data & /state

• data/ - Persistent data storage
• state/ - Runtime state (hook logs, calibration data, file access logs)

settings.local.json

Local settings for enabled MCP servers:

{
  "enabledMcpjsonServers": [
    "github",
    "thoughtbox",
    "firecrawl-mcp",
    "context7"
  ]
}

Memory System Overview

The memory system is designed to make salient information "ready at hand":

1. Capture - Document learnings as they happen
2. Consolidate - Integrate patterns into domain rules
3. Prune - Archive stale information
4. Calibrate - Track metrics to improve topology

Using Memory

# Check current focus
/read .claude/rules/active-context/current-focus.md

# Search memory
/memory-search "pattern name"

# Capture a learning
/meta capture-learning

# View memory status
.claude/bin/memory-stats

Customization

Adding New Rules

1. Copy TEMPLATE.md to the appropriate domain folder
2. Add YAML frontmatter with path patterns
3. Document learnings in the standard format

Creating New Commands

Add markdown files to /commands/[category]/:

# Command Name

Description of what this command does.

## Usage

/command-name [args]

## Implementation

[Command logic here]

Adding Hooks

1. Create shell script in /hooks/
2. Make executable: chmod +x .claude/hooks/your-hook.sh
3. Configure in .claude/settings.json

Repository Structure

.claude/
├── agents/          # Custom sub-agents
├── ai_docs/         # Reference documentation
├── bin/             # CLI utilities
├── commands/        # Slash commands (60+)
├── data/            # Persistent data
├── hooks/           # Lifecycle hooks
├── hooks-alternate/ # Alternative hooks with LLM/TTS utils
├── output-styles/   # Response formatting
├── plugins/         # Modular extensions
├── rules/           # Learning memory system
├── skills/          # Domain expertise
├── state/           # Runtime state
├── status_lines/    # Status line scripts
└── settings.local.json

License

MIT

Contributing

1. Fork the repository
2. Add your improvements
3. Submit a pull request

Focus areas for contributions:

• New skills for common development tasks
• Additional hooks for safety and automation
• Memory system improvements
• New slash commands for workflows