ArcKit Enterprise Architecture Toolkit - Codex CLI

Installation

Install the CLI

pip install git+https://github.com/tractorjuice/arc-kit.git

Command Skill Examples

The examples below cover the most common workflows. The generated skills/arckit-*/ directories are the source of truth for the full command set.

Foundation and Governance

$arckit-plan           # Project plan with GDS Agile Delivery phases
$arckit-principles     # Architecture principles
$arckit-stakeholders   # Stakeholder analysis with Power-Interest Grid
$arckit-risk           # Risk register (HM Treasury Orange Book)
$arckit-sobc           # Strategic Outline Business Case (Green Book 5-case)
$arckit-strategy       # Architecture strategy
$arckit-start          # Guided project onboarding
$arckit-init           # Initialize project structure

Requirements and Data

$arckit-requirements       # Business, functional, non-functional requirements
$arckit-data-model         # Data model with ERD and GDPR compliance
$arckit-data-mesh-contract # Federated data product contract (ODCS v3.0.2)
$arckit-dpia               # Data Protection Impact Assessment
$arckit-platform-design    # Platform Design Toolkit (8 PDT canvases)
$arckit-glossary           # Domain glossary

Research and Procurement

$arckit-research        # Market research with build vs buy analysis
$arckit-datascout       # External data source discovery
$arckit-aws-research    # AWS service research via MCP
$arckit-azure-research  # Azure service research via MCP
$arckit-gcp-research    # Google Cloud research via MCP
$arckit-wardley         # Wardley mapping
$arckit-roadmap         # Multi-year strategic roadmap
$arckit-evaluate        # Vendor scoring against requirements
$arckit-sow             # RFP statement of work
$arckit-gcloud-search   # G-Cloud framework search
$arckit-gcloud-clarify  # Supplier clarification questions
$arckit-dos             # Digital Outcomes and Specialists procurement
$arckit-finops          # Cloud financial operations

Delivery and Quality

$arckit-adr             # Architecture Decision Records (MADR format)
$arckit-diagram         # C4 architecture diagrams
$arckit-dfd             # Data flow diagrams
$arckit-backlog         # Sprint-ready GDS backlog from requirements
$arckit-hld-review      # High-level design review
$arckit-dld-review      # Detailed design review
$arckit-analyze         # Cross-artifact quality analysis
$arckit-traceability    # Traceability matrix
$arckit-devops          # DevOps pipeline design
$arckit-mlops           # MLOps pipeline design
$arckit-operationalize  # Operational readiness
$arckit-servicenow      # ServiceNow CMDB export
$arckit-trello          # Trello board export
$arckit-framework       # Structured framework generation
$arckit-health          # Architecture health check
$arckit-presentation    # Executive presentation
$arckit-pages           # Documentation site generation
$arckit-template-builder # Custom template creation
$arckit-maturity-model  # Architecture maturity assessment

Compliance and Governance Reporting

$arckit-principles-compliance  # Principles compliance (RAG evidence)
$arckit-conformance            # Architecture conformance review
$arckit-service-assessment     # GDS Service Standard assessment
$arckit-secure                 # Secure by Design review
$arckit-mod-secure             # MOD Secure by Design assessment
$arckit-jsp-936                # JSP 936 AI assurance documentation
$arckit-tcop                   # Technology Code of Practice compliance
$arckit-atrs                   # Algorithmic Transparency Record
$arckit-ai-playbook            # UK Government AI Playbook alignment
$arckit-story                  # Programme story for governance reporting
$arckit-customize              # Template customization

Option 1: CLI (Recommended)

The ArcKit CLI scaffolds a complete project with skills, agents, and MCP config in one step:

```bash

Option 2: Codex Plugin Bundle

Install ArcKit as a Codex plugin from the standalone marketplace repository:

codex plugin marketplace add tractorjuice/arckit-codex

Enable Codex lifecycle hooks in your user or project config:

[features]
hooks = true
plugin_hooks = true

Restart Codex, open the plugin directory, choose ArcKit Plugins, then install and enable ArcKit. The plugin manifest points to bundled skills, MCP server config, and hooks/hooks.json.

Option 3: Standalone Extension (manual)

This repo can also be used as a standalone extension installed once and shared across projects.

Step 1: Skills (commands)

Copy the skills/ directory into your project or home directory:

```bash

If you don't have a project config yet, copy directly

mkdir -p .codex cp /path/to/arckit-codex/config.toml .codex/config.toml

If you already have a config, manually merge the [mcp_servers], [agents], and [hooks] sections

Copy the agent prompt files referenced by `config.toml`:

**Step 3: Lifecycle Hooks**

Copy the Codex hook runner referenced by `config.toml`:

The hook wiring in `config.toml` enables:

- `SessionStart` context injection for ArcKit projects and recent session memory
- `UserPromptSubmit` secret detection and ArcKit context injection when `$arckit-*` skills are invoked
- `UserPromptSubmit` artifact graph context for `$arckit-health`, `$arckit-traceability`, `$arckit-analyze`, `$arckit-search`, `$arckit-impact`, `$arckit-navigator`, and `$arckit-graph-report`
- `PreToolUse` guardrails for `apply_patch`, `Edit`, `Write`, and simple `Bash` writes to credential files
- `PreToolUse` ARC artifact filename enforcement and `vendors/scores.json` validation
- `PostToolUse` provenance stamping and `docs/manifest.json` maintenance for changed project artifacts
- `PermissionRequest` auto-approval for ArcKit knowledge MCP servers
- `Stop` session memory capture in `.arckit/memory/sessions.md`

For deterministic research workflows, also copy the bundled schemas and validator:

MCP servers require no API keys except for Google Developer Knowledge (GOOGLE_API_KEY) and Data Commons (DATA_COMMONS_API_KEY). AWS Knowledge and Microsoft Learn work without authentication.

ArcKit Codex CLI Extension

<p align="center"> <img src="../docs/assets/ArcKit_Logo_Horizontal_Dark.svg" alt="ArcKit" height="32"> </p>

Standalone OpenAI Codex CLI extension for ArcKit -- Enterprise Architecture Governance & Vendor Procurement Toolkit.

Auto-generated: Files in this directory are generated from plugin commands by python scripts/converter.py. Do not edit them directly -- edit the source in arckit-claude/commands/ and re-run the converter.

Reference Skills

Differences from Claude Code