flowchart TB
    subgraph getting_started [Getting Started]
        README[README.md at project root]
    end

    subgraph architecture [Architecture & Design]
        ARCH[architecture.md]
        IAD[interface_architecture_diagram.md]
    end

    subgraph api [API & Integration]
        API_SPEC[api_middleware_interface_spec.md]
        OPENAI[openai_bridge.md]
    end

    subgraph features [Features]
        INTERFACES[interfaces.md]
        UI_UX[ui_ux_implementation.md]
        MAA_ACT[maa_activation.md]
        MAA_MAP[maa_compliance_mapping.md]
        MULTI[multi_agent_acceleration.md]
    end

    README --> ARCH
    README --> API_SPEC
    README --> OPENAI
    ARCH --> IAD
    API_SPEC --> INTERFACES
    INTERFACES --> UI_UX
    MAA_ACT --> MAA_MAP

Quick Reference

Document	Description
architecture.md	Core components, data flow, AGI stack, self-improvement subsystem. Includes Mermaid diagrams.
interface_architecture_diagram.md	Full system and interface layer diagrams (ASCII + reference). Admin panel, core, multi-modal UI, end-user devices.
api_middleware_interface_spec.md	Dvādaśa HTTP/WebSocket API, SafetyPipeline, AdminControlPanel & MultiModalUI spec, Voice/Conversation layer.
openai_bridge.md	Using FusionAGI as an OpenAI-compatible model in Cursor Composer. Setup, config, auth.
interfaces.md	Admin Control Panel and Multi-Modal UI usage. Voice library, conversation tuning, modalities.
ui_ux_implementation.md	Implementation summary for admin panel and multi-modal UI. File structure, testing, next steps.
maa_activation.md	Manufacturing Authority Add-On: activation steps, MPC lifecycle, deployment.
maa_compliance_mapping.md	High-level mapping of MAA to ASME, ISO, MIL-STD, DoD Digital Thread.
multi_agent_acceleration.md	Parallel execution, agent pool, delegation, supervisor, batch/async routing.

Visual Elements

Documentation uses Mermaid diagrams where supported (GitHub, GitLab, many Markdown viewers). Key visuals:

README.md: System-at-a-glance flowchart, task lifecycle sequence.
architecture.md: Component overview, data flow (task lifecycle), self-improvement flow.
api_middleware_interface_spec.md: API → pipeline → core → interfaces flowchart.
openai_bridge.md: Request flow (Cursor → FusionAGI API → Dvādaśa → response).
multi_agent_acceleration.md: Supervisor and executor pool architecture.
maa_activation.md: MAA activation and MPC flow.
interface_architecture_diagram.md: ASCII system/interface diagrams (terminal-friendly).

For coding standards and project conventions, see .cursor/rules in the project root.