Skip to content

docs: add Huntley testimonial card and agentic loop diagram to README - #49

Closed
amrynsky wants to merge 1 commit into
mainfrom
docs/readme-testimonial-loop-diagram
Closed

docs: add Huntley testimonial card and agentic loop diagram to README#49
amrynsky wants to merge 1 commit into
mainfrom
docs/readme-testimonial-loop-diagram

Conversation

@amrynsky

Copy link
Copy Markdown
Contributor

What changed

Two above-the-fold graphics added to the main README to strengthen the landing page and improve star conversion:

  • Geoffrey Huntley testimonial card — the existing quote is now a two-column card with his avatar beside it (name + "creator of Ralph Wiggum" underneath). Puts a face on the social proof.
  • Agentic loop diagram — a compact REASON → ACT → OBSERVE mermaid flowchart (handDrawn/neutral, matching repo convention) placed right after the quote, so it visually answers his "show me the inferencing loop" line. Caption links into 01-foundations.

Why

The repo is getting real traffic right now. These are the two highest-leverage above-the-fold conversion levers: social proof (a face on the quote) and a concept diagram of the core loop the tutorials teach.

New asset

common/images/ghuntley.png — 460×460 circular avatar with an anti-aliased alpha mask. Committed pre-rounded because GitHub strips CSS border-radius from README HTML, so the circle has to be baked into the file. (~280 KB; passes the pre-commit large-file check.)

Reviewer notes

  • The HTML table and the mermaid block only render on GitHub itself — local markdown preview won't show them. View the rendered README to check.
  • Avatar is referenced as a local file (not a hotlink to github.com/ghuntley.png) so the README is self-contained and the rounded image renders.
  • The quote was already in the README, publicly sourced (the linked YouTube clip) and attributed; this just adds his public avatar beside it.

🤖 Generated with Claude Code

Strengthen the landing page (and star conversion) with two above-the-fold
graphics in the main README:

- Convert the Geoffrey Huntley quote into a two-column testimonial card
  with his avatar beside it (name + "creator of Ralph Wiggum" underneath).
- Add a compact REASON -> ACT -> OBSERVE mermaid loop (handDrawn/neutral,
  per repo convention) right after the quote so it answers his "show me the
  inferencing loop" line; caption links into 01-foundations.

common/images/ghuntley.png is committed pre-rounded (anti-aliased circular
alpha mask) because GitHub strips CSS border-radius from README HTML, so the
circle has to be baked into the PNG.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@amrynsky amrynsky closed this Jun 25, 2026
@amrynsky
amrynsky deleted the docs/readme-testimonial-loop-diagram branch June 25, 2026 07:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant