46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# 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 |