docs/plans/2026-05-24-goal-workflow-docs-plans-consolidation.md
Objective: Update Plate goal workflow so durable goal scratchpads live under docs/plans as comprehensive single-file plans, remove .tmp goal scratchpad guidance, avoid hooks, avoid optional completion-check fallback state, and replace goal workflow ownership references where needed
Completion threshold:
Verification surface:
Constraints:
Boundaries:
Blocked condition:
Completion rule:
update_goal(status: complete) while any required checklist item
remains unchecked. If an item does not apply, check it and add N/A: <reason>.active goal state for this goal. This
file plus the active goal are the durable state.Required checklist:
get_goal checked; create_goal called only when no active goal existed,
or the active matching goal was recorded.learnings-researcher / docs/solutions checked, or marked N/A with
reason.docs/plans goal plan created before substantive edits.check run before PR create/update, or marked N/A with reason. N/A:
no PR requested.ce-compound evaluated after non-trivial verified work. N/A: the reusable
learning is encoded directly into the source rules/template/script.Phase / pass table:
| Phase | Status | Evidence | Next |
|---|---|---|---|
| Intake and source read | complete | read goal, planning fork, AGENTS, task/major/status, memory hits | patch workflow |
| Implementation | complete | patched goal template/script/rules and task/major/status rules | verify |
| Verification | complete | pnpm install, node --check, helper smoke, rg sweep, lint | closeout |
| Closeout | in_progress | checklist complete | final response |
Findings:
task_plan.md, findings.md, and
progress.md, later adding .planning/<slug>/ for isolation.docs/plans.active goal state state for this
goal workflow.Decisions and tradeoffs:
docs/plans instead of keeping a separate docs/goals or .planning tree..tmp out of goal workflow state entirely; use the active goal and
docs/plans file as the durable state.Error attempts:
| Error / failed attempt | Count | Next different move | Resolution |
|---|---|---|---|
| None yet | 0 |
External/browser findings:
Timeline:
docs/plans files.pnpm install; skiller synced generated AGENTS and
goal skill output.docs/plans file. Removed
the temporary smoke plan after confirming content.Verification evidence:
pnpm install -> pass; skiller apply completed.node --check .agents/rules/goal/scripts/create-goal-scratchpad.mjs -> pass.node .agents/rules/goal/scripts/create-goal-scratchpad.mjs ... --slug smoke-goal-docs-plans --force
-> pass; wrote docs/plans/2026-05-24-smoke-goal-docs-plans.md.sed -n '1,90p' docs/plans/2026-05-24-smoke-goal-docs-plans.md -> pass;
confirmed comprehensive checklist and docs/plans path.rg -n "goal workflow|task_plan\\.md|findings\\.md|progress\\.md|\\.planning|\\.tmp/goals|docs/goals|completion-check|scratch log" ...
-> only intentional negative guidance and historical "absorbs goal workflow"
wording remain in goal-owned surfaces.test ! -f docs/plans/2026-05-24-smoke-goal-docs-plans.md -> pass after
cleanup.find .tmp/goals -maxdepth 1 -type f -print -> no files.pnpm lint:fix -> pass; final run checked 3421 files with no fixes applied.Reboot status:
| Question | Answer |
|---|---|
| Where am I? | Closeout |
| Where am I going? | Final response |
| What is the goal? | Update Plate goal workflow so durable goal scratchpads live under docs/plans as comprehensive single-file plans, remove .tmp goal scratchpad guidance, avoid hooks, avoid optional completion-check fallback state, and replace goal workflow ownership references where needed |
| What have I learned? | See Findings |
| What have I done? | See Timeline |
Open risks: