Jon Aquino's Mental Garden

Engineering beautiful software jon aquino labs | personal blog

Sunday, February 08, 2026

Comic Code Reviews, Part 2

My first attempt at generating comic strips for PRs got mixed reactions on Hacker News. Fair criticism: the multi-panel comics were hard to follow and sometimes misleading.

New approach: generate a single-panel The Far Side-style comic instead. Less to absorb. You glance at it and immediately get the gist of the PR.

Here's the improved comic for React #13968 -- the initial hooks implementation:

Much easier to take in than a multi-panel strip.

The workflow:

  1. Paste this prompt into Claude Code (or your favorite coding LLM) — it generates a comic description and saves it to a file:
    1. Plan a 1-panel The Far Side-like comic strip to help code reviewers to understand what is going on in this PR/how the code works. Anthropomorphize if that will help. Use humor if appropriate. Save the results to ~/Documents/AI_Comics/2026-02-08-[omnom][claude-code]-a-brief-description.md. Put the name of the current repo in square brackets, like [omnom]. Put your name as a tool in square brackets, like [claude-code] or [cursor-agent] or [cursor]. Replace a-brief-description with a 3-4 word description. Copy the contents of the file to the clipboard (use wl-copy on Linux).  At the top of the file, put "make a 1-panel The Far Side-like comic-strip jpg for this:" as I am going to feed it into an LLM.
  2. Paste the result into Google Gemini to get the image.
  3. Paste the comic strip image at the top of your PR.

The key insight is that one panel works better than a whole comic strip. There's a single scene to parse, not a narrative sequence. It's a visual summary, not a visual explanation.

0 Comments:

Post a Comment

<< Home