AIDE/DOCS/COMMANDS//aide:fix — Fix Phase

/aide:fix — Fix Phase

Published
2026-10-26T10:01:31-07:00
Source commit
25c46bd
Cite as
https://aidemd.dev/docs/commands/aide/fix?v=25c46bd

Agent: This command is executed by the aide-implementor agent.

Work one unchecked item from the todo.aide checklist. This is the implementor phase in fix mode — the same agent that runs /aide:build, invoked with a narrower scope and a stricter one-session-per-item protocol. See todo.aide spec for the file format.

The fix loop is autonomous: the orchestrator triages the todo list and approves it itself; the user never reviews it. Items tagged plan-gap or strategy-gap reach you only after the architect has amended the plan, and spec-gap items go to the spec writer, not to you. If an item still needs a design decision the plan does not make, do not invent one — leave it unchecked and report it back.

Checklist

  • Read the todo list's status with aide_frontmatter (read mode). Start only if it reads status: approved; otherwise stop and report back without changing anything
  • Read the intent spec (.aide or intent.aide) in the target module
  • Read todo.aide and pick the next unchecked item. Do not pick ahead, do not bundle. Read the item's Misalignment tag to understand where intent was lost
  • Fix exactly ONE issue. Do not fix adjacent issues discovered during the session — add them to the todo.aide checklist instead, unchecked, for future sessions
  • Base the fix on the spec, not on the one-line issue description. The description points at the problem; the spec is the source of truth for what correct looks like
  • Run the generation command (or equivalent) to produce fresh output after the fix
  • Compare the new output against the baseline from before the fix:
    • Is the targeted issue resolved?
    • Did anything else regress? The fix may have moved unrelated output further from the spec
  • Run tests and the type checker to catch structural regressions
  • Check the item off in todo.aide only if both the targeted fix landed and no regression was introduced. Otherwise revert, leave the item unchecked, and end the session
  • Commit the fix in its own commit — one checkbox, one commit, one diff
  • End the session. The next item starts in a fresh session with clean context — do not continue working additional items in the same session
← prev
/aide:build — Build Phase
next →
/aide:handoff — Session Handoff