Some New Feature — Implementation
Captures what was actually built. Notes here lag the code by minutes, not days — write as you go, not after.
Files added
path/to/new-file.ext— what it doespath/to/another.ext— what it does
Files touched
path/to/existing.ext— what changed and why
Verification
How you confirmed it works. Lean on a small smoke-test table:
| Scenario | Expected | Actual |
|---|---|---|
| Golden path | … | ✓ |
| Edge case A | … | ✓ |
| Regression check | unchanged | ✓ |
Design rationale
Brief notes on choices that aren't obvious from the diff. The plan said what to build; this section captures why this shape in code.
Deferred
Anything you intentionally didn't do, with a one-line reason. The next person reading this should know what's complete and what's still on the table.