# Diagram Index

**Purpose**: Central tracking for all SOPHIAClaw diagrams to ensure consistency, version control, and discoverability.

**Last Updated**: 2026-02-24

## Status Definitions

- `📋 Planned` - Diagram identified but not yet created
- `✏️ Draft` - In progress, not yet finalized
- `✅ Active` - Current approved version
- `🔄 Pending Review` - Needs review/approval
- `📦 Archived` - Superseded by newer version

## Diagram Registry

| Diagram Name                      | Type           | Source File                                              | Owner | Last Updated | Status     |
| --------------------------------- | -------------- | -------------------------------------------------------- | ----- | ------------ | ---------- |
| High-Level System Architecture    | Architecture   | `system-architecture/high-level-system-architecture.mmd` | TBD   | 2026-02-24   | 📋 Planned |
| Gateway Communication Flow        | Sequence       | `system-architecture/gateway-communication-flow.mmd`     | TBD   | 2026-02-24   | 📋 Planned |
| Data Model Overview               | ER Diagram     | `data-model/data-model-overview.mmd`                     | TBD   | 2026-02-24   | 📋 Planned |
| Telegram Integration Flow         | Sequence       | `integrations/telegram-integration-flow.mmd`             | TBD   | 2026-02-24   | 📋 Planned |
| User Journey - First Conversation | User Flow      | `user-flows/first-conversation-journey.mmd`              | TBD   | 2026-02-24   | 📋 Planned |
| Infrastructure Deployment         | Infrastructure | `infrastructure/deployment-diagram.mmd`                  | TBD   | 2026-02-24   | 📋 Planned |

## Directory Structure

```
08-diagrams/
├── system-architecture/     # High-level system and component diagrams
├── data-model/             # Entity relationships and data flow diagrams
├── integrations/           # Third-party integration flows
├── user-flows/             # User journey and interaction diagrams
├── infrastructure/         # Deployment and infrastructure diagrams
└── archive/                # Superseded diagrams for reference
```

## Naming Conventions

- **Kebab-case**: `user-authentication-flow.mmd`
- **Mermaid files**: Use `.mmd` extension
- **Exported images**: PNG format with same base name
- **Versions**: Append `-v1`, `-v2` to filename when significant changes occur

## Maintenance Guidelines

1. **When adding new diagrams**: Add entry to this index immediately
2. **When updating diagrams**: Update the `Last Updated` field
3. **When archiving**: Move to `archive/` and mark as `📦 Archived`
4. **When completing**: Ensure diagram is `✅ Active` before referencing in docs

## Related Documentation

- SOPHIAClaw v2 Blueprint: `../00-specs/`
- API Documentation: `../06-technical-specs/`
- Architecture Decisions: `../05-architecture/`