Plan-Diff Review
Plan-Diff Review checks what the agent actually changed against the plan you approved. After a run, a review card lists which plan steps were done, which are missing, and which changed files were never part of the plan, so scope creep and skipped steps don't slip through.
Turn it on
- Open Settings › Tools › Game changers.
- Turn on Plan-Diff Review.
| Setting | Default | Effect |
|---|---|---|
ingot.agent.planReview.enabled | off | save approved plans and review each run against them |
ingot.agent.planReview.templates | on | learn plan templates per kind of task |
Use it
- Switch the chat to Plan mode and describe the task.
- Read the plan the agent writes. Edit steps if you need to.
- Click Approve plan. The plan is saved to
.ingot/plans/. - Let the agent build it, in Agent mode as usual.
- When the run ends, the review card appears under the last reply:
Checked against plan: Fix cart total for discounts and tax
Matched (3)
✓ Default missing discounts to 0 src/cart/total.ts
✓ Round tax per line src/cart/tax.ts
✓ Add tests for empty discounts src/cart/total.test.ts
Missing (1)
✗ Update the CHANGELOG
Out of scope (1)
! src/ui/Button.tsx not in the plan
| Section | Meaning |
|---|---|
| Matched | plan steps with matching changes in the diff |
| Missing | plan steps with no matching change |
| Out of scope | changed files that no plan step mentions |
From the card you can:
- click a file to open its diff
- choose Finish missing steps to send the missing steps back to the agent
- choose Revert on an out-of-scope file to undo just that file
- choose Add to plan to accept an out-of-scope change as part of the plan
If you haven't approved a plan in the chat, there is nothing to compare and no card is shown.
The files: .ingot/plans/
Each approved plan is a Markdown file, such as .ingot/plans/2026-10-31-cart-total.md:
---
title: Fix cart total for discounts and tax
type: bug-fix
approved: 2026-10-31T14:02
---
1. Default missing discounts to 0
- src/cart/total.ts
2. Round tax per line
- src/cart/tax.ts
3. Add tests for empty discounts
- src/cart/total.test.ts
4. Update the CHANGELOG
- CHANGELOG.md
| Part | Meaning |
|---|---|
title | what the plan is for |
type | the kind of task (bug-fix, feature, refactor, upgrade, …); used for templates |
approved | when you approved it |
| numbered steps | the plan; the file list under a step tells the review where to look |
Commit the folder if your team reviews plans together. Other features read it too: Fresh-Context Auto-Handoff puts the plan and its progress in the brief.
Plan templates become habits
When you approve several plans for the same kind of task, Ingot learns the steps you always include (for example add a failing test first for bug fixes, or update the CHANGELOG for features). The next time you plan that kind of task, the agent starts from your template. Templates are saved with your habits:
Saved to HabitsSilver notes
| Note | When |
|---|---|
| Checked against plan | a run's changes were compared with the approved plan |
| Saved to Habits | a plan template was learned for a kind of task |