@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.
- package/CHANGELOG.md +70 -0
- package/agents/massu-architecture-reviewer.md +20 -0
- package/agents/massu-blast-radius-analyzer.md +20 -0
- package/agents/massu-competitive-scorer.md +20 -0
- package/agents/massu-help-sync.md +20 -0
- package/agents/massu-migration-writer.md +20 -0
- package/agents/massu-output-scorer.md +20 -0
- package/agents/massu-pattern-reviewer.md +20 -0
- package/agents/massu-plan-auditor.md +20 -0
- package/agents/massu-schema-sync-verifier.md +20 -0
- package/agents/massu-security-reviewer.md +20 -0
- package/agents/massu-ux-reviewer.md +20 -0
- package/commands/_shared-preamble.md +21 -0
- package/commands/_shared-references/auto-learning-protocol.md +2 -0
- package/commands/_shared-references/blast-radius-protocol.md +2 -0
- package/commands/_shared-references/security-pre-screen.md +2 -0
- package/commands/_shared-references/test-first-protocol.md +2 -0
- package/commands/_shared-references/verification-table.md +2 -0
- package/commands/_verification-laws.md +131 -0
- package/commands/_verification-laws.md.sha256 +1 -0
- package/commands/massu-data/references/common-queries.md +2 -0
- package/commands/massu-data/references/table-guide.md +2 -0
- package/commands/massu-data.md +2 -0
- package/commands/massu-debug/references/auto-learning.md +2 -0
- package/commands/massu-debug/references/codegraph-tracing.md +2 -0
- package/commands/massu-debug/references/common-shortcuts.md +2 -0
- package/commands/massu-debug/references/investigation-phases.md +2 -0
- package/commands/massu-debug/references/report-format.md +2 -0
- package/commands/massu-deploy.python-docker.md +2 -0
- package/commands/massu-deploy.python-fly.md +2 -0
- package/commands/massu-deploy.python-launchd.md +2 -0
- package/commands/massu-deploy.python-systemd.md +2 -0
- package/commands/massu-full-audit.md +2 -0
- package/commands/massu-golden-path/references/approval-points.md +2 -0
- package/commands/massu-golden-path/references/phase-0-requirements.md +2 -0
- package/commands/massu-golden-path/references/phase-1-plan-creation.md +2 -0
- package/commands/massu-golden-path/references/phase-2-implementation.md +2 -0
- package/commands/massu-golden-path/references/phase-2.5-gap-analyzer.md +2 -0
- package/commands/massu-golden-path/references/phase-3-simplify.md +2 -0
- package/commands/massu-golden-path/references/phase-3.5-security-audit.md +110 -0
- package/commands/massu-golden-path/references/phase-4-commit.md +2 -0
- package/commands/massu-golden-path/references/phase-5-push.md +2 -0
- package/commands/massu-golden-path/references/phase-5.5-production-verify.md +2 -0
- package/commands/massu-golden-path/references/phase-6-completion.md +2 -0
- package/commands/massu-golden-path/references/qa-evaluator-spec.md +2 -0
- package/commands/massu-golden-path/references/sprint-contract-protocol.md +2 -0
- package/commands/massu-golden-path/references/vr-visual-calibration.md +2 -0
- package/commands/massu-golden-path.md +30 -0
- package/commands/massu-guide.md +2 -0
- package/commands/massu-hooks.md +2 -0
- package/commands/massu-learning-audit.md +2 -0
- package/commands/massu-loop/references/auto-learning.md +2 -0
- package/commands/massu-loop/references/checkpoint-audit.md +2 -0
- package/commands/massu-loop/references/guardrails.md +2 -0
- package/commands/massu-loop/references/iteration-structure.md +2 -0
- package/commands/massu-loop/references/loop-controller.md +2 -0
- package/commands/massu-loop/references/plan-extraction.md +2 -0
- package/commands/massu-loop/references/vr-plan-spec.md +2 -0
- package/commands/massu-parity.md +2 -0
- package/commands/massu-push.md +2 -0
- package/commands/massu-scaffold-hook.md +2 -0
- package/commands/massu-scaffold-page.md +2 -0
- package/commands/massu-scaffold-page.swift.md +2 -0
- package/commands/massu-scaffold-router.md +2 -0
- package/commands/massu-scaffold-router.python-django.md +2 -0
- package/commands/massu-scaffold-router.python-fastapi.md +2 -0
- package/commands/massu-scaffold-router.python.md +2 -0
- package/dist/cli.js +69 -13
- package/package.json +4 -3
- package/patterns/build-patterns.md +2 -0
- package/patterns/component-patterns.md +2 -0
- package/patterns/display-patterns.md +2 -0
- package/patterns/form-patterns.md +2 -0
- package/patterns/integration-testing-checklist.md +2 -0
- package/patterns/security-patterns.md +2 -0
- package/patterns/testing-patterns.md +2 -0
- package/patterns/tool-routing.md +2 -0
- package/patterns/ui-patterns.md +2 -0
- package/protocols/plan-implementation.md +2 -0
- package/protocols/recovery.md +2 -0
- package/protocols/verification.md +2 -0
- package/reference/cr-rules-reference.md +2 -0
- package/reference/hook-execution-order.md +2 -0
- package/reference/lessons-learned.md +2 -0
- package/reference/patterns-quickref.md +2 -0
- package/reference/standards.md +2 -0
- package/reference/subagents-reference.md +2 -0
- 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 |
|
package/commands/massu-guide.md
CHANGED
|
@@ -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
|
package/commands/massu-hooks.md
CHANGED
|
@@ -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
|
package/commands/massu-parity.md
CHANGED
|
@@ -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
|
package/commands/massu-push.md
CHANGED
|
@@ -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).
|