johnalbertini14-glitch wreckit-ralph — Bulletproof AI Code Verification
Build it. Break it. Prove it works.
Philosophy
AI can't verify itself. Structure the pipeline so it can't silently agree with itself. Separate Builder/Tester/Breaker roles across fresh contexts. Use independent oracles.
Full 14-step framework:
references/verification-framework.md
Modes
Auto-detected from context:
| Mode | Trigger | Description |
|---|---|---|
| 🟢 BUILD | Empty repo + PRD | Full pipeline for greenfield |
| 🟡 REBUILD | Existing code + migration spec | BUILD + behavior capture + replay |
| 🔴 FIX | Existing code + bug report | Fix, verify, check regressions |
| 🔵 AUDIT | Existing code, no changes | Verify and report only |
Gates
Read the gate file before executing it. Each contains: question, checks, pass/fail criteria.
| Gate | BUILD | REBUILD | FIX | AUDIT | File |
|---|---|---|---|---|---|
| AI Slop Scan | ✅ | ✅ | ✅ | ✅ | references/gates/slop-scan.md |
| Type Check | ✅ | ✅ | ✅ | ✅ | references/gates/type-check.md |
| Ralph Loop | ✅ | ✅ | ✅ | ❌ | references/gates/ralph-loop.md |
| Test Quality | ✅ | ✅ | ✅ | ✅ | references/gates/test-quality.md |
| Mutation Kill | ✅ | ✅ | ✅ | ✅ | references/gates/mutation-kill.md |
| Cross-Verify | ✅ | ❌ | ❌ | ❌ | references/gates/cross-verify.md |
| Behavior Capture | ❌ | ✅ | ❌ | ❌ | references/gates/behavior-capture.md |
| Regression | ❌ | ✅ | ✅ | ❌ | references/gates/regression.md |
| SAST | ❌ | ❌ | ✅ | ✅ | references/gates/sast.md |
| LLM-as-Judge | opt | opt | opt | opt | references/gates/llm-judge.md |
| Proof Bundle | ✅ | ✅ | ✅ | ✅ | references/gates/proof-bundle.md |
Scripts
Deterministic helpers — run these, don't rewrite them:
scripts/detect-stack.sh [path]— auto-detect language, framework, test runner → JSONscripts/check-deps.sh [path]— verify all dependencies exist in registriesscripts/slop-scan.sh [path]— scan for placeholders, template artifacts, dead codescripts/mutation-test.sh [path] [test-cmd]— automated mutation testing (up to 20 mutations)scripts/coverage-stats.sh [path]— extract raw coverage numbers from test runner
Swarm Architecture
For multi-gate parallel execution, read references/swarm/orchestrator.md.
Quick overview:
Main agent → wreckit orchestrator (depth 1)
├─ Planning: Architect worker
├─ Building: Sequential Implementer workers
├─ Verification: Parallel gate workers
├─ Sequential: Cross-verify / regression / judge
└─ Decision: Proof bundle → Ship / Caution / Blocked
Critical: Read references/swarm/collect.md before spawning workers.
Never fabricate results. Wait for all workers to report back.
Worker output format: references/swarm/handoff.md.
Config required:
{ "agents.defaults.subagents": { "maxSpawnDepth": 2, "maxChildrenPerAgent": 8 } }
Decision Framework
| Verdict | Criteria |
|---|---|
| Ship ✅ | All gates pass, ≥95% mutation kill, zero slop |
| Caution ⚠️ | All pass but mutation kill 90-95%, or minor slop in non-critical |
| Blocked 🚫 | Any gate fails, hallucinated deps, <90% mutation kill |
Running an Audit (Single-Agent, No Swarm)
For small projects or when swarm isn't needed, run gates sequentially:
scripts/detect-stack.sh→ know your targetscripts/check-deps.sh→ verify deps are real (not hallucinated)scripts/slop-scan.sh→ find placeholders, template artifacts- Run type checker (from detect-stack output) →
references/gates/type-check.md - Run tests +
scripts/coverage-stats.sh→references/gates/test-quality.md scripts/mutation-test.sh→references/gates/mutation-kill.md- Read + execute
references/gates/sast.md - Read + execute
references/gates/proof-bundle.md→ write.wreckit/
Quick Start
"Use wreckit-ralph to audit [project]. Don't change anything."
"Use wreckit-ralph to build [project] from this PRD."
"Use wreckit-ralph to fix [bug]. Prove nothing else breaks."
"Use wreckit-ralph to rebuild [project] in [framework]."
Dashboard
assets/dashboard/ contains a local web dashboard for viewing proof bundles across repos.
Run: node assets/dashboard/server.mjs (port 3939). Reads .wreckit/dashboard.json from projects.