Command Reference Overview

Complete catalog of all 54 ArcKit commands organized by workflow category

Command Reference Overview

ArcKit provides 54 commands for enterprise architecture governance, organized into workflow-driven categories. Each command generates structured documentation aligned with UK Government standards (GDS, TCoP, NCSC).

Command Types

ArcKit supports two command invocation patterns:

CLI Commands

Direct shell commands using arckit binary

• arckit init - Initialize project structure
• arckit check - Verify installation

Slash Commands

AI assistant integration via /arckit.* prefix

• /arckit.plan - Generate project plans
• /arckit.requirements - Create requirements
• 52 additional workflow commands

Maturity Status Legend

status · string

Status	Description
🟢 Live	Production-ready, extensively tested
🔵 Beta	Feature-complete, actively refined
🟠 Alpha	Working, limited testing
🟣 Experimental	New in v0.11.x, early adopters

Example Test Repositories

All commands link to 20 public test repositories demonstrating real-world usage:

Code	Repository	Description
v1	arckit-test-project-v1-m365	Microsoft 365 GCC-H Migration
v2	arckit-test-project-v2-hmrc-chatbot	HMRC Tax Assistant Chatbot
v3	arckit-test-project-v3-windows11	Windows 11 Enterprise Deployment
v6	arckit-test-project-v6-patent-system	IPO Patent Application System
v7	arckit-test-project-v7-nhs-appointment	NHS Appointment Booking
v8	arckit-test-project-v8-ons-data-platform	ONS Data Platform Modernisation
v9	arckit-test-project-v9-cabinet-office-genai	Cabinet Office GenAI Platform
v10	arckit-test-project-v10-training-marketplace	UK Government Training Marketplace
v11	arckit-test-project-v11-national-highways-data	National Highways Data Architecture
v14	arckit-test-project-v14-scottish-courts	Scottish Courts GenAI Strategy
v16	arckit-test-project-v16-doctors-appointment	Doctors Online Appointment System
v17	arckit-test-project-v17-fuel-prices	UK Government Fuel Price Transparency Service
v18	arckit-test-project-v18-smart-meter	UK Smart Meter Data Consumer App
v19	arckit-test-project-v19-gov-api-aggregator	UK Government API Aggregator

Command Categories

Foundation

Command	Description	Status
/arckit.init	Initialize ArcKit project structure with numbered project directories and global artifacts	🟢 Live
/arckit.start	Get oriented with ArcKit — check project status, explore available commands, and choose your next step	🟢 Live
/arckit.plan	Create project plan with timeline, phases, gates, and Mermaid diagrams	🟢 Live
/arckit.principles	Create or update enterprise architecture principles	🟢 Live

Strategic Context

Command	Description	Status
/arckit.stakeholders	Analyze stakeholder drivers, goals, and measurable outcomes	🟢 Live
/arckit.risk	Create comprehensive risk register following HM Treasury Orange Book principles	🟢 Live
/arckit.sobc	Create Strategic Outline Business Case (SOBC) using UK Government Green Book 5-case model	🟢 Live

Requirements & Data

Command	Description	Status
/arckit.requirements	Create comprehensive business and technical requirements	🟢 Live
/arckit.data-model	Create comprehensive data model with entity relationships, GDPR compliance, and data governance	🟢 Live
/arckit.data-mesh-contract	Create federated data product contracts for mesh architectures with SLAs, governance, and interoperability guarantees	🟠 Alpha
/arckit.dpia	Generate Data Protection Impact Assessment (DPIA) for UK GDPR Article 35 compliance	🔵 Beta

Research & Strategy

Command	Description	Status
/arckit.platform-design	Create platform strategy using Platform Design Toolkit (8 canvases for multi-sided ecosystems)	🟣 Experimental
/arckit.research	Research technology, services, and products to meet requirements with build vs buy analysis	🔵 Beta
/arckit.wardley	Create strategic Wardley Maps for architecture decisions and build vs buy analysis	🟣 Experimental
/arckit.strategy	Synthesise strategic artifacts into executive-level Architecture Strategy document	🔵 Beta
/arckit.roadmap	Create strategic architecture roadmap with multi-year timeline, capability evolution, and governance	🔵 Beta
/arckit.adr	Document architectural decisions with options analysis and traceability	🔵 Beta

Cloud Research (MCP)

These commands use Model Context Protocol (MCP) servers to access authoritative cloud provider documentation in real-time.

Command	Description	Status
/arckit.azure-research	Research Azure services and architecture patterns using Microsoft Learn MCP	🟣 Experimental
/arckit.aws-research	Research AWS services and architecture patterns using AWS Knowledge MCP	🟣 Experimental
/arckit.gcp-research	Research Google Cloud services and architecture patterns using Google Developer Knowledge MCP	🟣 Experimental

Data Source Discovery

