chore(converter): sync drift across all extension formats

arckit-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "arckit-codex",
-  "version": "4.20.3",
+  "version": "4.21.0",
   "description": "Enterprise architecture governance, procurement, research, and delivery workflows for Codex.",
   "author": {
     "name": "ArcKit",

arckit-codex/agents/arckit-framework.md

@@ -248,7 +248,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `.arckit/templates/framework-overview-template.md` · `.arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `.arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `.arckit/scripts/bash/create-project.sh` · `.arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `/arckit:navigator` (project coverage) · `/arckit:traceability` (cross-reference validation) · `/arckit:strategy` (executive synthesis)

arckit-codex/agents/arckit-framework.toml

@@ -205,7 +205,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `.arckit/templates/framework-overview-template.md` · `.arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `.arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `.arckit/scripts/bash/create-project.sh` · `.arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `/arckit:navigator` (project coverage) · `/arckit:traceability` (cross-reference validation) · `/arckit:strategy` (executive synthesis)

arckit-codex/commands/arckit.framework.md

@@ -203,7 +203,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `.arckit/templates/framework-overview-template.md` · `.arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `.arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `.arckit/scripts/bash/create-project.sh` · `.arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `/arckit:navigator` (project coverage) · `/arckit:traceability` (cross-reference validation) · `/arckit:strategy` (executive synthesis)

arckit-codex/commands/arckit.uae-priorities-alignment.md

@@ -16,7 +16,7 @@ You are an enterprise architect generating a National Priorities Alignment State
 
 1. Read prerequisites:
    - `projects/000-global/ARC-000-PRIN-*.md` (federal principles, if present)
-   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CLDR, UPASS, ZBUR, DREC, DSHR) (if present)
+   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CRES, UPASS, ZBUR, DREC, DSHR) (if present)
    - `.arckit/templates/_partials/RENDERING.md`
 2. Read the template:
    - **First**, check `.arckit/templates-custom/uae-priorities-alignment-template.md` (user override)

arckit-codex/docs/guides/custom-commands.md

@@ -133,10 +133,9 @@ $ARGUMENTS
 
 ## Instructions
 
-1. **Read the template** (with user override support):
-   - **First**, check if `.arckit/templates/sla-template.md` exists in the project root
-   - **If found**: Read the user's customised template
-   - **If not found**: Read `${CLAUDE_PLUGIN_ROOT}/templates/sla-template.md` (default)
+1. **Read the template**:
+   - Read `.arckit/templates/sla-template.md` from the project root.
+   - If the file is missing, stop and ask the user to create it (custom commands ship their template alongside the command).
 
 2. **Read the project requirements**:
    - Locate `projects/<project-id>/ARC-<id>-REQ-v*.md`

arckit-codex/prompts/arckit.framework.md

@@ -203,7 +203,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `.arckit/templates/framework-overview-template.md` · `.arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `.arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `.arckit/scripts/bash/create-project.sh` · `.arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `/arckit:navigator` (project coverage) · `/arckit:traceability` (cross-reference validation) · `/arckit:strategy` (executive synthesis)

arckit-codex/prompts/arckit.uae-priorities-alignment.md

@@ -16,7 +16,7 @@ You are an enterprise architect generating a National Priorities Alignment State
 
 1. Read prerequisites:
    - `projects/000-global/ARC-000-PRIN-*.md` (federal principles, if present)
-   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CLDR, UPASS, ZBUR, DREC, DSHR) (if present)
+   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CRES, UPASS, ZBUR, DREC, DSHR) (if present)
    - `.arckit/templates/_partials/RENDERING.md`
 2. Read the template:
    - **First**, check `.arckit/templates-custom/uae-priorities-alignment-template.md` (user override)

arckit-codex/skills/architecture-workflow/SKILL.md

@@ -1,8 +1,11 @@
 ---
 name: architecture-workflow
