@massu/core 1.15.5 → 1.15.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/CHANGELOG.md +70 -0
  2. package/agents/massu-architecture-reviewer.md +20 -0
  3. package/agents/massu-blast-radius-analyzer.md +20 -0
  4. package/agents/massu-competitive-scorer.md +20 -0
  5. package/agents/massu-help-sync.md +20 -0
  6. package/agents/massu-migration-writer.md +20 -0
  7. package/agents/massu-output-scorer.md +20 -0
  8. package/agents/massu-pattern-reviewer.md +20 -0
  9. package/agents/massu-plan-auditor.md +20 -0
  10. package/agents/massu-schema-sync-verifier.md +20 -0
  11. package/agents/massu-security-reviewer.md +20 -0
  12. package/agents/massu-ux-reviewer.md +20 -0
  13. package/commands/_shared-preamble.md +21 -0
  14. package/commands/_shared-references/auto-learning-protocol.md +2 -0
  15. package/commands/_shared-references/blast-radius-protocol.md +2 -0
  16. package/commands/_shared-references/security-pre-screen.md +2 -0
  17. package/commands/_shared-references/test-first-protocol.md +2 -0
  18. package/commands/_shared-references/verification-table.md +2 -0
  19. package/commands/_verification-laws.md +131 -0
  20. package/commands/_verification-laws.md.sha256 +1 -0
  21. package/commands/massu-data/references/common-queries.md +2 -0
  22. package/commands/massu-data/references/table-guide.md +2 -0
  23. package/commands/massu-data.md +2 -0
  24. package/commands/massu-debug/references/auto-learning.md +2 -0
  25. package/commands/massu-debug/references/codegraph-tracing.md +2 -0
  26. package/commands/massu-debug/references/common-shortcuts.md +2 -0
  27. package/commands/massu-debug/references/investigation-phases.md +2 -0
  28. package/commands/massu-debug/references/report-format.md +2 -0
  29. package/commands/massu-deploy.python-docker.md +2 -0
  30. package/commands/massu-deploy.python-fly.md +2 -0
  31. package/commands/massu-deploy.python-launchd.md +2 -0
  32. package/commands/massu-deploy.python-systemd.md +2 -0
  33. package/commands/massu-full-audit.md +2 -0
  34. package/commands/massu-golden-path/references/approval-points.md +2 -0
  35. package/commands/massu-golden-path/references/phase-0-requirements.md +2 -0
  36. package/commands/massu-golden-path/references/phase-1-plan-creation.md +2 -0
  37. package/commands/massu-golden-path/references/phase-2-implementation.md +2 -0
  38. package/commands/massu-golden-path/references/phase-2.5-gap-analyzer.md +2 -0
  39. package/commands/massu-golden-path/references/phase-3-simplify.md +2 -0
  40. package/commands/massu-golden-path/references/phase-3.5-security-audit.md +110 -0
  41. package/commands/massu-golden-path/references/phase-4-commit.md +2 -0
  42. package/commands/massu-golden-path/references/phase-5-push.md +2 -0
  43. package/commands/massu-golden-path/references/phase-5.5-production-verify.md +2 -0
  44. package/commands/massu-golden-path/references/phase-6-completion.md +2 -0
  45. package/commands/massu-golden-path/references/qa-evaluator-spec.md +2 -0
  46. package/commands/massu-golden-path/references/sprint-contract-protocol.md +2 -0
  47. package/commands/massu-golden-path/references/vr-visual-calibration.md +2 -0
  48. package/commands/massu-golden-path.md +30 -0
  49. package/commands/massu-guide.md +2 -0
  50. package/commands/massu-hooks.md +2 -0
  51. package/commands/massu-learning-audit.md +2 -0
  52. package/commands/massu-loop/references/auto-learning.md +2 -0
  53. package/commands/massu-loop/references/checkpoint-audit.md +2 -0
  54. package/commands/massu-loop/references/guardrails.md +2 -0
  55. package/commands/massu-loop/references/iteration-structure.md +2 -0
  56. package/commands/massu-loop/references/loop-controller.md +2 -0
  57. package/commands/massu-loop/references/plan-extraction.md +2 -0
  58. package/commands/massu-loop/references/vr-plan-spec.md +2 -0
  59. package/commands/massu-parity.md +2 -0
  60. package/commands/massu-push.md +2 -0
  61. package/commands/massu-scaffold-hook.md +2 -0
  62. package/commands/massu-scaffold-page.md +2 -0
  63. package/commands/massu-scaffold-page.swift.md +2 -0
  64. package/commands/massu-scaffold-router.md +2 -0
  65. package/commands/massu-scaffold-router.python-django.md +2 -0
  66. package/commands/massu-scaffold-router.python-fastapi.md +2 -0
  67. package/commands/massu-scaffold-router.python.md +2 -0
  68. package/dist/cli.js +69 -13
  69. package/package.json +4 -3
  70. package/patterns/build-patterns.md +2 -0
  71. package/patterns/component-patterns.md +2 -0
  72. package/patterns/display-patterns.md +2 -0
  73. package/patterns/form-patterns.md +2 -0
  74. package/patterns/integration-testing-checklist.md +2 -0
  75. package/patterns/security-patterns.md +2 -0
  76. package/patterns/testing-patterns.md +2 -0
  77. package/patterns/tool-routing.md +2 -0
  78. package/patterns/ui-patterns.md +2 -0
  79. package/protocols/plan-implementation.md +2 -0
  80. package/protocols/recovery.md +2 -0
  81. package/protocols/verification.md +2 -0
  82. package/reference/cr-rules-reference.md +2 -0
  83. package/reference/hook-execution-order.md +2 -0
  84. package/reference/lessons-learned.md +2 -0
  85. package/reference/patterns-quickref.md +2 -0
  86. package/reference/standards.md +2 -0
  87. package/reference/subagents-reference.md +2 -0
  88. package/reference/vr-verification-reference.md +2 -0
@@ -1,5 +1,7 @@
1
1
  # Common Debugging Shortcuts
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  Quick diagnosis patterns for common error types.
4
6
 
5
7
  ---
@@ -1,5 +1,7 @@
1
1
  # Investigation Phases (0-7)
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  Full detail for each investigation phase in the massu-debug protocol.
4
6
 
5
7
  ---
@@ -1,5 +1,7 @@
1
1
  # Debug Report Format
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  Templates for the debug report and session state update.
4
6
 
5
7
  ---
@@ -4,6 +4,8 @@ description: "Deploy a containerized Python service via docker compose — force
4
4
  allowed-tools: Bash(*), Read(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Massu Deploy: Python Service — Docker Compose
8
10
 
9
11
  Force-recreates the Docker container for a Python service using `docker compose`. Use this variant when your service is containerized and `massu.config.yaml` declares `config.python.service_label` matching the compose service name.
@@ -4,6 +4,8 @@ description: "Deploy a Python service to Fly.io — flyctl deploy, status check,
4
4
  allowed-tools: Bash(*), Read(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Massu Deploy: Python Service — Fly.io
8
10
 
9
11
  Deploys a Python service to Fly.io using `flyctl deploy`. Use this variant when your project targets Fly.io and has a `fly.toml` in the repository root. The app name comes from `fly.toml` (or `config.python.service_label` as a fallback).
@@ -4,6 +4,8 @@ description: "Deploy a Python service supervised by launchd (macOS) — restart
4
4
  allowed-tools: Bash(*), Read(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Massu Deploy: Python Service — launchd (macOS)
8
10
 
9
11
  Restarts a Python service running under `launchd` on macOS. Use this variant when your `massu.config.yaml` declares `config.python.service_label` and your host is macOS.
@@ -4,6 +4,8 @@ description: "Deploy a Python service supervised by systemd (Linux) — restart
4
4
  allowed-tools: Bash(*), Read(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Massu Deploy: Python Service — systemd (Linux)
8
10
 
9
11
  Restarts a Python service running under a `systemd --user` unit on Linux. Use this variant when your `massu.config.yaml` declares `config.python.service_label` and your host is Linux.
@@ -1,3 +1,5 @@
1
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
2
+
1
3
  name: massu-full-audit
2
4
 
3
5
  # Massu Full Audit
@@ -1,5 +1,7 @@
1
1
  # Approval Points
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  There are exactly 4 approval points (5 when using `--competitive` mode) where the golden path pauses for user input. Everything else runs automatically.
@@ -1,5 +1,7 @@
1
1
  # Phase 0: Requirements & Context Loading
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  ## 0.1 Session Context Loading
@@ -1,5 +1,7 @@
1
1
  # Phase 1: Plan Creation & Audit
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  ## Phase 1A: Research & Reality Check
@@ -1,5 +1,7 @@
1
1
  # Phase 2: Implementation
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  ## Competitive Mode Check
@@ -1,5 +1,7 @@
1
1
  # Phase 2.5: Gap & Enhancement Analyzer Loop
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  ```
@@ -1,5 +1,7 @@
1
1
  # Phase 3: Simplification
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  ```
@@ -0,0 +1,110 @@
1
+ # Phase 3.5: Deep Security Audit
2
+
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
5
+ > Reference doc for `/massu-golden-path`. Return to main file for overview.
6
+
7
+ ```
8
+ [GOLDEN PATH -- PHASE 3.5: DEEP SECURITY AUDIT]
9
+ ```
10
+
11
+ ## Purpose
12
+
13
+ Run a full adversarial security audit loop against ALL files changed in this golden path run. This is a deep, iterative audit with parallel red-team agents that converges to zero findings. It runs AFTER simplification (Phase 3) so the audit targets the final, cleaned-up code -- and BEFORE pre-commit verification (Phase 4) so all security fixes are included in the verification gates.
14
+
15
+ **This phase is NEVER skipped.** Security is non-negotiable regardless of change size, type, or scope.
16
+
17
+ ---
18
+
19
+ ## 3.5.1 Determine Audit Scope
20
+
21
+ Collect ALL files changed during this golden path run:
22
+
23
+ ```bash
24
+ git diff --name-only HEAD
25
+ ```
26
+
27
+ If files were already committed in earlier phases, also include:
28
+ ```bash
29
+ git diff --name-only main...HEAD
30
+ ```
31
+
32
+ The audit scope is the union of all changed files. Do NOT narrow scope -- every changed file gets audited.
33
+
34
+ **Output:**
35
+ ```
36
+ SECURITY AUDIT SCOPE:
37
+ Files: [N]
38
+ [list of files]
39
+ ```
40
+
41
+ ---
42
+
43
+ ## 3.5.2 Execute Deep Security Audit
44
+
45
+ Run the full security audit protocol against the scoped files:
46
+
47
+ 1. **Launch 2-4 parallel adversarial reviewer agents** adapted to the codebase area:
48
+ - Backend/API code: 4 agents (Injection, Network/Leakage, DoS/Resources, Red Team Bypass)
49
+ - Frontend code: 3 agents (XSS/Injection, Auth/Data Exposure, Input Validation/Logic)
50
+ - Infrastructure/config: 2 agents (Secrets/Config, Dependencies/Supply Chain)
51
+
52
+ 2. **Consolidate findings** -- deduplicate across agents, take higher severity on disagreements
53
+
54
+ 3. **Fix ALL findings** -- CRITICAL first, then HIGH, MEDIUM, LOW. INFO documented only.
55
+
56
+ 4. **Verify fixes** -- import checks, input validation tests, functionality preserved
57
+
58
+ 5. **Loop until zero findings** -- max 5 iterations, escalate to user if still failing after 5
59
+
60
+ ---
61
+
62
+ ## 3.5.3 Attack Vector Coverage
63
+
64
+ Every audit iteration MUST verify the complete attack vector checklist:
65
+
66
+ ### Universal
67
+ - Hardcoded secrets / API keys / credentials
68
+ - Error messages leaking internal details
69
+ - Dependency vulnerabilities
70
+ - Input validation on ALL external boundaries
71
+
72
+ ### Backend / API
73
+ - SQL injection, command injection, path traversal
74
+ - SSRF, authentication bypass, authorization bypass
75
+ - DoS via unbounded inputs, memory leaks, race conditions
76
+ - Response validation, type confusion
77
+
78
+ ### Frontend
79
+ - XSS, open redirects, sensitive data in client state
80
+ - CSRF, client-side auth bypass
81
+
82
+ ### LLM / AI Specific
83
+ - Prompt injection, model output trust
84
+ - Tool argument injection, vision/multimodal injection
85
+
86
+ ---
87
+
88
+ ## 3.5.4 Completion Gate
89
+
90
+ The phase completes ONLY when the audit loop achieves a clean pass with zero findings.
91
+
92
+ ```
93
+ SECURITY_AUDIT_GATE: PASS
94
+ Iterations: [N]
95
+ Total findings fixed: [N]
96
+ Breakdown: [X] CRITICAL, [X] HIGH, [X] MEDIUM, [X] LOW fixed
97
+ Clean pass: Iteration [N]
98
+ ```
99
+
100
+ **Do NOT proceed to Phase 4 until SECURITY_AUDIT_GATE = PASS.**
101
+
102
+ ---
103
+
104
+ ## Rules
105
+
106
+ 1. **NEVER skip this phase** -- not for small changes, not for docs, not for config
107
+ 2. **NEVER proceed with findings unfixed** -- zero means zero
108
+ 3. **ALL severity levels get fixed** -- CRITICAL through LOW
109
+ 4. **No commit prompt** -- unlike standalone security audit commands, do NOT offer to commit here (Phase 4 handles commits)
110
+ 5. **Findings feed Phase 4** -- security fixes are verified by Phase 4's type check, build, lint, and secrets gates automatically
@@ -1,5 +1,7 @@
1
1
  # Phase 4: Pre-Commit Verification
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  ```
@@ -1,5 +1,7 @@
1
1
  # Phase 5: Push Verification & Push
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  ```
@@ -1,5 +1,7 @@
1
1
  # Phase 5.5: Production Verification
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  ```
@@ -1,5 +1,7 @@
1
1
  # Phase 6: Completion
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path`. Return to main file for overview.
4
6
 
5
7
  ## 6.1 Final Report
@@ -1,5 +1,7 @@
1
1
  # QA Evaluator Specification
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path` Phase 2C. Return to `phase-2-implementation.md` for full Phase 2.
4
6
 
5
7
  ## Purpose
@@ -1,5 +1,7 @@
1
1
  # Sprint Contract Protocol
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-golden-path` Phase 2A.5. Return to `phase-2-implementation.md` for full Phase 2.
4
6
 
5
7
  ## What Is a Sprint Contract?
@@ -1,5 +1,7 @@
1
1
  # VR-VISUAL Calibration Examples
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for VR-VISUAL 4-dimension weighted scoring.
4
6
  > Used by `scripts/ui-review.sh` and golden-path Phase 2.5 gap analysis.
5
7
 
@@ -150,6 +150,35 @@ Read `references/phase-3-simplify.md` for full details.
150
150
 
151
151
  ---
152
152
 
153
+ ## PHASE 3.5: DEEP SECURITY AUDIT
154
+
155
+ Read `references/phase-3.5-security-audit.md` for full details.
156
+
157
+ **Summary**: A full adversarial security audit loop against EVERY file changed in this run —
158
+ parallel red-team agents, iterating until the audit converges to ZERO findings. It runs AFTER
159
+ simplification (so it audits the final, cleaned-up code) and BEFORE pre-commit verification (so
160
+ every security fix is caught by the Phase 4 gates).
161
+
162
+ **THIS PHASE IS NEVER SKIPPED.** Security is non-negotiable regardless of the size, type, or scope
163
+ of the change. Do not narrow the audit scope: every changed file gets audited.
164
+
165
+ > **This phase SHIPPED in v0.6.1 and had vanished by v1.0.0.** It exists in no commit in this
166
+ > repository's history — the only surviving copy on the machine was in a consumer repo that had
167
+ > committed its installed commands back in April. So for every version from v1.0.0 to v1.15.5,
168
+ > every user's golden path ran with **no security audit phase at all**, and nothing anywhere said
169
+ > so.
170
+ >
171
+ > It was found by accident, on 2026-07-14, when a `git status` showed the file being deleted from
172
+ > that consumer during a reinstall. **The reference-link guard could never have found it:** that
173
+ > guard asks "does every reference file have a link?", and a file that has been deleted outright
174
+ > has no link to be missing. A check that only sees *broken* things is blind to *absent* ones —
175
+ > which is the same failure as a scanner that reports CLEAN because it scanned zero files.
176
+ >
177
+ > Restored and wired 2026-07-14. Guarded by `golden-path-quality-subsystems-wired.test.ts`, which
178
+ > asserts the file EXISTS, is LINKED, and is INVOKED — a conjunction no deletion can satisfy.
179
+
180
+ ---
181
+
153
182
  ## PHASE 4: PRE-COMMIT VERIFICATION
154
183
 
155
184
  Read `references/phase-4-commit.md` for full details.
@@ -216,6 +245,7 @@ This skill is a folder. The following files are available for reference:
216
245
  | `references/vr-visual-calibration.md` | Score 5/3/1 calibration examples for VR-VISUAL weighted dimensions | Calibrating VR-VISUAL scoring in Phase 2.5 |
217
246
  | `references/phase-2.5-gap-analyzer.md` | Gap/enhancement analysis loop, 7 categories (incl. sprint-contract compliance), fix-and-repass until zero | After implementation, before simplification |
218
247
  | `references/phase-3-simplify.md` | Pattern scanner fast gate, dead code detection, parallel semantic review agents | Running simplification after implementation |
248
+ | `references/phase-3.5-security-audit.md` | Adversarial red-team security audit loop over every changed file, iterating to ZERO findings | Phase 3.5 — after simplification, before pre-commit. NEVER skipped |
219
249
  | `references/phase-4-commit.md` | Auto-verification gates, quality scoring, commit format | Preparing a commit |
220
250
  | `references/phase-5-push.md` | Pre-flight, 4-tier push verification, regression detection | Preparing to push to remote |
221
251
  | `references/phase-5.5-production-verify.md` | Deployment landed, runtime logs clean, feature exercised against production with real data | Phase 5.5 — after push, before calling it done |
@@ -3,6 +3,8 @@ name: massu-guide
3
3
  description: "When a new user or contributor asks 'how does this work', 'give me a tour', 'onboarding', or needs an interactive walkthrough of the codebase"
4
4
  allowed-tools: Bash(*), Read(*), Grep(*), Glob(*)
5
5
  ---
6
+
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
6
8
  name: massu-guide
7
9
 
8
10
  # Massu Guide: Codebase Onboarding Walkthrough
@@ -1,3 +1,5 @@
1
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
2
+
1
3
  name: massu-hooks
2
4
 
3
5
  # Massu Hooks: Profile & Status Dashboard
@@ -4,6 +4,8 @@ description: "When user says 'learning audit', 'check auto-learning', 'memory co
4
4
  allowed-tools: Bash(*), Read(*), Grep(*), Glob(*), ToolSearch(mcp__massu-codegraph__*)
5
5
  disable-model-invocation: true
6
6
  ---
7
+
8
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
7
9
  name: massu-learning-audit
8
10
 
9
11
  # Massu Learning Audit: Auto-Learning Effectiveness Validation
@@ -1,5 +1,7 @@
1
1
  # Auto-Learning Protocol
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-loop`. Return to main file for overview.
4
6
 
5
7
  ## POST-BUILD REFLECTION + MANDATORY MEMORY PERSIST (CR-38)
@@ -1,5 +1,7 @@
1
1
  # Checkpoint Audit Protocol
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-loop`. Return to main file for overview.
4
6
 
5
7
  ## CHECKPOINT AUDIT (Phase Boundaries)
@@ -1,5 +1,7 @@
1
1
  # The 10 Accountability Safeguards
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-loop`. Return to main file for overview.
4
6
 
5
7
  ## THE 10 ACCOUNTABILITY SAFEGUARDS
@@ -1,5 +1,7 @@
1
1
  # Iteration Structure
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-loop`. Return to main file for overview.
4
6
 
5
7
  ## ITERATION STRUCTURE
@@ -1,5 +1,7 @@
1
1
  # Loop Controller
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-loop`. Return to main file for overview.
4
6
 
5
7
  ## MANDATORY LOOP CONTROLLER (EXECUTE THIS - DO NOT SKIP)
@@ -1,5 +1,7 @@
1
1
  # Plan Item Extraction
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-loop`. Return to main file for overview.
4
6
 
5
7
  ## PLAN ITEM EXTRACTION PROTOCOL (MANDATORY - STEP 0)
@@ -1,5 +1,7 @@
1
1
  # VR-PLAN Verification Details
2
2
 
3
+ > **Verification laws apply.** Read `.claude/commands/_verification-laws.md` — CR-64 (a gate must prove it can fail), CR-65 (broken and empty may never render identically), and: an audit that does not run commands is not an audit.
4
+
3
5
  > Reference doc for `/massu-loop`. Return to main file for overview.
4
6
 
5
7
  ## VR-PLAN: VERIFICATION PLANNING STEP
@@ -3,6 +3,8 @@ name: massu-parity
3
3
  description: Generic feature parity check between two systems or components
4
4
  allowed-tools: Bash(*), Read(*), Grep(*), Glob(*), Write(*), Task(*)
5
5
  ---
6
+
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
6
8
  name: massu-parity
7
9
 
8
10
  # Massu Parity: Feature Parity Check
@@ -3,6 +3,8 @@ name: massu-push
3
3
  description: "When user says 'push', 'push to remote', 'deploy', or wants to push committed changes to the remote repository"
4
4
  allowed-tools: Bash(*), Read(*), Edit(*), Write(*), Grep(*), Glob(*)
5
5
  ---
6
+
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
6
8
  name: massu-push
7
9
 
8
10
  # Massu Push: Verify, Push, Monitor CI
@@ -4,6 +4,8 @@ description: "When user wants to create a new Claude Code hook — scaffolds the
4
4
  allowed-tools: Bash(*), Read(*), Write(*), Edit(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Scaffold New Hook
8
10
 
9
11
  Creates a complete Claude Code hook following the 3-tier profile system.
@@ -4,6 +4,8 @@ description: "When user wants to create a new page, screen, or view — asks whi
4
4
  allowed-tools: Bash(*), Read(*), Write(*), Edit(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Scaffold New Page / View
8
10
 
9
11
  This default template is **framework-agnostic**. It asks the user (or, when invoked by an agent, infers from `massu.config.yaml`) which target to scaffold, then dispatches to one of the embedded patterns below.
@@ -4,6 +4,8 @@ description: "When user wants to create a new view, screen, or page in a SwiftUI
4
4
  allowed-tools: Bash(*), Read(*), Write(*), Edit(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Scaffold New SwiftUI View
8
10
 
9
11
  Creates a SwiftUI View + `@MainActor` ViewModel + Decodable response model. Suitable for iOS, visionOS, or any cross-platform SwiftUI target.
@@ -4,6 +4,8 @@ description: "When user wants to create a new tRPC router, API endpoint, or back
4
4
  allowed-tools: Bash(*), Read(*), Write(*), Edit(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Scaffold New tRPC Router
8
10
 
9
11
  Creates a complete tRPC router following all project database and auth patterns.
@@ -4,6 +4,8 @@ description: "Django-specific scaffold for {{paths.python_source | default("djan
4
4
  allowed-tools: Bash(*), Read(*), Write(*), Edit(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Scaffold New Django View
8
10
 
9
11
  Creates Django views in `{{paths.python_source | default("django_app")}}` following the project's conventions. Covers function-based views (FBV), class-based views (CBV), and the corresponding `urls.py` registration. Auth guard uses `{{detected.python.auth_dep | default("login_required")}}`.
@@ -4,6 +4,8 @@ description: "FastAPI-specific scaffold for {{paths.python_source | default("app
4
4
  allowed-tools: Bash(*), Read(*), Write(*), Edit(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Scaffold New FastAPI Router
8
10
 
9
11
  Creates a complete FastAPI router following the project's existing conventions in `{{paths.python_source | default("app")}}/routers/`. Auth dependency sourced from the massu introspector's `detected.python.auth_dep` (falls back to `get_current_user` if not detected).
@@ -4,6 +4,8 @@ description: "When user wants to create a new FastAPI router, API endpoint, or b
4
4
  allowed-tools: Bash(*), Read(*), Write(*), Edit(*), Grep(*), Glob(*)
5
5
  ---
6
6
 
7
+ > **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding — including **THE VERIFICATION LAWS** (CR-64: a gate must prove it can fail; CR-65: broken and empty may never render identically; an audit that does not run commands is not an audit).
8
+
7
9
  # Scaffold New FastAPI Router
8
10
 
9
11
  Creates a complete FastAPI router following the project's existing conventions in `${paths.python_source}/routers/` (or wherever your project's `paths.python_source` resolves).