Skip to content

usm/gen-togaf

TOGAF ADM generator — produces phase deliverables (A through H) from USM data for TOGAF-compliant architecture documentation.

Intent

Organizations following TOGAF need phase-specific deliverables (Architecture Vision, Business Architecture, Data Architecture, etc.). The TOGAF generator maps .usm data to each ADM phase, producing markdown docs for phases A, B, C1, C2, D, E, G, and H.

Flows

Generate all TOGAF phases (gen-togaf-phases)

Produce markdown for each ADM phase

  1. parse → all .usm files
  2. generate → Phase A (Architecture Vision)
  3. generate → Phases B through H deliverables
  4. submit → write to .agents-workspace/docs/togaf/

Flow Diagrams

mermaid
sequenceDiagram
    participant User
    participant Browser
    participant Server

    User->>Browser: parse all .usm files
    User->>Browser: generate Phase A (Architecture Vision)
    User->>Browser: generate Phases B through H deliverables
    User->>Browser: submit write to .agents-workspace/docs/togaf/

Contracts

togaf-phase-coverage

Generator must produce deliverables for phases A, B, C1, C2, D, E, G, H

Acceptance criteria:

  • [ ] Each phase in its own markdown file
  • [ ] Phase A includes principles and stakeholders
  • [ ] Phase C1 includes data model from data .usm files

Tests

togaf-all-phases

Given:

  • system_with_services: true

Then:

  • assertion: 8 phase markdown files generated
  • assertion: Phase A contains architecture principles

Implementation

  • Primary: src/generators/togaf.ts
  • Test code status: none

See Also

  • usm/gen-archimate