-description: This skill should be used when the user asks how to start an architecture
-  project, which ArcKit commands to run and in what order, what workflow to follow,
-  getting started, new project setup, guide me through, or what comes next.
+description: This skill should be used when the user is starting an architecture project
+  or asking what to run next. Load whenever the task sounds like 'I'm starting a new
+  project', 'guide me through', 'what command should I run', 'what comes next', 'how
+  do I begin', 'help me get started', 'which $arckit-* in what order', 'set up a new
+  project', 'new system build', or 'where do I start'. Recommends a tailored command
+  sequence based on sector, project type, current stage, and timeline.
 ---
 
 # Architecture Workflow

arckit-codex/skills/arckit-framework/SKILL.md

@@ -204,7 +204,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `.arckit/templates/framework-overview-template.md` · `.arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `.arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `.arckit/scripts/bash/create-project.sh` · `.arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `$arckit-navigator` (project coverage) · `$arckit-traceability` (cross-reference validation) · `$arckit-strategy` (executive synthesis)

arckit-codex/skills/arckit-uae-priorities-alignment/SKILL.md

@@ -17,7 +17,7 @@ You are an enterprise architect generating a National Priorities Alignment State
 
 1. Read prerequisites:
    - `projects/000-global/ARC-000-PRIN-*.md` (federal principles, if present)
-   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CLDR, UPASS, ZBUR, DREC, DSHR) (if present)
+   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CRES, UPASS, ZBUR, DREC, DSHR) (if present)
    - `.arckit/templates/_partials/RENDERING.md`
 2. Read the template:
    - **First**, check `.arckit/templates-custom/uae-priorities-alignment-template.md` (user override)

arckit-codex/skills/mermaid-syntax/SKILL.md

@@ -9,6 +9,8 @@ description: This skill should be used when the user asks about Mermaid diagram
 
 A comprehensive reference for all 23 Mermaid diagram types plus configuration and theming. This skill provides official Mermaid syntax documentation sourced from the [mermaid-skill](https://github.com/WH-2099/mermaid-skill) project (auto-synced from upstream Mermaid docs).
 
+**This skill ships reference material, not runnable scripts.** Read the relevant reference file with `Read`, apply the syntax, and write the diagram into the user's artefact. Do not `Bash`-execute anything from `references/` — they are Mermaid syntax docs, not commands.
+
 To look up syntax for a specific diagram type, identify the type from the table below and read the corresponding reference file.
 
 ## Supported Diagram Types

arckit-codex/skills/plantuml-syntax/SKILL.md

@@ -9,6 +9,8 @@ description: This skill should be used when the user asks about PlantUML syntax
 
 A comprehensive reference for PlantUML diagram types with a focus on C4-PlantUML for architecture diagrams. This skill provides syntax documentation adapted from the [SpillwaveSolutions/plantuml](https://github.com/SpillwaveSolutions/plantuml) project, supplemented with ArcKit-specific C4 layout conflict rules and best practices.
 
+**This skill ships reference material, not runnable scripts.** Read the relevant reference file with `Read`, apply the syntax, and write the diagram into the user's artefact. Do not `Bash`-execute anything from `references/` — they are PlantUML/C4 syntax docs, not commands.
+
 ## Supported Diagram Types
 
 Select the appropriate diagram type and read the corresponding reference file:

arckit-codex/skills/wardley-mapping/SKILL.md

@@ -9,6 +9,8 @@ description: This skill should be used when the user asks about Wardley Mapping,
 
 A strategic mapping technique created by Simon Wardley for understanding competitive landscape, technology evolution, and making informed architectural decisions. A Wardley Map visualizes four dimensions: the **value chain** (components needed to meet user needs), **evolution** (how components mature over time), the **landscape** (competitive environment), and **movement** (how the landscape changes).
 
+**This skill ships reference material, not runnable scripts.** Read the relevant section here (or the linked references) with `Read`, apply the OnlineWardleyMaps syntax, and write the map into the user's artefact. Do not `Bash`-execute anything from this skill — there is no script to run.
+
 ## Map Structure
 
 The following diagram illustrates the conceptual axes of a Wardley Map. For the generation template with placeholders, see the Map Template section below.

arckit-copilot/agents/arckit-framework.agent.md

@@ -215,7 +215,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `.arckit/templates/framework-overview-template.md` · `.arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `.arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `.arckit/scripts/bash/create-project.sh` · `.arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `/arckit:navigator` (project coverage) · `/arckit:traceability` (cross-reference validation) · `/arckit:strategy` (executive synthesis)

arckit-copilot/docs/guides/custom-commands.md

@@ -133,10 +133,9 @@ $ARGUMENTS
 
 ## Instructions
 
-1. **Read the template** (with user override support):
-   - **First**, check if `.arckit/templates/sla-template.md` exists in the project root
-   - **If found**: Read the user's customised template
-   - **If not found**: Read `${CLAUDE_PLUGIN_ROOT}/templates/sla-template.md` (default)
+1. **Read the template**:
+   - Read `.arckit/templates/sla-template.md` from the project root.
+   - If the file is missing, stop and ask the user to create it (custom commands ship their template alongside the command).
 
 2. **Read the project requirements**:
    - Locate `projects/<project-id>/ARC-<id>-REQ-v*.md`

arckit-copilot/prompts/arckit-uae-priorities-alignment.prompt.md

@@ -18,7 +18,7 @@ You are an enterprise architect generating a National Priorities Alignment State
 
 1. Read prerequisites:
    - `projects/000-global/ARC-000-PRIN-*.md` (federal principles, if present)
-   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CLDR, UPASS, ZBUR, DREC, DSHR) (if present)
+   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CRES, UPASS, ZBUR, DREC, DSHR) (if present)
    - `.arckit/templates/_partials/RENDERING.md`
 2. Read the template:
    - **First**, check `.arckit/templates-custom/uae-priorities-alignment-template.md` (user override)

arckit-copilot/skills/architecture-workflow/SKILL.md

@@ -1,8 +1,11 @@
 ---
 name: architecture-workflow
-description: This skill should be used when the user asks how to start an architecture
-  project, which ArcKit commands to run and in what order, what workflow to follow,
-  getting started, new project setup, guide me through, or what comes next.
+description: This skill should be used when the user is starting an architecture project
+  or asking what to run next. Load whenever the task sounds like 'I'm starting a new
+  project', 'guide me through', 'what command should I run', 'what comes next', 'how
+  do I begin', 'help me get started', 'which /arckit:* in what order', 'set up a new
+  project', 'new system build', or 'where do I start'. Recommends a tailored command
+  sequence based on sector, project type, current stage, and timeline.
 ---
 
 # Architecture Workflow

arckit-copilot/skills/mermaid-syntax/SKILL.md

@@ -9,6 +9,8 @@ description: This skill should be used when the user asks about Mermaid diagram
 
 A comprehensive reference for all 23 Mermaid diagram types plus configuration and theming. This skill provides official Mermaid syntax documentation sourced from the [mermaid-skill](https://github.com/WH-2099/mermaid-skill) project (auto-synced from upstream Mermaid docs).
 
+**This skill ships reference material, not runnable scripts.** Read the relevant reference file with `Read`, apply the syntax, and write the diagram into the user's artefact. Do not `Bash`-execute anything from `references/` — they are Mermaid syntax docs, not commands.
+
 To look up syntax for a specific diagram type, identify the type from the table below and read the corresponding reference file.
 
 ## Supported Diagram Types

arckit-copilot/skills/plantuml-syntax/SKILL.md

@@ -9,6 +9,8 @@ description: This skill should be used when the user asks about PlantUML syntax
 
 A comprehensive reference for PlantUML diagram types with a focus on C4-PlantUML for architecture diagrams. This skill provides syntax documentation adapted from the [SpillwaveSolutions/plantuml](https://github.com/SpillwaveSolutions/plantuml) project, supplemented with ArcKit-specific C4 layout conflict rules and best practices.
 
+**This skill ships reference material, not runnable scripts.** Read the relevant reference file with `Read`, apply the syntax, and write the diagram into the user's artefact. Do not `Bash`-execute anything from `references/` — they are PlantUML/C4 syntax docs, not commands.
+
 ## Supported Diagram Types
 
 Select the appropriate diagram type and read the corresponding reference file:

arckit-copilot/skills/wardley-mapping/SKILL.md

@@ -9,6 +9,8 @@ description: This skill should be used when the user asks about Wardley Mapping,
 
 A strategic mapping technique created by Simon Wardley for understanding competitive landscape, technology evolution, and making informed architectural decisions. A Wardley Map visualizes four dimensions: the **value chain** (components needed to meet user needs), **evolution** (how components mature over time), the **landscape** (competitive environment), and **movement** (how the landscape changes).
 
+**This skill ships reference material, not runnable scripts.** Read the relevant section here (or the linked references) with `Read`, apply the OnlineWardleyMaps syntax, and write the map into the user's artefact. Do not `Bash`-execute anything from this skill — there is no script to run.
+
 ## Map Structure
 
 The following diagram illustrates the conceptual axes of a Wardley Map. For the generation template with placeholders, see the Map Template section below.

arckit-gemini/agents/arckit-framework.md

@@ -258,7 +258,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `~/.gemini/extensions/arckit/templates/framework-overview-template.md` · `~/.gemini/extensions/arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `~/.gemini/extensions/arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `~/.gemini/extensions/arckit/scripts/bash/create-project.sh` · `~/.gemini/extensions/arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `/arckit:navigator` (project coverage) · `/arckit:traceability` (cross-reference validation) · `/arckit:strategy` (executive synthesis)

arckit-gemini/commands/arckit/framework.toml

@@ -212,7 +212,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `~/.gemini/extensions/arckit/templates/framework-overview-template.md` · `~/.gemini/extensions/arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `~/.gemini/extensions/arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `~/.gemini/extensions/arckit/scripts/bash/create-project.sh` · `~/.gemini/extensions/arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `/arckit:navigator` (project coverage) · `/arckit:traceability` (cross-reference validation) · `/arckit:strategy` (executive synthesis)

arckit-opencode/agents/arckit-framework.md

@@ -248,7 +248,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `.arckit/templates/framework-overview-template.md` · `.arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `.arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `.arckit/scripts/bash/create-project.sh` · `.arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `/arckit:navigator` (project coverage) · `/arckit:traceability` (cross-reference validation) · `/arckit:strategy` (executive synthesis)

arckit-opencode/commands/arckit.framework.md

@@ -203,7 +203,7 @@ Return ONLY a concise summary to the caller including:
 
 ## Toolchain
 
-- **Templates** — `.arckit/templates/framework-overview-template.md` · `.arckit/templates/framework-executive-guide-template.md` (overrides at `.arckit/templates-custom/...`)
+- **Templates** — `.arckit/templates/framework-overview-template.md` (overrides at `.arckit/templates-custom/...`). The Executive Guide is generated narrative — no template; written from artifact synthesis.
 - **Helpers** — `.arckit/scripts/bash/create-project.sh` · `.arckit/scripts/bash/generate-document-id.sh`
 - **External tools** — none (no web, no MCP — synthesis only)
 - **Related commands** — `/arckit:navigator` (project coverage) · `/arckit:traceability` (cross-reference validation) · `/arckit:strategy` (executive synthesis)

arckit-opencode/commands/arckit.uae-priorities-alignment.md

@@ -16,7 +16,7 @@ You are an enterprise architect generating a National Priorities Alignment State
 
 1. Read prerequisites:
    - `projects/000-global/ARC-000-PRIN-*.md` (federal principles, if present)
-   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CLDR, UPASS, ZBUR, DREC, DSHR) (if present)
+   - The project's REQ, SOBC, ADR, and any prior UAE artefacts (CLAS, PDPL, IAS, CRES, UPASS, ZBUR, DREC, DSHR) (if present)
    - `.arckit/templates/_partials/RENDERING.md`
 2. Read the template:
    - **First**, check `.arckit/templates-custom/uae-priorities-alignment-template.md` (user override)