fix(arckit-togaf-adm): put the capability map in Phase B, register ACHG as multi-instance, use TOGAF's change classes (#949)

.arckit/templates/architecture-board-template.md

@@ -177,7 +177,7 @@ All decisions must be recorded in the Decision Register with:
 | Architecture Principles | `ARC-000-PRIN-v[N].md` | Board enforces principles compliance |
 | ADM Plan | `ARC-[P]-ADMP-v[N].md` | Board governs Phase G implementation |
 | Gap Analysis | `ARC-[P]-GAPA-v[N].md` | Board prioritises gap closure |
-| Architecture Change Requests | `ARC-[P]-ACHG-v[N].md` | Board approves/denies changes |
+| Architecture Change Requests | `changes/ARC-[P]-ACHG-[NNN]-v[N].md` | Board approves/denies changes |
 
 ## 9. External References
 

.arckit/templates/architecture-change-template.md

@@ -16,7 +16,7 @@ templateVersion: "1.0"
 | Field | Value |
 |-------|-------|
 | **Change ID** | `ACHG-[ACHG_NUM]` |
-| **Change Type** | `[EVOLUTIONARY / TRANSFORMATIONAL / CORRECTIVE]` |
+| **Change Type** | `[SIMPLIFICATION / INCREMENTAL / RE-ARCHITECTING]` |
 | **Priority** | `[CRITICAL / HIGH / MEDIUM / LOW]` |
 
 ### Revision History
@@ -32,7 +32,7 @@ templateVersion: "1.0"
 | Field | Value |
 |-------|-------|
 | Change ID | `ACHG-[ACHG_NUM]` |
-| Change Type | `[EVOLUTIONARY / TRANSFORMATIONAL / CORRECTIVE]` |
+| Change Type | `[SIMPLIFICATION / INCREMENTAL / RE-ARCHITECTING]` |
 | Submitted By | `[NAME]` |
 | Date | `[YYYY-MM-DD]` |
 | Priority | `[CRITICAL / HIGH / MEDIUM / LOW]` |

README.md

@@ -626,7 +626,7 @@ Enterprise Architecture Development Method — 9 commands covering the full ADM
 | Command | Doc Type | Phase | Description |
 |---------|----------|-------|-------------|
 | `/arckit:adm-preliminary` | ADMP | Preliminary | Architecture vision, scope, drivers, constraints |
-| `/arckit:business-capability-map` | BPCM | Phase A | Business capability hierarchy, value streams, maturity |
+| `/arckit:business-capability-map` | BPCM | Phase B | Business capability hierarchy, value streams, maturity |
 | `/arckit:application-inventory` | APP | Phase C | Application catalog with strategic fit scoring |
 | `/arckit:application-rationalization` | APPR | Phase C | Keep/merge/replace/retire decisions |
 | `/arckit:gap-analysis` | GAPA | Phase E | Capability gap matrix, workstream mapping |

docs/commands.html

@@ -2583,7 +2583,7 @@ <h2 class="govuk-heading-l">ArcKit AI Commands</h2>
                     </tr>
                     <tr data-status="experimental" data-category="togaf-adm-overlay" data-jurisdiction="togaf-adm" data-tier="community">
                         <td><code>/arckit:business-capability-map</code><br><a href="https://youtu.be/HTEBO2L3PCg" class="govuk-link app-film-link" target="_blank" rel="noopener" aria-label="Watch the film for /arckit:business-capability-map on YouTube (opens in a new tab)">&#9654; Film</a></td>
-                        <td class="description">[COMMUNITY] TOGAF Phase A business architecture: capability hierarchy, value chains, maturity, ownership, and strategic alignment.</td>
+                        <td class="description">[COMMUNITY] TOGAF Phase B business architecture: capability hierarchy, value streams, maturity, ownership, and strategic alignment.</td>
                         <td>TOGAF ADM Overlay</td>
                         <td>TOGAF ADM</td>
                         <td>Community</td>

docs/guides/application-inventory.md

@@ -2,7 +2,7 @@
 
 > **Guide Origin**: Community | **ArcKit Version**: [VERSION]
 
-`/arckit:application-inventory` creates a portfolio catalogue of existing applications, including lifecycle state, ownership, technology stack, dependencies, strategic fit, and capability support. It is the foundation for application rationalisation and Phase C application architecture decisions.
+`/arckit:application-inventory` creates a portfolio catalogue of existing applications, including lifecycle state, ownership, technology stack, dependencies, strategic fit, and capability support. It is the foundation for application rationalisation and for TOGAF Phase C (Information Systems Architectures — Application Architecture) decisions.
 
 ---
 

docs/guides/architecture-change.md

@@ -15,6 +15,7 @@
 | ADM preliminary (`ARC-<id>-ADMP-v1.0.md`) | ADM scope and architecture framework |
 | Global principles (`ARC-000-PRIN-v1.0.md`) | Principle compliance implications |
 | Transition architecture (`ARC-<id>-TRANS-v1.0.md`) | Current migration plan impact |
