Skip to main content

1) Install Ponzu GitHub App

Install Ponzu into your org or personal account and select target repositories.

2) Open a PR and request synthesis

In a pull request thread, mention:
@ponzu review
Ponzu will respond with a structured synthesis review.

3) Resolve blockers first

Use this order:
  1. Critical
  2. Risk spotlight
  3. Important files & hotspots
  4. Suggested fix prompt

4) Run the dogfood loop

After each major push:
  • request another @ponzu review
  • compare rounds-to-green and lead time
  • keep reviewer comments focused and actionable

5) Keep docs in lockstep

When behavior changes:
  • update docs in the same PR, or
  • include explicit docs: none rationale