# Full documentation check/update
/codebase-quality docs

# Specific operations
/codebase-quality docs update <module>
/codebase-quality docs status <feature>
/codebase-quality docs validate
/codebase-quality docs sync-claude-md

# After code quality passes
Skill("codebase-quality:documentation")

# Specific sub-functions
Skill("codebase-quality:documentation:update")
Skill("codebase-quality:documentation:status")
Skill("codebase-quality:documentation:validate")

Feature Complete (bd close)
    ↓
1. Scan git diff for changed files
   git diff HEAD~5 --name-only
    ↓
2. Identify affected documentation:
   - Module CLAUDE.md (if patterns changed)
   - codebase_documentation/ (if architecture changed)
   - solution_designs/ (mark as implemented)
   - INDEX.md (if new docs created)
    ↓
3. Generate suggested updates
    ↓
4. Apply updates or present for review
    ↓
5. Commit with "docs(module): Update for <bd-id>"

## Key Patterns (BEFORE)
- React Server Components for data fetching
- Tailwind CSS for styling

## Key Patterns (AFTER)
- React Server Components for data fetching
- Tailwind CSS for styling
- Custom hooks in `hooks/` for shared state ← NEW

draft → approved → implementing → implemented → staged → rolled-out
  │                                                           │
  └──────────────── deprecated ◄──────────────────────────────┘

---
title: Room Instantiation Parameterization
type: solution_design
status: implemented
created_at: 2025-12-01
implemented_at: 2025-12-15
deployed_at: null
deployed_in: null
last_updated: 2025-12-19
related_beads: [bd-a1b2, bd-c3d4]
owners:
  - orchestrator
  - backend-solutions-engineer
---

my-project/CLAUDE.md (root)
    ├── my-project-backend/CLAUDE.md
    │       ├── eddy_validate/CLAUDE.md
    │       └── user_chat/CLAUDE.md
    ├── my-project-frontend/CLAUDE.md
    └── my-project-communication/CLAUDE.md

# [Module Name] - CLAUDE.md

> Inherits from: [CLAUDE.md](../../../CLAUDE.md)

## Module Overview
[Brief description]

## Key Patterns
[Framework-specific patterns]

## Directory Structure
[Key directories]

## Critical Files
[Important files to understand]

## Testing Strategy
[How to test this module]

## Dependencies
[Key dependencies]

## Recent Changes
[Changelog]

# Documentation Report - 2025-12-19

## Summary
- **Files Updated**: 3
- **Status Changes**: 2
- **Validation Issues**: 1

## Updates Applied

### CLAUDE.md Updates

**my-project-frontend/CLAUDE.md**:
```diff
+ - Custom hooks in `hooks/` for shared state
+ - Beads integration for task management

## Integration with Beads

### On bd close

```bash
bd close bd-a1b2 --reason "Validated"
    ↓
codebase-quality:documentation triggered
    ↓
1. Find related solution_design by bead ID
2. Update status to "implemented"
3. Set implemented_at timestamp
4. Update module CLAUDE.md if patterns changed
5. Commit doc changes

{
  "mappings": [
    { "task_id": "1", "bead_id": "bd-a1b2", "solution_design": "room-instantiation.md" }
  ]
}

Orchestrator: Feature validated, bd close
    ↓
Skill("codebase-quality:documentation")
    ↓
1. Scan changed files
2. Update relevant docs
3. Update status metadata
4. Commit with feature

/codebase-quality pre-merge
    ↓
documentation check:
- CLAUDE.md stale → Warn
- Status outdated → Warn
- Missing docs → Warn
- (never blocks - documentation is advisory)

# Full audit order
Skill("codebase-quality:security")       # 1. Security first
Skill("codebase-quality:code-quality")   # 2. Code quality
Skill("codebase-quality:documentation")  # 3. Documentation last