+| Application inventory (`ARC-<id>-APP-v1.0.md`) | Optional application baseline for the application impact |
 | Existing change documents or board minutes | Change history and prior decisions |
 
 ---
@@ -35,7 +36,7 @@ Output: `projects/<id>/changes/ARC-<id>-ACHG-001-v1.0.md`
 |---------|----------|
 | Change Request | Requested change, type, urgency, requester |
 | Rationale | Why the change is needed now |
-| Impact Assessment | Business, application, technology, data, security, delivery impact |
+| Impact Assessment | Capability, application, technology and governance impact |
 | Affected Artefacts | Documents and decisions that must change |
 | ADM Re-Entry Point | Recommended ADM phase to revisit |
 | Cost and Benefit | Expected cost, value, trade-offs |
@@ -47,20 +48,23 @@ Output: `projects/<id>/changes/ARC-<id>-ACHG-001-v1.0.md`
 
 ## Change Types
 
-| Type | Use When |
-|------|----------|
-| Evolutionary | Adjusts an existing architecture within approved direction |
-| Corrective | Fixes a defect, compliance gap, or failed assumption |
-| Transformational | Changes target state, scope, or strategic direction |
-| Emergency | Requires accelerated governance due to urgent risk or delivery pressure |
+The command uses the three classes TOGAF Phase H (Architecture Change Management) defines.
+
+| Type | Use When | Usual handling |
+|------|----------|----------------|
+| Simplification | Reduces or rationalises the architecture, often to cut investment | Change management within Phase H |
+| Incremental | Derives more value from the existing architecture | Change management, or partial re-architecting of the phases it touches |
+| Re-architecting | Creates new value through structural change to the target state, scope or direction | A new ADM cycle, usually from Phase A |
+
+An urgent or corrective change is not a separate type. Classify it by its scope and set its priority to Critical or High.
 
 ---
 
 ## Review Checklist
 
 - The requested change is specific and actionable.
-- Impacts are assessed across capability, application, technology, data, security, and delivery.
-- ADM re-entry point is justified.
+- Impacts are assessed across capability, application, technology, and governance.
+- ADM re-entry point is justified and consistent with the change type.
 - Affected artefacts are listed with update actions.
 - Approval workflow names the accountable decision forum or owner.
 

docs/guides/business-capability-map.md

@@ -2,7 +2,7 @@
 
 > **Guide Origin**: Community | **ArcKit Version**: [VERSION]
 
-`/arckit:business-capability-map` creates the business architecture baseline for TOGAF ADM Phase A. It maps capability hierarchy, value streams, capability maturity, heatmaps, and requirement or principle traceability.
+`/arckit:business-capability-map` creates the business architecture baseline for TOGAF ADM Phase B (Business Architecture), detailing the capabilities and value streams the Phase A Architecture Vision sketches at a high level. It maps capability hierarchy, value streams, capability maturity, heatmaps, and requirement or principle traceability.
 
 ---
 

plugins/arckit-agent-architecture/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-at/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-au-energy/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-au/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-ca/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-claude/config/doc-types.mjs

@@ -361,6 +361,10 @@ export const MULTI_INSTANCE_TYPES = new Set([
   'WGAM', 'WCLM', 'WVCH',
   'GOVR', 'GCSR', 'GLND', 'GRNT',
   'CDAU',
+  // arckit-togaf-adm: /arckit:architecture-change numbers each TOGAF Phase H
+  // change request (ARC-001-ACHG-001-v1.0.md in changes/). Missing from both
+  // lists, the hook read ACHG-001 as the doc-type and blocked every write (#949).
+  'ACHG',
 ]);
 
 // Type code -> required subdirectory
@@ -389,6 +393,7 @@ export const SUBDIR_MAP = {
   'GRNT': 'research',
   'CDAU': 'audits',
   'FWRK': 'framework',
+  'ACHG': 'changes',
 };
 
 // Derived: set of all valid type codes

plugins/arckit-claude/plugins/agent/architecture/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-claude/plugins/at/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-claude/plugins/au/energy/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-claude/plugins/au/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-claude/plugins/ca/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority
 

plugins/arckit-claude/plugins/eu/references/quality-checklist.md

@@ -842,12 +842,12 @@ All artifacts must pass these 10 checks:
 
 ### ACHG -- Architecture Change Request
 
-- Change classified as EVOLUTIONARY, TRANSFORMATIONAL or CORRECTIVE with justification
+- Change classified as SIMPLIFICATION, INCREMENTAL or RE-ARCHITECTING (the TOGAF Phase H classification) with justification
 - Priority set (CRITICAL / HIGH / MEDIUM / LOW) and consistent with the impact assessment
 - Impact assessed across all four dimensions: capability, application, technology, governance
 - Affected artefacts listed by document ID, each with the action required
 - ADM re-entry point determined per phase (A–H) with the scope of re-entry, not just YES/NO
-- Re-entry point consistent with the change type — transformational changes re-enter at Phase A or B
+- Re-entry point consistent with the change type — a re-architecting change starts a new ADM cycle (usually at Phase A); a simplification change stays within Phase H
 - Cost and benefit both quantified
 - Approval workflow names the approving authority for the assessed priority