| name | worklog-review |
| description | Review whether current changes follow the worklog-driven development rules. Use before commits or when checking worklog structure. |
Worklog review
Read:
docs/worklog-method.md
- relevant numbered current work documents directly under
.worklog/
- current git diff
AGENTS.md
CLAUDE.md if present
Check:
- Does this change require a work document?
- If yes, does the document exist?
- Is the type correct:
spec, adr, or spike?
- Is the numeric sequence correct across
.worklog/ and .worklog/archive/?
- Are current work documents stored directly under
.worklog/?
- Are archived work documents stored under
.worklog/archive/?
- Do work document filenames avoid old lifecycle markers?
- Does
.worklog/INDEX.md exist and reflect the current numbered documents?
- Does the document have clear Goal, Context, and done criteria?
- For specs, are scope and non-goals present?
- For specs and ADRs, if
Outcome exists, does it add durable engineering context instead of task status?
- For spikes, are
Result and Recommendation present and meaningful?
- Are archived documents excluded from current requirements unless referenced through
Replaces or explicitly needed for history?
- If an old requirement or ADR changed, was the old document moved to
.worklog/archive/ and the new current document given Replaces:?
- Are accepted ADRs and old requirements left semantically immutable?
- Are micro-changes and product-neutral small changes kept out of
.worklog/ and left to commit messages?
Legacy migration check:
Flag files matching:
.worklog/*.active.md
.worklog/*.retired.md
.worklog/archive/*.active.md
.worklog/archive/*.retired.md
These should be renamed to the new lifecycle-free format.
Output:
OK if the structure is fine.
- Otherwise list concrete fixes.
- Do not modify files unless the user asks.