{
  "markdown": "# ArcKit - Gemini CLI Extension\n\n**The Enterprise Architecture Governance Harness for Gemini CLI**\n\nArcKit provides 75 slash commands across strategy, architecture, delivery, assurance, and interoperability — including UK Government compliance — all from within Gemini CLI.\n\n## Installation\n\n```bash\ngemini extensions install https://github.com/tractorjuice/arckit-gemini\n```\n\n### Prerequisites\n\n- **[Gemini CLI](https://github.com/google-gemini/gemini-cli)**: `npm install -g @google/gemini-cli@latest`\n- **Node.js**: Required for MCP server bridges (AWS Knowledge, Microsoft Learn)\n\n### Optional: Google Cloud Research\n\nTo use `/arckit:gcp-research`, configure your Google API key:\n\n```bash\n# Set via Gemini CLI settings, or export directly:\nexport GOOGLE_API_KEY=\"your-api-key\"\n```\n\nGet a key at https://makersuite.google.com/app/apikey\n\n## Quick Start\n\n```bash\n# Start Gemini CLI in your project\ncd /path/to/your/project\ngemini\n\n# Create a project plan\n/arckit:plan Create project plan for cloud migration with 6-month timeline\n\n# Establish governance\n/arckit:principles Create cloud-first architecture principles\n\n# Analyze stakeholders\n/arckit:stakeholders Analyze stakeholders for payment gateway where CFO wants cost savings\n\n# Define requirements\n/arckit:requirements Create requirements for cloud migration project\n\n# Research cloud platforms\n/arckit:aws-research Evaluate AWS services for serverless architecture\n/arckit:azure-research Evaluate Azure services for enterprise integration\n/arckit:gcp-research Evaluate GCP services for data analytics platform\n```\n\n## Core Commands\n\n### Phase 0: Project Planning\n\n| Command | Description |\n|---------|-------------|\n| `/arckit:init` | Initialize ArcKit project structure |\n| `/arckit:plan` | Project plan with GDS Agile Delivery phases and Mermaid Gantt charts |\n| `/arckit:start` | Guided project onboarding, workflow selection, and command recommendations |\n| `/arckit:strategy` | Enterprise architecture strategy document |\n\n### Phase 1: Discovery\n\n| Command | Description |\n|---------|-------------|\n| `/arckit:principles` | Architecture principles (global, cross-project) |\n| `/arckit:stakeholders` | Stakeholder analysis with drivers, goals, RACI |\n| `/arckit:risk` | Risk register (HM Treasury Orange Book) |\n| `/arckit:sobc` | Strategic Outline Business Case (HM Treasury Green Book) |\n\n### Phase 2: Alpha\n\n| Command | Description |\n|---------|-------------|\n| `/arckit:requirements` | Comprehensive requirements (BR/FR/NFR/INT/DR) |\n| `/arckit:data-model` | Data model with ERD, GDPR compliance |\n| `/arckit:data-mesh-contract` | Federated data product contract (ODCS v3.0.2) |\n| `/arckit:dpia` | Data Protection Impact Assessment (GDPR Article 35) |\n| `/arckit:platform-design` | Platform strategy using Platform Design Toolkit |\n| `/arckit:wardley` | Wardley Map with strategic analysis |\n| `/arckit:roadmap` | Multi-year strategic architecture roadmap |\n| `/arckit:adr` | Architecture Decision Record (MADR format) |\n| `/arckit:dfd` | Yourdon-DeMarco Data Flow Diagrams (DFDs) with structured analysis notation |\n| `/arckit:diagram` | Architecture diagrams (C4, Mermaid) |\n\n### Phase 3: Research & Procurement\n\n| Command | Description |\n|---------|-------------|\n| `/arckit:research` | Technology research with build vs buy analysis |\n| `/arckit:datascout` | Data source discovery and API catalogue search |\n| `/arckit:aws-research` | AWS service research (via AWS Knowledge MCP) |\n| `/arckit:azure-research` | Azure service research (via Microsoft Learn MCP) |\n| `/arckit:gcp-research` | GCP service research (via Google Developer Knowledge MCP) |\n| `/arckit:gcloud-search` | G-Cloud 14 framework search |\n| `/arckit:gcloud-clarify` | G-Cloud supplier clarification questions |\n| `/arckit:dos` | Digital Outcomes and Specialists procurement |\n| `/arckit:sow` | Statement of Work for RFP |\n| `/arckit:evaluate` | Vendor scoring and evaluation |\n| `/arckit:framework` | Transform artifacts into structured framework with principles and guidance |\n\n### Phase 4: Beta & Live\n\n| Command | Description |\n|---------|-------------|\n| `/arckit:hld-review` | High-Level Design review |\n| `/arckit:dld-review` | Detailed-Level Design review |\n| `/arckit:principles-compliance` | Architecture principles compliance (RAG evidence) |\n| `/arckit:service-assessment` | GDS Service Standard assessment |\n| `/arckit:secure` | UK Government Secure by Design review |\n| `/arckit:mod-secure` | MOD Secure by Design review |\n| `/arckit:jsp-936` | JSP 936 AI assurance documentation |\n| `/arckit:tcop` | Technology Code of Practice assessment |\n| `/arckit:atrs` | AI Transparency Risk Standards assessment |\n| `/arckit:ai-playbook` | AI Playbook compliance check |\n| `/arckit:conformance` | Architecture conformance assessment (ADR implementation, drift, debt) |\n\n### Phase 5: Operations & Delivery\n\n| Command | Description |\n|---------|-------------|\n| `/arckit:devops` | DevOps maturity assessment and CI/CD pipeline design |\n| `/arckit:finops` | FinOps cloud cost optimization assessment |\n| `/arckit:mlops` | MLOps maturity assessment and ML pipeline design |\n| `/arckit:operationalize` | Service operationalization and runbook generation |\n| `/arckit:backlog` | Sprint-ready backlog generation |\n| `/arckit:presentation` | MARP presentation slides from project artifacts |\n| `/arckit:story` | Executive story for steering committee |\n\n### Analysis & Reporting\n\n| Command | Description |\n|---------|-------------|\n| `/arckit:analyze` | Comprehensive gap analysis across all artifacts |\n| `/arckit:traceability` | Requirements traceability matrix |\n| `/arckit:servicenow` | ServiceNow CMDB export design |\n| `/arckit:trello` | Trello board export |\n| `/arckit:glossary` | Consolidated project glossary of terms and acronyms |\n| `/arckit:health` | Project health scan (stale research, orphaned artifacts, drift) |\n| `/arckit:maturity-model` | Capability maturity model with assessment criteria |\n| `/arckit:pages` | GitHub Pages documentation site |\n\n### Utilities\n\n| Command | Description |\n|---------|-------------|\n| `/arckit:customize` | Template customization manager |\n| `/arckit:template-builder` | Create new document templates via interactive interview |\n\n### Interoperability\n\n| Command | Description |\n|---------|-------------|\n| `/arckit:export-okf` | Export ArcKit artifacts as an OKF-compatible Markdown bundle |\n| `/arckit:import-okf` | Import OKF bundles as reviewable research notes |\n\n## Agents\n\nArcKit includes 6 autonomous research agents that handle web-intensive tasks:\n\n- **arckit-research** — Market research, vendor evaluation, build vs buy\n- **arckit-datascout** — Data source discovery, API catalogue search\n- **arckit-aws-research** — AWS service research (via AWS Knowledge MCP)\n- **arckit-azure-research** — Azure service research (via Microsoft Learn MCP)\n- **arckit-gcp-research** — GCP service research (via Google Developer Knowledge MCP)\n- **arckit-framework** — Transform artifacts into structured framework\n\n## Hooks\n\nAutomation hooks fire during your session to provide context and enforce standards:\n\n- **Session Init** — Injects ArcKit version and project status on startup\n- **Context Inject** — Adds project artifact inventory before agent planning\n- **Filename Validator** — Validates ARC-xxx naming convention on file writes\n- **File Protection** — Blocks writes to sensitive/protected files\n- **Manifest Updater** — Updates manifest.json after writing project files\n\n## Policies\n\nPolicy rules enforce extension safety:\n\n- Prevent modification of ArcKit extension system files\n- Warn when file content may contain potential secrets\n\n## Theme\n\nArcKit includes a GDS-branded terminal theme using official UK Government Design System colors.\n\n## Template Customization\n\nOverride default templates by placing customized versions in your project:\n\n```bash\n# Create override directory\nmkdir -p .arckit/templates\n\n# Copy and edit a template\ncp ~/.gemini/extensions/arckit/templates/requirements-template.md .arckit/templates/\n\n# Edit to match your organization's needs\n# Commands will automatically use your override\n```\n\nCommon customizations:\n\n- Remove UK Government sections for non-UK Gov projects\n- Add organization-specific Document Control fields\n- Change requirement ID prefixes\n- Add branding, headers, footers\n\n## Workflow Example\n\n```bash\n# 1. Create project plan\n/arckit:plan Create project plan for payment modernization with 6-month timeline\n\n# 2. Establish governance\n/arckit:principles Create cloud-first principles for financial services\n\n# 3. Discovery phase\n/arckit:stakeholders Analyze stakeholders for payment gateway\n/arckit:risk Create risk register for payment modernization\n/arckit:sobc Create Strategic Outline Business Case with £2M investment\n\n# 4. Alpha phase\n/arckit:requirements Create requirements for payment gateway\n/arckit:data-model Create data model for payment transactions with PCI-DSS compliance\n/arckit:wardley Create Wardley map showing build vs buy for payment infrastructure\n\n# 5. Research & procurement\n/arckit:research Research payment processing platforms\n/arckit:aws-research Evaluate AWS payment services\n/arckit:gcloud-search Search G-Cloud 14 for payment processing services\n\n# 6. Design reviews\n/arckit:hld-review Review high-level design for microservices architecture\n/arckit:secure Conduct Secure by Design review\n\n# 7. Delivery\n/arckit:backlog Generate sprint backlog with velocity 20 and 8 sprints\n```\n\n## MCP Servers\n\nThe extension bundles three MCP servers for cloud research:\n\n| Server | Purpose | Auth Required |\n|--------|---------|---------------|\n| AWS Knowledge | AWS service docs, best practices | None |\n| Microsoft Learn | Azure and Microsoft docs | None |\n| Google Developer Knowledge | GCP docs | `GOOGLE_API_KEY` |\n\nMCP servers are bridged via `mcp-remote` (requires Node.js).\n\n## Alternative Installation: ArcKit CLI\n\nThe extension is recommended for all Gemini CLI users as it provides automatic updates and a clean zero-config experience.\n\n## Links\n\n- **Main ArcKit repo**: [github.com/tractorjuice/arc-kit](https://github.com/tractorjuice/arc-kit)\n- **Claude Code plugins**: Install via `/plugin marketplace add tractorjuice/arckit-claude`\n- **Issues**: [github.com/tractorjuice/arc-kit/issues](https://github.com/tractorjuice/arc-kit/issues)\n- **Gemini CLI**: [github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli)\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n",
  "bytes": 10470,
  "sha": "492903ed0dd9f50b94432391a981f547bf0d7b5e93e65c47ca598c214ce8aacb",
  "repo_slug": "tractorjuice/arckit-gemini",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_tractorjuice_arckit_gemini_b097468e/readme"
}