# 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