Back to Plate

{{TITLE}}

docs/plans/templates/major-task.md

53.0.67.1 KB
Original Source

{{TITLE}}

Objective: TODO: Write the exact active major-task objective after creating this file.

Goal plan: {{PLAN_PATH}}

Template: {{TEMPLATE_PATH}}

Major source:

  • type: pending
  • id / link: pending
  • title: pending
  • decision to make: pending
  • decision criteria: pending

Major lane:

  • lane: pending
  • output type: pending
  • implementation expected: pending
  • affected packages / surfaces: pending
  • dominant risk: pending

Completion threshold:

  • TODO: Define the exact decision, proposal, benchmark, architecture, or migration done state.
  • Major-task closure is legal only when the decision criteria are satisfied or explicitly narrowed, facts/inference/recommendation are separated, required review or pressure passes are recorded, implementation gates are closed when code changed, and node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}} passes.

Verification surface:

  • TODO: Name the repo audit, benchmark, external-source audit, review pass, prototype, command, or plan artifact proving the threshold.

Constraints:

  • Start from repo evidence before external claims.
  • Keep helper stack proportional.
  • Separate measured evidence, source evidence, inference, and recommendation.
  • Do not execute implementation unless this major goal explicitly includes it.

Boundaries:

  • Source of truth: TODO.
  • Allowed edit scope: TODO.
  • External sources: TODO.
  • Browser surface: TODO.
  • Tracker sync: TODO.
  • Non-goals: TODO.

Blocked condition:

  • TODO: Name the missing source, benchmark, access, design decision, external evidence, or user judgment that stops autonomous major-task work.

Major state:

  • task_type: major
  • task_complexity: major
  • current_phase: intake
  • current_phase_status: in_progress
  • next_phase: research / analysis
  • goal_status: active

Current verdict:

  • verdict: pending
  • confidence: pending
  • next owner: major-task
  • reason: pending

Completion rule:

  • Do not call update_goal(status: complete) while any required checklist item remains unchecked. If an item does not apply, check it and add N/A: <reason>.
  • Do not call 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.
  • Do not create hook state for this goal. This file plus the active goal are the durable state.

Start Gates:

GateAppliesEvidence
major-task loadedpendingpending
Active goal checked or createdpendingpending
Source of truth read before analysispendingpending
Major lane selectedpendingpending
Decision criteria statedpendingpending
Existing repo patterns / prior decisions checkedpendingpending
Helper stack selectedpendingpending
External research decision recordedpendingpending
Implementation expectation recordedpendingpending
Workspace authority selectedpendingpending
Branch / PR expectation decidedpendingpending

Work Checklist:

  • Objective includes outcome, completion threshold, verification surface, constraints, boundaries, and blocked condition.
  • Major source records source type, id/link, title, decision type, expected outcome, decision criteria, likely files/packages/surfaces, browser surface, and highest-leverage owner.
  • Current state is mapped before proposing a new architecture, migration, benchmark, or plan.
  • Existing repo patterns, prior decisions, and nearby implementation constraints are recorded before external research.
  • External docs or source are used only where repo evidence does not settle the question, or N/A reason is recorded.
  • Options, recommendation, tradeoffs, blast radius, and rejection reasons are recorded.
  • Facts, inference, and recommendation are separated.
  • Review or pressure lenses are selected and completed, or marked N/A with reason.
  • If implementation happens, touched-surface packs cover docs, browser, package/API, or agent-native surfaces as needed.
  • Workspace authority recorded: every proof command names the cwd/tool that owns the analyzed or changed behavior.
  • Accepted/actionable review findings are fixed or explicitly rejected with evidence.

Completion Gates:

GateAppliesRequired actionEvidence
Named verification thresholdpendingRun the repo audit, benchmark, review, prototype, or artifact check named in this planpending
Current-state source auditpendingMap current owner, boundaries, constraints, and affected surfacespending
Decision criteria closurependingMark each criterion satisfied, narrowed, rejected, or blocked with evidencepending
Options / tradeoffs / rejection recordpendingRecord viable options, chosen recommendation, and why alternatives losepending
Review / pressure passpendingRun selected reviewer/lens or record N/A with reasonpending
Review findings closurependingFix or explicitly reject accepted/actionable findings and record closure proofpending
External-source auditpendingCite official/local clone/external sources when used, or record N/Apending
Implementation gatespendingIf code changed, close primary-template and touched-surface gates; otherwise N/Apending
Final handoff contractpendingRecord recommendation, evidence, caveats, residual risk, and next ownerpending
Final lintpendingRun pnpm lint:fix or scoped equivalent when files changedpending
Goal plan completeyesRun node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}}pending

Phase / pass table:

PhaseStatusEvidenceNext
Intake and source readin_progresscreated planresearch / analysis
Current-state mappendingoptions
Options and recommendationpendingreview
Review / pressure passpendingimplementation decision
Implementation or plan artifactpendingverification
Verificationpendingcloseout
Closeoutpendingfinal response

Findings:

  • None yet.

Decisions and tradeoffs:

  • None yet.

Implementation notes:

  • None yet.

Review fixes:

  • None yet.

Error attempts:

Error / failed attemptCountNext different moveResolution
None yet0

Verification evidence:

  • Pending.

Final handoff contract:

  • Recommendation: pending
  • Confidence: pending
  • Evidence: pending
  • Tests / commands: pending
  • Browser proof: pending
  • PR / tracker: pending
  • Caveats: pending
  • Next owner: pending

Timeline:

  • {{CREATED_AT}} Major-task goal plan created.

Reboot status:

QuestionAnswer
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:

  • Pending.