PR Walkthrough

Use this skill when the user needs PR walkthrough docs that turn an informal workflow into something reviewable, teachable, and easier to execute consistently.

Start By Clarifying

• Who participates in the process and where responsibilities change hands.
• What the entry criteria, checkpoints, and exit criteria should be.
• Which decisions require sign-off, escalation, or documented rationale.
• What artifacts, links, or evidence should exist at each stage.
• How the process should stay lightweight enough to be followed in practice.

Workflow

1. Define the objective of the process and the scenarios it is meant to cover.
2. Map the stages, decision points, owners, and required artifacts.
3. Make review gates, success criteria, and escalation rules explicit.
4. Add examples, templates, or checklists where teams commonly drift.
5. Document how the process is maintained when the system or team changes.

Good Output

• Process outline with roles, sequence, and decision gates.
• Required artifacts, examples, or checklists.
• Open questions or edge cases that need policy rather than improvisation.
• Maintenance notes so the process stays current.

Common Pitfalls

• Describing the ideal path but omitting ownership and exception handling.
• Adding heavy ceremony without clear value or decision support.
• Failing to show what done looks like at each stage.
• Letting the process drift from how teams actually work.

Boundaries

• Do not confuse process guidance with proof that the process is already being followed.
• Prefer concrete responsibilities and exit criteria over vague workflow prose.