History

enias 8d5e11cd66 feat: Setup parallel development with Git worktrees and documentation - Created setup_worktrees.sh script for automated worktree creation - Established 5 default worktrees (features, testing, docs, performance, bugfix) - Added convenience scripts for switching and status checking - Documented comprehensive parallel development workflow - Each worktree has independent virtual environment - Updated CLAUDE.md with parallel development reference This enables multi-Claude workflow with separate development streams		2025-09-02 03:16:23 -04:00
..
agents	Initial commit: Trax media transcription platform	2025-09-02 03:05:36 -04:00
commands	Initial commit: Trax media transcription platform	2025-09-02 03:05:36 -04:00
context	Initial commit: Trax media transcription platform	2025-09-02 03:05:36 -04:00
docs	feat: Setup parallel development with Git worktrees and documentation	2025-09-02 03:16:23 -04:00
hooks	Initial commit: Trax media transcription platform	2025-09-02 03:05:36 -04:00
scripts	feat: Setup parallel development with Git worktrees and documentation	2025-09-02 03:16:23 -04:00
README.md	Initial commit: Trax media transcription platform	2025-09-02 03:05:36 -04:00
SHORTCUTS.md	Initial commit: Trax media transcription platform	2025-09-02 03:05:36 -04:00
TM_COMMANDS_GUIDE.md	Initial commit: Trax media transcription platform	2025-09-02 03:05:36 -04:00
hooks.json	Initial commit: Trax media transcription platform	2025-09-02 03:05:36 -04:00

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

Enter plan mode (Shift+Tab twice in Claude Code)
Create plan in tasks/<feature-name>.md
Break down into phases
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