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:
- Paste this prompt into Claude Code (or your favorite coding LLM) — it generates a comic description and saves it to a file:
- 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.
- Paste the result into Google Gemini to get the image.
- 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