prepare-for-review
Installation
SKILL.md
Prepare for Review
Author-side companion to review. Moves rationale from where it was captured (breadcrumbs, ADRs, the spec) into where reviewers look (PR body, inline comments). Does not generate rationale — empty sources produce omitted sections.
Requires docs/agents/ticket-tracker.md and docs/agents/decisions-breadcrumb.md. Run /setup-formsg-ai-skills if missing.
Workflow
-
Pin the fixed point — use user-supplied ref, else
main. Capturegit diff <fixed-point>...HEADandgit log <fixed-point>..HEAD --oneline. -
Collect rationale sources
- Breadcrumbs:
.scratch/<feature>/decisions.md(optional) - ADRs:
docs/adr/files touching paths in the diff - Spec/ticket: from commit message refs via
docs/agents/ticket-tracker.md, else.scratch/<feature>/SPEC.md. Ask user if absent.
- Breadcrumbs:
-
Assemble PR body — follow TEMPLATE.md. Omit any sub-section whose source is empty.
-
Screenshots (frontend only) — if diff touches frontend files, follow SCREENSHOTS.md.