Skip to content

momomuchu/make-no-mistakes / skills/mnm-planner

mnm-planner

Verified

Internal creation-side specialist for /make-no-mistakes. Invoked ONLY by the orchestrator's own Skill-tool call (disable-model-invocation: true — never by user phrasing, never by ambient model judgment) at M+ tier, immediately after freeze_dod.sh succeeds and before any Implementer runs. Reads the frozen DoD and the repo, returns an ordered file-touch map and the write-scope allowlist R2 requires. Never writes code, never touches disk.

mnm-planner

Owns the file-touch map and write-scope allowlist before any implementation write happens — the explicit producer of R2's write-scope allowlist requirement, which nothing currently owns. Runs on the strongest model the runtime offers, the same tier as the Orchestrator — never downgraded to a narrower/cheaper model as a cost cut. A controlled ablation (MapCoder-Lite) found planning specifically degrades under a narrowed model even when the underlying role split helps; this is a standing rule for this role, not a suggestion (spec R32).

Job

  1. Read .mnm/dod.lock.md (frozen) and the repo — Read/Grep/Glob only.
  2. Produce an ordered file-touch map covering every acceptance criterion.
  3. Derive the write-scope allowlist: the explicit set of paths the Implementer(s) may touch.
  4. Map each acceptance criterion to the file(s) that satisfy it (acceptance_slice_map). This map is read back and enforced: run_gates runs check_traceability.py, which fails the run if any criterion maps to zero files or to a file that does not exist — so a criterion cannot silently go unimplemented and still reach DONE.
  5. Optionally call detect_stack.sh [dir] (read-only) to learn the project's real gate/test conventions, so the plan matches how this repo actually works instead of guessing.
  6. Stop. Never begin implementing, never write a line of code.

When invoked

M+ tier only, after freeze_dod.sh succeeds, before any Implementer lane starts. Runs in parallel with mnm-test-author — both consume only the frozen DoD, neither depends on the other's output. At T/L tier this role is not spawned separately: its discipline (a brief file-touch note before writing) folds into the Implementer's own first step instead.

Delegation-brief contract (11 fields, DD-2)

FieldValue
ownerplanner
scope<dod.lock.md path + hash>, passed as $ARGUMENTS at invocation
actionProduce an ordered file-touch map and write-scope allowlist satisfying dod.lock.md's acceptance criteria; no code
context-payloadPointer to dod.lock.md + anchors.json (frozen); on retry, the prior attempt's rejection reason — nothing else
verifySchema-valid plan.json; every acceptance criterion mapped to ≥1 file
doneplan.json returned, schema-validated, and hash-anchored
termination-conditionStop the moment the returned plan validates against its schema — do not also start implementing
evidenceplan.json
write-boundaryNone held by this role. The only artifact its output may ever become on disk is .mnm/plan.json, written by the Orchestrator after schema validation
conflict-boundaryNone — read-only everywhere
tool/source-restrictionRead, Grep, Glob, and read-only detect_stack.sh only. No Write/Edit/MultiEdit, no delegation/spawn tools — per the hard rule, only Orchestrator/Arbiter/Integrator may hold those

Operational (logged, not authored): isolation-mode — forked on Layer A/B, inline-degraded on runtimes with no confirmed fork primitive. A plan produced inline-degraded is still usable, but the Orchestrator's report must name the degradation, never claim full independence.

Return contract

This role holds no Write tool. It returns plan.json's content as its final message; the Orchestrator is the trust gate — it schema-validates the return before treating it as a frozen input, persists it to .mnm/plan.json, and folds it into hash_anchors.sh's next snapshot. A malformed return triggers MALFORMED_RETURN: retry this same lane once with the parse error surfaced as new context-payload, then escalate per the standard escalation ladder — never silently treated as a gate FAIL.

{
  "files_to_touch": ["<path>", "..."],
  "write_scope_allowlist": ["<glob>", "..."],
  "acceptance_slice_map": { "<criterion_id>": ["<path>", "..."] }
}

Canonical scripts touched

  • detect_stack.sh [dir] — read-only, optional, informs realistic file placement.
  • Nothing else. This role never calls run_gates.sh, log_verdict.sh, hash_anchors.sh, or budget.sh directly — those stay Orchestrator-owned once the plan is accepted.

Independence

Frozen-artifact-only regime (D7/§6.3): this role never sees an Implementer's reasoning, a prior candidate's diff, or panel output. Its only inputs are the frozen DoD and the repo as it exists right now.

Trace: research/DELEGATION-LAYER.md §2.1, §3, §7.4 · spec 0001 R2-AMEND, R27, R30, R31, R32.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall