Skip to main content

​
Overview

Generate a comprehensive compliance assessment that measures adherence to each architecture principle defined in your organization. Includes RAG status (Red/Amber/Green), evidence links, gaps, and actionable recommendations.
Point-in-time assessment - Run at key project gates (Discovery, Alpha, Beta, Live) to track compliance over time.

​
When to Use

Use /arckit.principles-compliance to:
  • Validate project compliance before design reviews
  • Assess vendor proposals against principles
  • Track compliance improvement over time
  • Prepare for architecture governance board reviews
Prerequisites: Architecture principles (/arckit.principles)

​
Usage

/arckit.principles-compliance 001-payment-gateway
/arckit.principles-compliance security principles only
/arckit.principles-compliance all projects

​
What It Creates

File: projects/{project}/ARC-{PID}-PCOM-v1.0.md Sections:
  1. Executive Summary - Overall compliance score and RAG distribution
  2. Principle Assessment - For each principle:
    • RAG status (🔴 RED / 🟠 AMBER / 🟢 GREEN)
    • Evidence from artifacts (with file refs and line numbers)
    • Gaps identified
    • Recommendations for improvement
  3. Compliance Scorecard - Matrix of principles vs RAG status
  4. Gap Analysis - Prioritized list of non-compliance issues
  5. Action Plan - Remediation steps with owners and timelines
  6. Exception Requests - Principles requiring formal exception approval

​
RAG Assessment Criteria

StatusCriteria
🟢 GREENFull compliance with concrete evidence in multiple artifacts
🟠 AMBERPartial compliance, some gaps, or weak evidence
🔴 REDNon-compliance or no evidence found

​
Evidence Sources

The assessment searches these artifacts for evidence:
  • Requirements (ARC-*-REQ-*.md)
  • High-Level Design (hld-*.md)
  • Detailed Design (dld-*.md)
  • TCoP Assessment (ARC-*-TCOP-*.md)
  • Secure by Design (ARC-*-SECD-*.md)
  • Data Model (ARC-*-DATA-*.md)
  • Traceability Matrix (ARC-*-TRAC-*.md)
Evidence-based assessment - RAG status must be justified by concrete evidence (file references, section numbers). Avoid vague statements.

​
Dynamic Principle Extraction

The command automatically extracts all principles from projects/000-global/ARC-000-PRIN-*.md - whether you have 5, 10, or 20 principles.

​
Compliance Score

Overall score calculation: 
Score = (GREEN × 100 + AMBER × 50 + RED × 0) / Total Principles
  • 90-100% - Excellent compliance
  • 70-89% - Good compliance, minor gaps
  • 50-69% - Acceptable, significant improvements needed
  • <50% - Poor compliance, major rework required

Principles

Create architecture principles

HLD Review

Review design against principles

Analyze

Comprehensive governance analysis

TCoP

Technology Code of Practice compliance

Build docs developers (and LLMs) love

Get started for freeTalk to us