trax/.claude/README.md

Claude Code Configuration

This directory contains Claude Code customizations for the Trax project.

Directory Structure

.claude/
├── tasks/           # Feature plans and specifications
│   └── <feature>.md # Detailed implementation plan for each feature
├── context/         # Shared context files
│   └── session.md   # Current session context (updated by all agents)
├── research/        # Sub-agent research reports
│   └── <topic>.md   # Research findings from specialized agents
├── hooks/           # Automation hooks
│   ├── task-complete.sh    # Notification when tasks complete
│   └── type-check.py       # Real-time type checking
├── commands/        # Custom slash commands
│   └── *.md        # Custom commands for repeated workflows
└── agents/          # Sub-agent definitions
    └── *.md        # Specialized research agents

Usage

Context Management

• All agents read from context/session.md at start
• All agents update context/session.md after completing work
• Research findings go in research/ for persistence

Planning Workflow

1. Enter plan mode (Shift+Tab twice in Claude Code)
2. Create plan in tasks/<feature-name>.md
3. Break down into phases
4. Update as you progress

Sub-Agents

• Sub-agents are for RESEARCH ONLY
• They create reports in research/
• Main agent does ALL implementation

Best Practices

• Keep context files under 500 lines
• Update session.md after each major step
• Use filesystem as ultimate context manager
• Sub-agents never implement, only research