Update Project Documentation

Files to update:

• .claude/CLAUDE.md - Main architecture and reference (stable)
• .claude/DECISIONS.md - Architectural decisions with rationale
• .claude/SESSION.md - Current work in progress

1. Analyze Current State

Gather information about the codebase:

# Get current branch and recent commits
git log --oneline -10
git status

# Find source structure
find src -name "*.py" -type f 2>/dev/null | head -20
find src -name "*.ts" -type f 2>/dev/null | head -20

# Check for config files
ls -la *.toml *.json *.yaml *.yml 2>/dev/null

2. Key Areas to Update in CLAUDE.md

Module Changes

• Scan src/ for new or removed modules
• Check for new interfaces or base classes
• Look for new provider implementations

Configuration Changes

• Review config files for new settings
• Check for new environment variables
• Update example values if changed

API Changes

• Scan for new endpoints (FastAPI decorators, Express routes, etc.)
• Check for changed request/response formats

Docker/Infrastructure Changes

• Review docker-compose files for new services
• Check Dockerfile for build changes
• Update port mappings

Dependency Changes

• Check pyproject.toml / package.json for new dependencies
• Note any major version upgrades

3. Update DECISIONS.md

If significant architectural decisions were made:

• Add new decision with context and trade-offs
• Move superseded decisions to that section
• Add items to "Questions to Revisit" if needed

4. Update SESSION.md

• Move completed items to "Recently Completed"
• Add new in-progress items
• Update "Where We Left Off"
• Clear scratch notes

5. Validation

After updating, verify:

• All referenced files exist
• Port numbers match config
• Provider/module names match code
• Commands are runnable