arckit-agent-architecture

ArcKit Plugin for Claude Code

The Enterprise Architecture Governance Harness — a Claude Code plugin providing 75 slash commands across strategy, architecture, delivery, assurance, and interoperability.

Installation

Step 0: Make sure Claude Code is up to date

ArcKit needs Claude Code v2.1.200 or later (see Prerequisites below). The simplest way to land on a supported version — even if you've never installed Claude Code before — is:

claude install latest

If you don't yet have the claude CLI on your PATH, follow the official Claude Code install guide first, then run claude install latest. To check what you're on:

claude --version

Step 1: Add the marketplace

In Claude Code, run:

/plugin marketplace add tractorjuice/arckit-claude

Step 2: Install the plugin

/plugin

Go to the Discover tab, find arckit, and install it. Or via CLI:

claude plugin install arckit@arckit-claude

Installing with ArcKit overlay plugins

The same marketplace hosts the core plugin plus regional, sector, and tooling overlays. Install only the plugins you need:

claude plugin install arckit arckit-uae
claude plugin install arckit arckit-au arckit-au-energy
claude plugin install arckit arckit-uk-finance

The arckit-uk-gcloud overlay is public for installation and inspection, but remains proprietary and is not MIT licensed.

Alternative: Load for a single session

claude --plugin-dir /path/to/arckit-claude

Prerequisites

• Claude Code v2.1.200 or later (recommended minimum)
• Bash shell (for helper scripts)
• For /arckit:aws-research: AWS Knowledge MCP server (included)
• For /arckit:azure-research: Microsoft Learn MCP server (included)
• For /arckit:gcp-research: Google Developer Knowledge MCP (requires GOOGLE_API_KEY — see MCP Servers)

Why v2.1.200? v2.1.200 fixes project-scoped plugin loading from git worktrees and claude agents --plugin-dir <dir> visibility for plugin agents/skills, which makes ArcKit branch and test-repo workflows reliable. It also carries the v2.1.198-v2.1.199 background-subagent reliability, parent error-propagation, and hook stderr-visibility fixes that matter to /arckit:build, reader/writer handoffs, and hook diagnosis. v2.1.197 makes Claude Sonnet 5 the default Claude Code model with native 1M context, while v2.1.172 fixed wildcard-domain WebFetch permission rules (WebFetch(domain:*.gov.uk)) that never matched subdomains on earlier clients. The floor also carries forward the older MCP alwaysLoad, provenance hook, release validation, telemetry, /context, Auto mode, plugin update, MCP leak, retry, and subagent working-directory fixes ArcKit relies on.

Quick Start

After installing the plugin:

1. Initialize a project (optional - commands will create structure automatically):

   /arckit:init
   

2. Create architecture principles:

   /arckit:principles
   

3. Create requirements for a project:

   /arckit:requirements NHS appointment booking system
   

What's Included

Component	Count	Description
Commands	75	Slash commands for architecture artifacts and OKF interoperability
Skills	1	Conversational Wardley Mapping with interactive guidance
Agents	20	Autonomous research agents and subagent definitions
Templates	68	Document templates with UK Government compliance
Scripts	15	Helper bash, Python, and Node scripts
Hooks	17	Automation hooks across 7 event types
Guides	167	Command and reference documentation

Hooks

Automation hooks run automatically to provide context and enforce standards. See the Hooks Guide for full details.

Event	Hooks	Purpose
SessionStart	arckit-session, version-check	Inject version/context, check for updates
Stop / StopFailure	session-learner	Record session activity for future context
UserPromptSubmit	arckit-context, secret-detection, + 6 command-specific	Project context, secret scanning, pre-processing
PreToolUse	validate-arc-filename, score-validator, file-protection, secret-file-scanner	Filename enforcement, security, validation
PostToolUse	update-manifest	Keep manifest.json in sync
PermissionRequest	allow-mcp-tools	Auto-allow bundled MCP servers

OKF Interoperability

• /arckit:export-okf exports ArcKit ARC-*.md artifacts as copied Markdown with OKF-compatible frontmatter.
• /arckit:import-okf scans OKF Markdown bundles, writes .arckit/tmp/okf-import-report.json, and materializes safe imports as RSCH review notes.
• Source ARC frontmatter stamping is opt-in via ARCKIT_OKF_FRONTMATTER=1 or .arckit/config.json with { "okfFrontmatter": true }.