template
Milestone review
Review one app milestone against its intended change, evidence, diff, risks, and next decision.
- Project:
- PRD version/commit:
- Milestone:
- Implementation commit:
- Reviewer/date:
Intended change
What was this milestone supposed to make observable?
Diff
- Files added:
- Files changed:
- Dependencies added:
- Configuration or external state changed:
- Database changes:
Evidence
| Check | Evidence | Result |
|---|---|---|
| Build/check | ||
| Automated test | ||
| Browser path | ||
| Permission boundary | ||
| Human acceptance |
Review questions
- ☐ The change traces to the approved PRD.
- ☐ No hidden product decision was delegated to the agent.
- ☐ Secrets and private data are absent from the diff.
- ☐ Direct privileged queries authenticate and scope by owner.
- ☐ Failure behavior is useful and does not reveal sensitive detail.
- ☐ The rollback point is known.
Decision
- Approve / revise / rollback:
- Reason:
- Next milestone:
- New work recorded for later: