| name | gdd-review-decisions |
| description | Surfaces the async decision-review queue for team mode. Reads .design/reviews/<decision-id>/ entries and reports each decision's state in the proposed → reviewing → approved → locked machine (via scripts/lib/collab/review-queue.cjs), so a team can see what's awaiting review, what's approved, and what's locked. --pending shows only decisions still needing action. Read-only - it reports the queue; it never advances a decision (that's a reviewer's explicit call). Use to run an async design-decision review without a meeting. |
| argument-hint | [<decision-id>] [--pending] |
| user-invocable | true |
| tools | Read, Bash, Grep, Glob |
/gdd:review-decisions
Closes the async-review gap for team mode: design decisions move through an explicit review queue
instead of being decided in a single operator's head. This skill reports where each decision is.
Read-only - it surfaces state; advancing a decision is a reviewer's explicit action. Contract:
../../reference/multi-author-model.md.
Invocation
| Command | Behavior |
|---|
/gdd:review-decisions | Every decision in the queue, grouped by state. |
/gdd:review-decisions <decision-id> | One decision's state + audit trail. |
/gdd:review-decisions --pending | Only decisions not yet locked (awaiting action). |
Steps
- Find the queue. List
.design/reviews/*/ (each dir is a <decision-id>). No reviews dir →
print review-decisions: no review queue yet (team mode not in use). and exit.
- Read each entry (
.design/reviews/<id>/state.json → { id, state, audit }). Validate the
state against scripts/lib/collab/review-queue.cjs STATES.
- Render grouped by state:
proposed / reviewing / approved / locked, each listing the
decision id + a one-line summary. For --pending, use review-queue.pending(entries) to show only
non-locked ones. For a single <decision-id>, also print its audit trail (transitions + approvers).
- Do not advance. Reporting only - moving a decision forward (or
/gdd:unlock-decision) is the
reviewer's explicit call.
Output
End with:
## REVIEW-DECISIONS COMPLETE
