Progress
Read-only. Edit no file, run no write command, start no work. Print the report, then stop.
1. Collect
Check real state. The conversation alone goes stale after compaction.
| Source | How |
|---|---|
| Conversation | goal, open questions and decisions, stop points the user named |
| Task list | todo items and their state |
| Working tree | git status --short, git log --oneline <default-branch>..HEAD |
| PR and CI | gh pr view --json number,url,state,mergeStateStatus,statusCheckRollup, only if a PR exists |
| Background work | running subagents, background shells, monitors |
Skip a source that does not apply. Cross-check: a todo marked done without its commit, push or green check is not done.
2. Sort
- Needs you: only the user can move it. A decision, a question, an approval, a secret, a manual step.
- Blocked: waits on something outside. CI, a review, a rate limit, another agent. Name what unblocks it.
- Now: the one item in progress.
- Next: open items, in order.
- Done: finished items. Mark steps that must not run twice:
(pushed),(migration ran),(PR opened).
3. Print
Use this shape. Omit an empty section, never print "none". Keep each section to about ten items: merge small steps, drop trivia and abandoned attempts.
**Needs you**
7. Short summary of the problem.
7.1 **recommended** option, the one reason that decides it
7.2 option, its tradeoff
9. Question in one line?
**Blocked**
- CI red on #42 `lint`, waits on the fix in Now
**Now**
- item, link
**Next**
- [ ] item
**Done**
- [x] item, link (pushed)
- A decision keeps the number it first got in the conversation. A new item takes the next free number. Numbering follows
.claude/rules/workflow-dialog.md. - One sub-item per option. Mark exactly one recommended, at the start of its sub-item.
- Link, never restate: PR, issue, commit, file path.
- No recap, no timeline, no narrative, no status colors.
- State unknown? Write "unknown" and the command that checks it. Never guess.