Back to Plate

{{TITLE}}

docs/plans/templates/goal-repair.md

53.0.65.3 KB
Original Source

{{TITLE}}

Objective: TODO: Repair the owning goal-backed rule/template/helper so this expectation is handled correctly on future runs.

Goal plan: {{PLAN_PATH}}

Template: docs/plans/templates/goal-repair.md

Expectation:

  • user expectation: TODO
  • observed miss: TODO
  • owning skill/template/helper: TODO
  • repair classification: pending

Completion threshold:

  • TODO: Name the exact repaired behavior.
  • Repair closure is legal only when the source owner is patched, generated skills are synced when .agents/rules/** changed, a source audit proves the repair text exists, the repaired template or rule is smoke-checked, deliberate non-repairs are recorded, and node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}} passes.

Verification surface:

  • TODO: Name the source audit, generated skill sync, smoke plan/checker proof, helper test, or other evidence that proves the repair.

Constraints:

  • Repair one expectation narrowly.
  • Patch source-of-truth files, not generated skill mirrors.
  • Do not weaken evidence safety or completion gates just to reduce annoyance.
  • Do not broaden the repair to unrelated skills/templates.

Boundaries:

  • Source of truth: latest autogoal repair <expectation> request.
  • Allowed edit scope: TODO.
  • Derived skill scope: TODO.
  • Non-goals: TODO.

Blocked condition:

  • TODO: Name the missing plan path, skill owner, expected behavior, or user decision that stops autonomous repair.

Repair state:

  • repair_type: pending
  • current_phase: intake
  • current_phase_status: in_progress
  • next_phase: target selection
  • goal_status: active

Current verdict:

  • verdict: pending
  • confidence: pending
  • next owner: autogoal repair
  • 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 repair evidence is recorded, and node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}} passes.
  • Do not create hook state for this repair. This file plus the active goal are the durable state.

Start Gates:

GateAppliesEvidence
Expectation restatedpendingpending
Active goal checkedpendingpending
Named plan or skill readpendingpending
Owning source selectedpendingpending
Repair classification selectedpendingpending
Safety conflict checkedpendingpending

Work Checklist:

  • Expectation and observed miss are stated with source evidence.
  • Primary owner selected: runtime plan, template, skill rule, or helper/checker.
  • Secondary owners are justified or marked N/A.
  • Patch touches source-of-truth files only.
  • Derived skill vs generic autogoal ownership decision is recorded.
  • Deliberate non-repairs are recorded.
  • Final response shape is recorded.

Completion Gates:

GateAppliesRequired actionEvidence
Source owner patchedpendingPatch the selected source owner or record runtime-plan-only repairpending
Generated skill syncpendingIf .agents/rules/** changed, run pnpm install and verify generated SKILL.md syncpending
Template smokependingInstantiate the repaired template or inspect it directly when a smoke plan would create noisepending
Incomplete-plan guardpendingVerify an unfinished generated plan still fails check-complete.mjs, or record N/A with reasonpending
Completed-plan representabilitypendingVerify the repaired expectation can be recorded in a completed plan without editing the template again, or record N/Apending
Helper/checker testspendingIf scripts changed, run focused script tests; otherwise N/Apending
Autoreview / reviewpendingRun applicable review gate or record N/A for docs-only/source-rule-only repairpending
Final lintpendingRun scoped formatter/lint or record ignored-path/N/A reasonpending
Goal plan completeyesRun node .agents/rules/autogoal/scripts/check-complete.mjs {{PLAN_PATH}}pending

Phase / pass table:

PhaseStatusEvidenceNext
Intakein_progresscreated repair plantarget selection
Target selectionpendingpatch
Patchpendingverification
Verificationpendingcloseout
Closeoutpendingfinal response

Findings:

  • None yet.

Decisions and tradeoffs:

  • None yet.

Repair patch notes:

  • None yet.

Deliberate non-repairs:

  • None yet.

Error attempts:

Error / failed attemptCountNext different moveResolution
None yet0

Verification evidence:

  • Pending.

Final repair handoff:

  • Expectation: pending
  • Repaired owner: pending
  • Files changed: pending
  • Verification: pending
  • Caveat: pending

Timeline:

  • {{CREATED_AT}} Goal repair plan created.

Reboot status:

QuestionAnswer
Where am I?Intake
Where am I going?Target selection, patch, 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.