Back to Guides

A short AI-narrated film with English captions. Pressing play loads the YouTube player. Watch on YouTube

Guide Origin: Community | ArcKit Version: [VERSION]

/arckit:architecture-repository creates a reusable architecture knowledge store. It synthesises principles, ADRs, diagrams, lessons, standards, patterns, reference architectures, and building blocks across projects.

Inputs

Artefact Purpose
Global architecture principles (ARC-000-PRIN-v1.0.md) Mandatory standards and decision foundation
ADRs (ARC-<id>-ADR-*.md) Decisions, alternatives, consequences, reusable patterns
Diagrams (ARC-<id>-DIAG-*.md) Reference architecture and integration patterns
Project stories (ARC-<id>-STORY-v1.0.md) Lessons learned and delivery outcomes
Analysis reports (ARC-<id>-ANAL-v1.0.md) Findings and reusable technical observations
TOGAF artefacts (BPCM, GAPA, TRANS, APP, BORD, ACHG) Capability, gap, transition, portfolio, and governance knowledge

Command

/arckit:architecture-repository <optional project ID or global scope>

Output: projects/<id>/ARC-<id>-REPO-v1.0.md

For an enterprise-wide repository, use project 000 or the repository's chosen global project convention.

Deliverable Snapshot

Section Contents
Standards Register Principles, approved standards, governance rules
Patterns Library Reusable architecture, integration, data, and governance patterns
Reference Architectures Canonical diagrams and implementation shapes
Lessons Learned What worked, failed, or should change next time
Reusable Building Blocks Components, services, templates, and reusable decisions
Search Index Keywords, tags, source artefacts, and retrieval notes
Traceability Source documents and repository entries

Review Checklist

  • Repository entries come from real artefacts, not aspirational descriptions.
  • Each pattern has applicability, constraints, and source evidence.
  • Standards distinguish mandatory controls from recommendations.
  • Lessons learned include context, not only conclusions.
  • Search tags are useful for future /arckit:research, /arckit:search, or board work.
  • /arckit:adm-preliminary - Reuse repository standards in new ADM cycles.
  • /arckit:adr - Feed decisions into the repository.
  • /arckit:search - Find reusable knowledge across project artefacts.