| name | constitute-check |
| description | Memory-bank governance audit — checks whether T0 laws/current state, T1 supporting context, T2 execution mirrors, and T3 archive indexes exist and align with current code and docs. Read-only. |
| argument-hint | [optional: 'full' for verbose report, or a specific principle number] |
| user-invocable | true |
| allowed-tools | Read, Glob, Grep |
| model | haiku |
| context | !echo "=== Memory Bank Status ===" && echo "T0: $(ls memory_bank/t0_core/ 2>/dev/null | wc -l) files" && echo "T1: $(ls memory_bank/t1_axioms/ 2>/dev/null | wc -l) files" && echo "T2: $(ls memory_bank/t2_execution/ 2>/dev/null | wc -l) files" && echo "T3: $(ls memory_bank/t3_archive/ 2>/dev/null | wc -l) files" && echo "Review mode: $(cat production/review-mode.txt 2>/dev/null || echo 'not set')"
|
User Guide
- When to use: Memory-bank governance audit — checks whether T0 laws/current state, T1 supporting context, T2 execution mirrors, and T3 archive indexes exist and align with current code and docs. Read-only.
- Inputs: Command arguments:
/constitute-check [optional: 'full' for verbose report, or a specific principle number]; project artifacts referenced below; user decisions and approvals before writes.
- Outputs: Primary artifacts, reports, or conversation guidance described below; write files only after user approval.
- Memory-bank writes: None; this is a read-only T0-T3 health audit and migration recommendation workflow.
- Next steps: Follow the workflow hand-off or next-step guidance below; recommendations do not auto-run and require explicit user command/approval.
Phase 0: Domain Routing
Detect the project domain before checking constitution compliance:
design/cdd/game-concept.md -> [Game] verify principles against player fantasy, core loop, game pillars, playtest evidence, and game-specific CDDs.design/cdd/product-concept.md -> [Product] verify principles against user promise, JTBD, target workflows, product modules, API/CLI contracts, and product-specific CDDs.- If neither exists, check only the constitution and report that domain-specific validation is pending.
Do not remove game constitution examples. Product checks are an added validation path.
Constitution Check — T0-T3 Memory Health Audit
This skill is read-only — it reports findings but writes no files.
This skill checks the health of a project's memory-bank governance plane:
whether T0 laws/current state exist, whether T1 supporting context is present,
whether T2 execution mirrors exist when the project has been initialized, and
whether T3 archive indexes exist once evidence is produced. It is lightweight —
not a full 4-gate CDD audit. For a complete project scan, use
/project-stage-detect.
Step 1: Verify Constitution Exists
Check for the minimum memory-bank artifacts:
| Artifact | Required? | How to check |
|---|
memory_bank/t0_core/basic_law_index.md | Yes | Read if exists |
memory_bank/t0_core/active_context.md | Yes | Read if exists |
memory_bank/t0_core/current_state.md | Yes | Read if exists |
memory_bank/t1_axioms/tech_context.md | Yes | Read if exists |
memory_bank/t1_axioms/system_patterns.md | Yes | Read if exists |
memory_bank/t1_axioms/behavior_context.md | Yes | Read if exists |
memory_bank/t1_axioms/architecture_context.md | Recommended | Read if exists |
memory_bank/t1_axioms/ux_accessibility_context.md | Recommended | Read if exists |
memory_bank/t1_axioms/qa_context.md | Recommended | Read if exists |
memory_bank/t1_axioms/knowledge_graph.md | Recommended | Read if exists |
memory_bank/t1_axioms/module_support_map.yaml | Recommended | Read if exists |
memory_bank/t2_execution/workflow_contract.md | Recommended | Read if exists |
memory_bank/t2_execution/current_roadmap.md | Recommended | Read if exists |
memory_bank/t3_archive/README.md | Recommended | Read if exists |
memory_bank/t3_archive/gate_runs/README.md | Recommended | Read if exists |
memory_bank/t3_archive/release_evidence/README.md | Recommended | Read if exists |
memory_bank/t3_archive/reviews/README.md | Recommended | Read if exists |
memory_bank/t3_archive/reviews/review-index.md | Recommended | Read if exists |
memory_bank/t3_archive/sprint_snapshots/README.md | Recommended | Read if exists |
memory_bank/t3_archive/sprint_snapshots/story-closure-index.md | Recommended | Read if exists |
memory_bank/t3_archive/amendments/README.md | Recommended | Read if exists |
memory_bank/README.md | Recommended | Read if exists |
If basic_law_index.md is missing: "No constitution detected. Run /constitute
to establish one." Stop here — nothing else to check.
If basic_law_index.md exists but older projects only have T0/T1 files, report
NEEDS ATTENTION with a migration recommendation. Do not mark old T0/T1-only
projects CRITICAL unless a required T0 file or tech_context.md is missing.
If memory_bank/t0_core/knowledge_graph.md exists, report it as a deprecated compatibility path. The canonical path is now
memory_bank/t1_axioms/knowledge_graph.md.
Step 2: Read the Constitution
Read memory_bank/t0_core/basic_law_index.md and extract:
- Core thesis (Support ID: BL-01)
- All laws/ principles (Support IDs: BL-02 through BL-06)
- Each law's current-state requirement
Read memory_bank/t0_core/active_context.md and extract:
- Current working state (State A-E)
- Module status summaries
- Active risks and open decisions
Read memory_bank/t0_core/current_state.md when present and extract:
- Current phase
- Current blocker
- Next command
- Stage source
Read memory_bank/t1_axioms/tech_context.md and extract:
- Language, framework, platform
- Performance budgets
- External dependencies
Read T2 files when present:
memory_bank/t2_execution/workflow_contract.mdmemory_bank/t2_execution/current_roadmap.md
Read T3 indexes when present:
memory_bank/t3_archive/qa_evidence_index.mdmemory_bank/t3_archive/gate_runs/memory_bank/t3_archive/release_evidence/memory_bank/t3_archive/reviews/memory_bank/t3_archive/reviews/review-index.mdmemory_bank/t3_archive/sprint_snapshots/memory_bank/t3_archive/sprint_snapshots/story-closure-index.mdmemory_bank/t3_archive/amendments/
Step 3: Alignment Check
For each constitutional principle, check alignment with the codebase:
3a: Principle → Code Alignment
For each law in basic_law_index.md, perform a quick alignment scan:
- Read the law's current-state requirement
- Check whether the codebase respects it
- Flag violations or uncertainties
Example checks:
- Law requires "no function over 20 lines" → grep for functions, check length
- Law requires "API stability: no breaking changes" → check for deprecation markers
- Law requires "all public APIs documented" → check docstring coverage in
src/
- Law requires "tests before merge" → check test file count vs source file count
For each law, produce one of:
- ALIGNED — evidence found that the law is being followed
- CONCERN — potential violation or insufficient evidence
- UNABLE TO CHECK — law is abstract or can't be auto-verified (e.g., "prioritize user experience")
3b: Tech Context → Reality Check
Compare tech_context.md against actual project state:
- Is the declared language actually used? (Glob
src/** for language files)
- Are declared dependencies actually in the project? (Check config files)
- Are performance budgets plausible given the codebase size?
Step 4: Gap Detection
Identify what's missing or stale:
| Gap | Detection |
|---|
| Missing T0 current state | memory_bank/t0_core/current_state.md does not exist |
| Missing T1 required docs | tech_context.md, system_patterns.md, or behavior_context.md missing |
| Missing T1 recommended docs | architecture_context.md, ux_accessibility_context.md, qa_context.md, knowledge_graph.md, or module_support_map.yaml missing |
| Deprecated knowledge graph path | memory_bank/t0_core/knowledge_graph.md exists |
| Missing T2 workflow contract | memory_bank/t2_execution/workflow_contract.md does not exist |
| Missing T2 current roadmap | Project has roadmap evidence but memory_bank/t2_execution/current_roadmap.md is missing |
| Missing T3 archive README | memory_bank/t3_archive/README.md does not exist |
| Missing T3 gate archive | Gate evidence exists but memory_bank/t3_archive/gate_runs/README.md is missing |
| Missing QA evidence index | QA evidence exists but memory_bank/t3_archive/qa_evidence_index.md is missing |
| Missing release evidence archive | Release evidence exists but memory_bank/t3_archive/release_evidence/README.md is missing |
| Missing review index | Review artifacts exist but memory_bank/t3_archive/reviews/review-index.md is missing |
| Missing story closure index | Completed stories exist but memory_bank/t3_archive/sprint_snapshots/story-closure-index.md is missing |
| Missing README | memory_bank/README.md does not exist |
| Stale tech context | Tech context mentions old versions or unused dependencies |
| Drifted principles | Law says X, code does Y |
| No review mode set | production/review-mode.txt does not exist |
Step 5: Present Report
Keep it concise. Use this format:
## Memory Bank Health: [Project Name]
**Core thesis:** [from BL-01, one line]
**Constitution established:** [date from active_context.md or file timestamp]
**Current phase:** [from current_state.md or production/stage.txt]
### T0 Current Truth
- Laws: [present/missing/stale]
- Active context: [present/missing/stale]
- Current state: [present/missing/stale]
### T1 Supporting Context
- Tech context: [present/missing/stale]
- System patterns: [present/missing/stale]
- Behavior context: [present/missing/stale]
- Recommended context: [summary]
### T2 Execution Control
- Workflow contract: [present/missing]
- Current roadmap: [present/missing/not started]
### T3 Archive Indexes
- Archive README: [present/missing]
- QA evidence index: [present/missing/not applicable yet]
- Release evidence: [present/missing/not applicable yet]
### Principles (N/M aligned)
- [Support ID]: ALIGNED — [brief evidence]
- [Support ID]: ALIGNED — [brief evidence]
- [Support ID]: CONCERN — [what's wrong, suggestion]
### ✓ Tech Stack
- Language: [X] ✓
- Framework: [Y] ✓
- Platform: [Z] ✓
- [Any concerns]
### → Gaps
- [Gap 1 — with concrete fix, e.g. "Run /constitute-check to regenerate"]
- [Gap 2]
### → Recommendations
1. [Highest priority action]
2. [Secondary action]
---
**Overall:** [HEALTHY / NEEDS ATTENTION / CRITICAL]
Severity levels:
- HEALTHY: Required T0/T1 artifacts present, T2/T3 indexes appropriate for stage, all checkable laws ALIGNED
- NEEDS ATTENTION: Old T0/T1-only memory bank, 1-2 CONCERNs, or missing recommended T1/T2/T3 indexes
- CRITICAL: Missing
basic_law_index.md, missing required T0/T1 files, 3+ CONCERNs, or stale constitution
If verbosity argument is full, add a detailed per-law analysis section with
the specific evidence found for each alignment check.
Edge Cases
- No constitution: "No constitution detected. Run
/constitute to establish your project's governing principles." Stop.
- Old T0/T1-only memory bank: "Your constitution exists, but the T2/T3 governance control plane is not initialized. Run
/constitute to refresh the memory-bank skeleton." Continue with NEEDS ATTENTION.
- Constitution exists but is very old: Note the date — "Your constitution was established [N months] ago. Much may have changed. Consider running
/constitute to refresh it."
- Path D project (existing code, new constitution): Flag likely drift — "Your constitution was recently established. Some existing code may not yet align. This is normal for brownfield adoption — prioritize alignment iteratively."
- All laws are abstract (can't auto-check): "Your principles are abstract — they can't be automatically verified. Consider adding falsifiable current-state requirements to each law for future audits."
Collaborative Protocol
- Read-only. This skill never writes files.
- Be honest. Don't sugarcoat drift or gaps.
- Be specific. Every gap must come with a concrete fix suggestion.
- One primary recommendation. The user should leave knowing exactly one thing to do next.
