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