**TL;DR**: `/update-docs` - Sync documentation with current code state.

---

## Usage

```bash
/update-docs                # Sync all documentation
/update-docs --readme       # Update README only
/update-docs --api          # Update API docs only
/update-docs --check        # Report gaps without fixing
```

## What Gets Updated

### README.md
- Installation instructions
- Environment variables (from `.env.example`)
- Available commands (from `package.json` / `Justfile`)
- Project structure

### API Documentation
- Endpoint descriptions
- Request/response schemas
- Authentication requirements
- Example usage

### Docstrings
- Function signatures
- Parameter descriptions
- Return types
- Exceptions raised

### Codemaps
- Architecture diagrams
- Module relationships
- Data flow documentation

## Example Output

```markdown
Documentation Sync Report
=========================

README.md
  ✅ Installation steps current
  ⚠️  Missing env var: DATABASE_URL
  → Added to Environment Variables section

API Docs (docs/api.md)
  ✅ /users endpoints documented
  ⚠️  /auth/login missing
  → Generated from route decorator

Docstrings
  ⚠️  3 functions missing docstrings
  → Generated from type hints

Updated 4 files
```

## Integration

This command invokes the **Doc Updater Agent** which:
- Analyzes code with AST parsing
- Extracts API routes automatically
- Generates docstrings from types
- Keeps README in sync with package.json
