Reviews · Code review for agentic diffs

Review any diff.

Turn any diff into a structured review packet, optimized for agentic workflows. Install the CLI and skills to start iterating immediately.

curl -fsSL https://raw.githubusercontent.com/figitaki/reviews/main/install.sh | sh

0001 / Push

A packet, not a wall of edits.

Every line of the diff sits inside an authored section. The CLI refuses to push otherwise.

0002 / Review

Drop a comment, deny what needs work, approve what doesn't. Inline, in place.

0003 / Re-prompt

Ask the agent to fix the denied section, then push the next patchset back into the same review.

0004 / Approve

The denied section is resolved, approvals carry forward, and the packet lands clean.

figitaki/reviews/structured-markdown-packets v1

Review packet

32 files / +3754 −191 +412 −47 / ~2 hr

Deep +286−17 ~13 min

Persisted contract — canonical JSON on patchsets, compact metadata, read-side helpers.

M lib/reviews/packets.ex · hunk 2 of 4 · L 138–156

+18−4

@@ -138,7 +138,12 @@ defp build_packet(patchset) do

138138 sections = parse_sections(packet)

139139 hunks = collect_hunks(patchset)

140validate!(sections, hunks)

140case validate(sections, hunks) do

141 :ok -> build(sections, hunks)

142 {:error, :missing} -> reject(:missing_hunks)

143 {:error, :duplicate} -> reject(:duplicate_hunks)

144end

M @maintainer on packets.ex:142

What happens when a patchset drops files entirely? :missing reads as "needs hunks" — but here it's the opposite case.

141145 {:ok, packet}

142146end

Deep +734−32 ~25 min

Structured Markdown is parsed, validated for complete hunk coverage, and bundled before push.

Moderate +184−66 ~6 min

Section-level state carries across patchsets so reviewers don't re-read approved work.