Tracked iteration cycles for reducing failures. Number iterations sequentially, record state before/after, commit atomically per fix. Use when iteratively reducing test failures, fixing bugs in cycles, or any work requiring tracked progress across multiple attempts.
Use when: iteratively reducing failures, fixing bugs in cycles, any work requiring tracked progress across multiple attempts.
reports/
iteration-log.md # Running summary
iterations/
001/
start.json # State at iteration start
end.json # State at iteration end
analysis.md # What was attempted
clusters/ # If working on multiple fixes
cluster-a/
fix.md
verification.json
Number iterations sequentially: 001, 002, etc.
Critical rule: If failures increase from previous iteration, STOP and diagnose before proceeding.
start.jsonanalysis.mdend.jsoniteration-log.md{
"timestamp": "ISO8601",
"total": 100,
"pass": 85,
"fail": 15,
"skip": 0
}
# Iteration Log
## 001 - [date]
- Start: 15 failures
- Targets: [list]
- Result: 12 failures (-3)
- Commits: [hashes]
## 002 - [date]
- Start: 12 failures
- Targets: [list]
- Result: 14 failures (+2) WARNING REGRESSION
- Action: Reverted, investigating...
One atomic commit per fix, immediately after verification passes.
fix(<component>): iteration {N} - <brief description>
Fixes: <what was wrong>
Tests: <what now passes>