bead review

ddx bead review

Generate a review prompt for a bead’s implementation

Synopsis

Generate a review-ready prompt for a bead implementation.

The prompt includes:

• Bead title, description, and acceptance criteria
• Full content of governing documents (spec-id refs from the bead)
• Git diff of the reviewed commit (git show)
• Review instructions with the expected APPROVE/REQUEST_CHANGES/BLOCK output contract

By default the commit is taken from the bead’s closing_commit_sha field. Use –from-rev to override.

Pipe the output into ddx run:

ddx bead review | ddx run –prompt @- ddx bead review –output /tmp/review.md && ddx run –prompt /tmp/review.md

ddx bead review <id> [flags]

Options

      --from-rev string   Commit SHA to review (default: closing_commit_sha from bead)
  -h, --help              help for review
      --iter int          Review iteration number (shown in prompt header and grade table) (default 1)
      --output string     Write prompt to file instead of stdout

Options inherited from parent commands

      --config string              config file (default is $HOME/.ddx.yml)
      --library-base-path string   override path for DDx library location
  -v, --verbose                    verbose output

SEE ALSO

• ddx bead - Manage beads (portable work items)

Auto generated by spf13/cobra on 21-Apr-2026