Command	Description	Status
/arckit.datascout	Discover external data sources (APIs, datasets, open data portals) to fulfil project requirements	🟣 Experimental

Procurement

Command	Description	Status
/arckit.sow	Generate Statement of Work (SOW) / RFP document for vendor procurement	🟢 Live
/arckit.dos	Generate Digital Outcomes and Specialists (DOS) procurement documentation for UK Digital Marketplace	🟣 Experimental
/arckit.gcloud-search	Find G-Cloud services on UK Digital Marketplace with live search and comparison	🟣 Experimental
/arckit.gcloud-clarify	Analyze G-Cloud service gaps and generate supplier clarification questions	🟣 Experimental
/arckit.evaluate	Create vendor evaluation framework and score vendor proposals	🟢 Live

Design & Architecture

Command	Description	Status
/arckit.diagram	Generate architecture diagrams using Mermaid for visual documentation	🟢 Live
/arckit.hld-review	Review High-Level Design (HLD) against architecture principles and requirements	🔵 Beta
/arckit.dld-review	Review Detailed Design (DLD) for implementation readiness	🔵 Beta

Operations

Command	Description	Status
/arckit.backlog	Generate prioritised product backlog from ArcKit artifacts - convert requirements to user stories, organise into sprints	🔵 Beta
/arckit.trello	Export product backlog to Trello - create board, lists, cards with labels and checklists from backlog JSON	🟣 Experimental
/arckit.servicenow	Create comprehensive ServiceNow service design with CMDB, SLAs, incident management, and change control	🔵 Beta
/arckit.devops	Create DevOps strategy with CI/CD pipelines, IaC, container orchestration, and developer experience	🟣 Experimental
/arckit.mlops	Create MLOps strategy with model lifecycle, training pipelines, serving, monitoring, and governance	🟣 Experimental
/arckit.finops	Create FinOps strategy with cloud cost management, optimization, governance, and forecasting	🟣 Experimental
/arckit.operationalize	Create operational readiness pack with support model, runbooks, DR/BCP, on-call, and handover documentation	🟣 Experimental
/arckit.traceability	Generate requirements traceability matrix from requirements to design to tests	🟢 Live

Quality & Governance

Command	Description	Status
/arckit.analyze	Perform comprehensive governance quality analysis across architecture artifacts	🔵 Beta
/arckit.principles-compliance	Assess compliance with architecture principles and generate scorecard with evidence, gaps, and recommendations	🟢 Live
/arckit.story	Generate comprehensive project story with timeline analysis, traceability, and governance achievements	🟢 Live
/arckit.presentation	Generate MARP slide deck from project artifacts for governance boards and stakeholder briefings	🔵 Beta
/arckit.conformance	Assess architecture conformance — ADR decision implementation, cross-decision consistency, architecture drift, technical debt, and custom constraint rules	🔵 Beta
/arckit.health	Scan projects for stale research, forgotten ADRs, unresolved review conditions, orphaned requirements, missing traceability, and version drift	🔵 Beta
/arckit.customize	Copy templates to .arckit/templates-custom/ for customization (preserved across updates)	🟢 Live
/arckit.template-builder	Create new document templates through interactive interview — generates community-origin templates, guides, and optional shareable bundles	🟠 Alpha

UK Government

Command	Description	Status
/arckit.service-assessment	Prepare for GDS Service Standard assessment - analyze evidence against 14 points, identify gaps, generate readiness report	🔵 Beta
/arckit.tcop	Generate a Technology Code of Practice (TCoP) review document for a UK Government technology project	🔵 Beta
/arckit.secure	Generate a Secure by Design assessment for UK Government projects (civilian departments)	🔵 Beta
/arckit.ai-playbook	Assess UK Government AI Playbook compliance for responsible AI deployment	🟠 Alpha
/arckit.atrs	Generate Algorithmic Transparency Recording Standard (ATRS) record for AI/algorithmic tools	🟠 Alpha

UK MOD

Command	Description	Status
/arckit.mod-secure	Generate a MOD Secure by Design assessment for UK Ministry of Defence projects using CAAT and continuous assurance	🟣 Experimental
/arckit.jsp-936	Generate MOD JSP 936 AI assurance documentation for defence AI/ML systems	🟣 Experimental

Documentation & Publishing

Command	Description	Status
/arckit.pages	Generate documentation site with Mermaid diagram support	🟠 Alpha

Getting Started

1. Install ArcKit CLI

   uv tool install arckit-cli
   
2. Initialize Project

   arckit init my-architecture-project --ai codex
   cd my-architecture-project
   
3. Start Using Commands

   Launch your AI assistant and run:

   /arckit.start
   /arckit.principles
   /arckit.requirements
   

Next Steps

Initialize Project

Set up your ArcKit project structure

Get Started

Navigate ArcKit with guided onboarding

Create a Plan

Generate project timeline with gates

Define Principles

Establish architecture governance