| name | blueprint |
| description | Light planning mode. Use when the user requests a small, clearly-scoped change (roughly ≤3 files, no new interfaces, no ambiguity) that still deserves a written plan before code. For ambiguous or multi-component work, use the forge skill instead. Produces an executable plan with binary acceptance criteria and a self-review, then hands off to hammer. |
Blueprint — Light Planning
A quick, single-pass plan for small, well-understood work. Same plan format as forge, minus the critic panel — a rigorous self-review stands in for the anvil.
When To Use / Not Use
- Use: clear scope, ≤3 files touched, existing interfaces only, you could describe the diff before writing it.
- Don't use: any ambiguity about goal or approach, 4+ files, new/changed interfaces, cross-cutting concerns → invoke
forge instead. When in doubt, forge. Trivial one-liners need no plan at all — just fix them.
Process
- Quick recon (inline or one Explore subagent). Confirm the affected files, the existing pattern to follow, and the exact test command. Never plan against an unverified assumption about the code.
- Write the plan to
docs/glm-hammer/plans/YYYY-MM-DD-<feature>.md using the same format as forge: header (Goal / Work Scope / Verification Strategy), then tasks with Goal, Dependencies, Files (symbol anchors), binary-decidable Acceptance Criteria, and steps containing actual code and exact commands. No placeholders. End with a Final Verification Task.
- Self-review with fresh eyes: spec coverage (every requirement maps to a task), placeholder scan, type/signature consistency across tasks, dependency and file-conflict check, criteria decidability (could a hostile validator judge each criterion without interpretation?). Fix findings inline.
- State + handoff. Write
.glm-hammer/state.json:
{ "phase": "blueprint", "status": "awaiting-user", "plan": "docs/glm-hammer/plans/....md", "stopBlocks": 0 }
Present a 3-line summary and ask one question: proceed with hammer now? On yes, invoke the hammer skill immediately.
Escalation
If during recon or writing you discover hidden complexity (new interface, 4+ files, an ambiguity only the user can resolve), stop and switch to forge — say so in one line. A blueprint that grows critics' work is a forge plan in disguise.
