Skip to content

v1.3.0

Choose a tag to compare

@mmaripanguec mmaripanguec released this 23 Jul 01:11
· 12 commits to main since this release
039fff8

v1.3.0 — AI-consumable architecture documentation standard

Adds the standard the factory follows to produce maximum-detail, AI-consumable application architecture documentation, synthesized from the major frameworks and consultancies and adversarially fact-checked (two deep-research passes, 25+ claims verified 3-0).

Added

  • docs/architecture-documentation-standard.md — layers arc42 + C4 + ISO/IEC/IEEE 42010 with TOGAF (traceability matrices, ADD/ARS), Zachman (W5H coverage), Rozanski & Woods (Information/Operational viewpoints + quality perspectives), DDD / Context Mapper (CML), 4+1 (Kruchten), Google Design Docs & SRE, AWS/Azure Well-Architected, and Gartner Pace-Layering — each cited. Includes a unified mapping table (framework element → arc42 section → what to deepen for AI) and the enriched ADR format.
  • The knowledge-architecture templates realize the standard:
    • Front-matter metadata: standard, viewpoints, quality_attributes, zachman_coverage.
    • New Information view (data), Integration & APIs view, TOGAF traceability matrices, Operational view (SRE).
    • Enriched §9 ADRs (Nygard + Google: goals/non-goals, alternatives considered, confidence; append-only, immutable).
    • Annex D · traceability matrix (requirement ↔ ADR ↔ building block ↔ file:line ↔ assertion).
    • The generator needs no change — the new curated sections are narrative-driven.

Changed

  • CLAUDE.md, README and the <prefix>-architecture skill point at the standard; test-architecture.sh covers the new sections (147 asserts total).

Coverage note

ArchiMate and BCG/Accenture/McKinsey thought leadership were targeted but not verifiable (primary sources behind login/paywall); documented as gaps, not omissions.

Full changelog: https://github.com/mmaripanguec/dev-sdd-kit/blob/main/CHANGELOG.md