/aide:fix — Fix Phase
Published
Source commit
25c46bd
Cite as
Agent: This command is executed by the
aide-implementoragent.
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 readsstatus: approved; otherwise stop and report back without changing anything - Read the intent spec (
.aideorintent.aide) in the target module - Read
todo.aideand pick the next unchecked item. Do not pick ahead, do not bundle. Read the item'sMisalignmenttag to understand where intent was lost - Fix exactly ONE issue. Do not fix adjacent issues discovered during the session — add them to the
todo.aidechecklist 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.aideonly 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