docs/plans/templates/major-task.md
Objective: TODO: Write the exact active major-task objective after creating this file.
Goal plan: {{PLAN_PATH}}
Template: {{TEMPLATE_PATH}}
Major source:
Major lane:
Completion threshold:
node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}}
passes.Verification surface:
Constraints:
Boundaries:
Blocked condition:
Major state:
Current verdict:
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>.update_goal(status: complete) until every completion threshold
above is satisfied, final evidence is recorded, and
node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}}
passes.Start Gates:
| Gate | Applies | Evidence |
|---|---|---|
major-task loaded | pending | pending |
| Active goal checked or created | pending | pending |
| Source of truth read before analysis | pending | pending |
| Major lane selected | pending | pending |
| Decision criteria stated | pending | pending |
| Existing repo patterns / prior decisions checked | pending | pending |
| Helper stack selected | pending | pending |
| External research decision recorded | pending | pending |
| Implementation expectation recorded | pending | pending |
| Workspace authority selected | pending | pending |
| Branch / PR expectation decided | pending | pending |
Work Checklist:
Completion Gates:
| Gate | Applies | Required action | Evidence |
|---|---|---|---|
| Named verification threshold | pending | Run the repo audit, benchmark, review, prototype, or artifact check named in this plan | pending |
| Current-state source audit | pending | Map current owner, boundaries, constraints, and affected surfaces | pending |
| Decision criteria closure | pending | Mark each criterion satisfied, narrowed, rejected, or blocked with evidence | pending |
| Options / tradeoffs / rejection record | pending | Record viable options, chosen recommendation, and why alternatives lose | pending |
| Review / pressure pass | pending | Run selected reviewer/lens or record N/A with reason | pending |
| Review findings closure | pending | Fix or explicitly reject accepted/actionable findings and record closure proof | pending |
| External-source audit | pending | Cite official/local clone/external sources when used, or record N/A | pending |
| Implementation gates | pending | If code changed, close primary-template and touched-surface gates; otherwise N/A | pending |
| Final handoff contract | pending | Record recommendation, evidence, caveats, residual risk, and next owner | pending |
| Final lint | pending | Run pnpm lint:fix or scoped equivalent when files changed | pending |
| Goal plan complete | yes | Run node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}} | pending |
Phase / pass table:
| Phase | Status | Evidence | Next |
|---|---|---|---|
| Intake and source read | in_progress | created plan | research / analysis |
| Current-state map | pending | options | |
| Options and recommendation | pending | review | |
| Review / pressure pass | pending | implementation decision | |
| Implementation or plan artifact | pending | verification | |
| Verification | pending | closeout | |
| Closeout | pending | final response |
Findings:
Decisions and tradeoffs:
Implementation notes:
Review fixes:
Error attempts:
| Error / failed attempt | Count | Next different move | Resolution |
|---|---|---|---|
| None yet | 0 |
Verification evidence:
Final handoff contract:
Timeline:
Reboot status:
| Question | Answer |
|---|---|
| Where am I? | Intake and source read |
| Where am I going? | Research / analysis, options, review, verification, closeout |
| What is the goal? | TODO: Fill from Objective |
| What have I learned? | See Findings |
| What have I done? | See Timeline |
Open risks: