Skip to main content

​
The Problem: Architecture Governance is Broken

Traditional enterprise architecture suffers from fundamental issues that make governance inconsistent, error-prone, and time-consuming:

​
Scattered Documents Across Tools

❌ Architecture principles in Confluence
❌ Requirements in Word documents
❌ Vendor proposals in email attachments
❌ Design reviews in PowerPoint
❌ Traceability matrices in Excel Result: No single source of truth. Finding the latest version of a document becomes archaeology.

​
Inconsistent Governance Enforcement

❌ Each architect uses different templates
❌ Requirements vary in detail and structure
❌ Design reviews miss critical evaluation criteria
❌ Compliance assessments are ad-hoc Result: Architecture quality depends on individual experience rather than systematic process.

​
Manual Vendor Evaluation with Bias

❌ Vendor selection based on “gut feeling”
❌ No structured evaluation framework
❌ Hidden biases in scoring
❌ Poor documentation of decision rationale Result: Procurement challenges, supplier disputes, and suboptimal technology choices.

​
Lost Traceability

❌ Requirements disappear between documents
❌ Design decisions lack justification
❌ No link between business drivers and technical choices
❌ Impact analysis for changes is guesswork Result: Technical debt, scope creep, and compliance failures.

​
Stale Documentation

❌ Documents created once, never updated
❌ No version control or change history
❌ Documentation doesn’t match reality
❌ Knowledge loss when architects leave Result: Architecture documentation becomes “shelfware” — written to satisfy process, ignored in practice.

​
The Solution: Structured, AI-Assisted Governance

ArcKit provides a systematic workflow for enterprise architecture governance, combining:
  • Comprehensive templates that ensure nothing is forgotten
  • Clear process flows from requirements → procurement → design review
  • AI assistance to handle document generation while you focus on decisions
  • Enforced traceability with automatic gap detection
  • Git-based version control for all architecture artifacts

​
Template-Driven Quality

✅ Comprehensive templates for every governance artifact
✅ Consistent structure across all projects
✅ Mandatory sections ensure completeness
✅ Customizable for organization-specific needs Benefit: Every architect produces high-quality deliverables, regardless of experience level.
ArcKit requirements templates include:
  • Document Control: Version, status, authors, approvals
  • Business Requirements: Context, rationale, success criteria
  • Functional Requirements: User stories, acceptance criteria
  • Non-Functional Requirements: Performance, security, scalability, compliance
  • Integration Requirements: Upstream/downstream systems, APIs, data flows
  • Data Requirements: Entities, attributes, PII, GDPR compliance
  • Success Criteria: Measurable KPIs and benefits
  • Traceability Matrix: Links to stakeholders, principles, risks
See NHS Appointment Booking Requirements for a complete example.

​
Systematic Workflows

✅ Clear process flows guide architects through the lifecycle
✅ Dependency ordering ensures artifacts build on each other
✅ Gate approvals at each phase
✅ Automated gap detection identifies missing artifacts Benefit: Architects know exactly what to do next. No more “where do I start?”
1

Establish Governance

Define architecture principles that guide all decisions.Command: /arckit.principles
2

Analyze Stakeholders

Identify stakeholders, drivers, goals, and outcomes.Command: /arckit.stakeholders
3

Assess Risks

Create comprehensive risk register (HM Treasury Orange Book).Command: /arckit.risk
4

Build Business Case

Create Strategic Outline Business Case (Green Book 5-case model).Command: /arckit.sobc
5

Define Requirements

Document comprehensive requirements with acceptance criteria.Command: /arckit.requirements
6

Model Data

Create data model with ERD, GDPR compliance, data governance.Command: /arckit.data-model
7

Research Technology

Research available solutions with build vs buy analysis.Command: /arckit.research
8

Strategic Planning

Create Wardley Maps for strategic positioning and vendor comparison.Command: /arckit.wardley
9

Vendor Procurement

Generate Statement of Work (RFP) or UK Digital Marketplace procurement.Commands: /arckit.sow, /arckit.dos, /arckit.gcloud-search
10

Design Review

Review High-Level Design and Detailed Design.Commands: /arckit.hld-review, /arckit.dld-review
11

Sprint Planning

Generate prioritised product backlog with GDS user stories.Command: /arckit.backlog
12

Traceability

Generate traceability matrix and gap analysis.Command: /arckit.traceability

​
AI Assistance for Document Generation

✅ AI generates first drafts from natural language prompts
✅ You focus on decisions, not formatting
✅ Iterative refinement with conversational feedback
✅ Context-aware — AI reads existing artifacts for consistency Benefit: 75%+ time savings on documentation. Spend your time on architecture, not Word.
Example: Generating a comprehensive requirements document manually takes 4-6 weeks. With ArcKit, you provide context in natural language and get a first draft in minutes. Refinement takes 3-5 days instead of weeks.

​
Enforced Traceability

✅ Automatic traceability matrices link artifacts
✅ Gap detection identifies missing coverage
✅ Change impact analysis shows downstream effects
✅ Compliance mapping to regulations and standards Benefit: Never lose track of why decisions were made. Audit-ready documentation.
ArcKit maintains end-to-end traceability:
Stakeholder (STKE-001: Chief Risk Officer)
  → Driver (D-001: Regulatory Compliance)
    → Goal (G-001: Achieve PCI-DSS Level 1 compliance)
      → Outcome (O-001: Zero payment data breaches)
        → Risk (RISK-006: Data Breach)
          → Requirement (NFR-007: Encryption at rest and in transit)
            → Design Decision (ADR-003: Use AWS KMS for encryption)
              → Component (Payment Data Store with KMS integration)
                → Test (T-NFR-007: Verify encryption implementation)
                  → User Story (US-042: As a system, encrypt all PII)
See NHS Appointment Booking Traceability for a complete example.

​
Git-Based Version Control

✅ All artifacts in Markdown — diffable, mergeable, human-readable
✅ Git commit history tracks every change
✅ Branching for alternatives — compare design options
✅ Pull requests for reviews — collaborative decision-making Benefit: Architecture documentation is code. Treat it with the same rigor.

​
UK Government Compliance

ArcKit includes dedicated commands for UK public sector delivery, ensuring compliance with government standards:

​
GDS Service Standard

✅ Service Assessment Preparation: /arckit.service-assessment analyzes evidence against all 14 Service Standard points
✅ Gap Analysis: Identifies missing evidence for alpha, beta, or live assessments
✅ RAG Ratings: Red/Amber/Green ratings with overall readiness score
✅ Recommendations: Actionable steps with priorities and timelines

​
Technology Code of Practice

✅ TCoP Assessment: /arckit.tcop assesses compliance with all 13 TCoP points
✅ Phase-Specific Guidance: Tailored advice for Discovery, Alpha, Beta, Live
✅ Evidence Mapping: Links ArcKit artifacts to TCoP requirements

​
Secure by Design

✅ NCSC CAF: /arckit.secure generates Secure by Design artefacts covering NCSC Cloud Assessment Framework
✅ Cyber Essentials: Cyber Essentials and Cyber Essentials Plus compliance
✅ UK GDPR: Data protection compliance with DPA 2018

​
Responsible AI

✅ AI Playbook: /arckit.ai-playbook produces responsible AI assessments aligned to UK Government AI Playbook and ATRS
✅ MOD AI Assurance: /arckit.jsp-936 delivers JSP 936 AI assurance packs for defence AI systems
✅ Algorithmic Transparency: /arckit.atrs generates ATRS records for algorithmic decision-making
See the Cabinet Office GenAI Platform and NHS Appointment Booking demo repositories for end-to-end UK Government compliance examples.

​
Real-World Impact

​
Time Savings

  • Requirements Documentation: 75%+ time savings (4-6 weeks → 3-5 days)
  • Risk Register Creation: 80%+ time savings (2-3 weeks → 2-3 days)
  • Vendor Evaluation: 70%+ time savings (3-4 weeks → 1 week)
  • Traceability Matrix: 90%+ time savings (1-2 weeks → 1 day)

​
Quality Improvements

  • Comprehensive Coverage: Templates ensure no requirements are missed
  • Consistent Structure: All projects follow the same governance process
  • Audit-Ready: Complete traceability from stakeholders to implementation
  • Compliance: Built-in UK Government standards (Service Standard, TCoP, NCSC CAF)

​
Strategic Benefits

  • Better Decisions: Wardley Mapping and build vs buy analysis guide technology choices
  • Reduced Risk: Systematic risk assessment and mitigation planning
  • Vendor Accountability: Structured procurement and evaluation reduce bias
  • Knowledge Retention: Git-based documentation survives team changes

​
Who Uses ArcKit?

​
Enterprise Architects

Define architecture principles, review designs, ensure compliance with governance.

​
Solution Architects

Create requirements, research technology, generate design documentation, conduct vendor procurement.

​
Technical Architects

Model data, create architecture diagrams, document design decisions (ADRs), plan sprints.

​
Procurement Teams

Generate RFPs, evaluate vendors, conduct G-Cloud searches, validate supplier claims.

​
UK Government Digital Teams

Prepare for Service Assessments, demonstrate TCoP compliance, implement Secure by Design.

​
Getting Started

Ready to transform your architecture governance?
1

Install ArcKit

See the Installation guide for your platform.
2

Run the Quickstart

Follow the Quickstart to create your first project in under 5 minutes.
3

Explore Examples

Browse 14+ demonstration repositories showing complete ArcKit workflows.

​
Summary

The Problem:
  • ❌ Scattered documents
  • ❌ Inconsistent governance
  • ❌ Manual vendor evaluation
  • ❌ Lost traceability
  • ❌ Stale documentation
The Solution:
  • ✅ Template-driven quality
  • ✅ Systematic workflows
  • ✅ AI assistance
  • ✅ Enforced traceability
  • ✅ Git-based version control
The Result:
  • 📈 75%+ time savings
  • 📊 Comprehensive coverage
  • 🔒 Audit-ready documentation
  • 🇬🇧 UK Government compliance
  • 🧠 Knowledge retention

Build docs developers (and LLMs) love

Get started for freeTalk to us