**TL;DR**: `/update-codemaps` - Generate architecture documentation from code analysis.

---

## Usage

```bash
/update-codemaps            # Generate all codemaps
/update-codemaps --overview # High-level overview only
/update-codemaps --modules  # Module documentation
```

## What Gets Generated

### docs/codemaps/overview.md
High-level architecture:
```markdown
# Project Architecture

## Component Diagram
```mermaid
graph TB
    API[API Layer] --> Services
    Services --> Repository
    Repository --> Database
```

## Directory Structure
src/
├── api/        # REST endpoints
├── services/   # Business logic
├── models/     # Data models
└── utils/      # Shared utilities
```

### docs/codemaps/api.md
API endpoint documentation:
```markdown
# API Endpoints

## Authentication
| Method | Path | Description |
|--------|------|-------------|
| POST | /auth/login | User login |
| POST | /auth/register | User registration |
```

### docs/codemaps/models.md
Data model documentation:
```markdown
# Data Models

## User
| Field | Type | Description |
|-------|------|-------------|
| id | UUID | Primary key |
| email | str | Unique email |
| created_at | datetime | Creation timestamp |
```

## Output Location

```
docs/
└── codemaps/
    ├── overview.md     # High-level architecture
    ├── api.md          # API documentation
    ├── models.md       # Data models
    └── services.md     # Business logic
```

## Integration

This command invokes the **Doc Updater Agent** which:
- Analyzes code structure with AST
- Extracts endpoint definitions
- Maps model relationships
- Generates mermaid diagrams
