Back to Guides
A short AI-narrated film with English captions. Pressing play loads the YouTube player. Watch on YouTube
Guide Origin: Official | ArcKit Version: [VERSION]
/arckit:principles-compliance scores each architecture principle defined in projects/000-global/ARC-000-PRIN-v1.0.md, producing a RAG status with evidence and actions.
Inputs
| Artefact | Contribution |
|---|---|
| Architecture principles | Source of truth for principle definitions, validation gates |
| Requirements, designs, reviews | Evidence for compliance or gaps |
| Risk register & exceptions | Track tolerances and remediation plans |
Command
/arckit:principles-compliance <description>
Output saved as projects/<id>/ARC-<id>-PRIN-COMP-v1.0.md.
Scorecard Structure
| Column | Meaning | Typical Actions |
|---|---|---|
| Principle | ID + summary | Ensure names align with governance library |
| Status | ✅ / ⚠️ / ❌ / ⏳ (not assessed) | Address ❌ immediately; plan remediation for ⚠️ |
| Evidence | Artefacts referenced (requirements, diagrams, reviews) | Confirm links resolve to current documents |
| Actions | Required remediation, owner, due date | Track via backlog or governance board |
Review Rhythm
| Phase | Purpose |
|---|---|
| Discovery | Identify principles that will drive scope and constraints |
| Alpha | Validate design proposals honour mandatory principles |
| Beta | Confirm implementation evidence and service readiness |
| Live / Quarterly | Detect drift, review exceptions, re-baseline actions |
Checklist
- Each principle has explicit evidence or clearly marked gap.
- Exceptions include expiry date and accountable owner.
- Actions feed into backlog with priority reflecting risk.
- Summary recommends gate decision (Block / Conditional / Proceed).
- Previous assessments archived for audit trail.
Tip
Use the generated scorecard as the backbone of design review meetings—walk through each principle, confirm status, and update actions live.