Overview
Plan-then-ship loop that leaves a documented trail: goal.md (what, phase status), phase.md (brief), task files (tickets with rules, status, findings). The main session plans the goal and holds only one-line handoffs; each phase is planned and implemented in one fresh subagent context.
plan goal.md (main session, once) → phase-deliverer: plan phase → implement tasks → commit each
↑________________ findings ________________|
Out of scope: inventing a goal, researching missing goal detail.
Setup
| Item | Required | When | How |
|---|---|---|---|
Delivery agent phase-deliverer |
required | Deliver loop, when the harness supports subagents | creating-delivery-agents.md |
Agent workflow
Follow this skill when the user names it, or references a file under a marked goals root, for goal folders under <goals-root>/<NN>-<slug>/. Resolve every required Setup row before opening a recipe. Match one Recipes row; open exactly that reference.
Recipes
| Intent | Example phrasing | Read |
|---|---|---|
| Plan goal only | "Plan this goal", "Create goal.md for …" | planning-goal.md |
| Deliver or continue | "Deliver this goal", "Ship until done", "Continue @goals/01-mvp/goal.md" | delivering-goal.md |
| Deliver one phase | "Deliver the next phase only" | delivering-phase.md |
| Create delivery agent | "creating-delivery-agents", refresh the agent | creating-delivery-agents.md |
Reference index
Contract
goal-contract.md — signatures, layout, goals root, living goal.md, clear-goal gate, governing skills and method, phase sizing, task rules, handoffs, agent roots.
| Doc | When to use |
|---|---|
| goal-contract.md | Shared rules every recipe cites |
| planning-goal.md | Seed goal.md and pin the method |
| delivering-goal.md | Main loop: one phase-deliverer per phase |
| delivering-phase.md | Resume or plan a phase, write tasks, implement, commit |
| creating-delivery-agents.md | Write phase-deliverer |