Repository navigation
v1.3.0
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.
- Front-matter metadata:
Changed
CLAUDE.md, README and the<prefix>-architectureskill point at the standard;test-architecture.shcovers 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