Files
2026-07-13 12:35:03 +08:00

2.4 KiB

TOGAF Gap Analysis Playbook

Guide Origin: Community | ArcKit Version: [VERSION]

/arckit:gap-analysis compares current and target architecture states, scores gaps, maps them to workstreams, and prepares the evidence base for TOGAF ADM Phase E and migration planning.


Inputs

Artefact Purpose
Business capability map (ARC-<id>-BPCM-v1.0.md) Mandatory baseline for capability gaps
Architecture principles (ARC-000-PRIN-v1.0.md) Compliance and principle-alignment checks
Architecture strategy (ARC-<id>-STRAT-v1.0.md) Target state and investment priorities
Application inventory (ARC-<id>-APP-v1.0.md) Current application coverage
Application rationalisation (ARC-<id>-APPR-v1.0.md) Target portfolio decisions
Existing assessments or migration plans Evidence for baseline and target states

Command

/arckit:gap-analysis <project ID or gap-analysis scope>

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


Deliverable Snapshot

Section Contents
Capability Gap Matrix Current state, target state, gap, severity
Gap Heatmap Priority view by impact and urgency
Workstream Mapping Gaps grouped into delivery workstreams
Gap-to-Risk Mapping Relationship between gaps and project or enterprise risks
Assumptions and Constraints Evidence gaps and known limits
Traceability Capability, principle, strategy, application, and risk links

Severity Guidance

Severity Meaning
Critical Blocks target outcomes or creates unacceptable risk
High Materially weakens a priority capability or compliance position
Medium Requires planned remediation but does not block delivery
Low Improvement opportunity or documentation gap

Review Checklist

  • Gaps are stated as differences between current and target states.
  • Severity ratings include rationale and evidence.
  • Every high or critical gap has an owner or proposed workstream.
  • Gap-to-risk mapping includes existing risk identifiers where available.
  • Assumptions are visible rather than hidden in the analysis.

  • /arckit:transition-architecture - Turn gaps into migration waves.
  • /arckit:architecture-board - Present prioritised gaps for governance.
  • /arckit:architecture-change - Reassess gaps after approved changes.