Skip to content

Add post on learning MCP with an LLM as reviewer - #116

Merged
ultimatecoder merged 2 commits into
masterfrom
master-transcript-mcp-experince
Sep 20, 2026
Merged

ultimatecoder merged 2 commits into
masterfrom
master-transcript-mcp-experince

Conversation

@ultimatecoder

Copy link
Copy Markdown
Owner

Adds I wrote the code and let an LLM review it — building the Transcript MCP server by hand while an LLM planned the work, reviewed each step, answered questions and tracked progress, without writing any code.

Formatting

Prompts and LLM output sit in collapsible <details> blocks. The prompt is open by default; the 260-line generated plan is collapsed so it does not dominate the post.

This uses kramdown's per-element markdown="1" rather than the global parse_block_html setting, so markdown parsing inside raw HTML is opted into here and nowhere else on the site.

Assets

The hero image ships as JPEG. As a photograph it needed 1.5 MB as PNG and still missed the 300 KB budget after scripts/optimize-images ran its full ladder (716 KB at the narrowest rung). JPEG holds 1600px at 220 KB.

Each of the four diagrams gets a lead-in sentence, descriptive alt text and a numbered caption.

Verification

  • ./scripts/test passes — HTML-Proofer clean across 42 files, 186 external and 80 internal links
  • ./scripts/optimize-images --check — all images within budget
  • Rendering checked in the browser at 1280px and at narrow widths; the collapsible blocks wrap rather than scroll horizontally

One fix was needed for the link checker: the quoted plan contains a literal <link> placeholder that kramdown was parsing as an HTML tag, so it is now in backticks.

🤖 Generated with Claude Code

Jaysinh Shukla and others added 2 commits September 20, 2026 11:19
Writes up building the Transcript MCP server by hand while an LLM
planned, reviewed and tracked progress without writing any code.

Prompts and LLM output are wrapped in collapsible <details> blocks so
the 260-line generated plan does not dominate the post, with kramdown's
per-element markdown="1" instead of the global parse_block_html.

The hero image ships as JPEG rather than PNG: as a photograph it needed
1.5 MB as PNG and missed the 300 KB budget even after the optimizer's
full ladder, where JPEG holds 1600px at 220 KB.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The new post cites schoolofthought.substack.com, which answers 200 to a
plain curl locally and 403 to htmlproofer on the GitHub runner. Substack
blocks datacenter IPs, so the link is live and the check is wrong about
it — the same ci-block case as the five URLs already listed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ultimatecoder
ultimatecoder merged commit 5e9eca9 into master Sep 20, 2026
2 checks passed
@ultimatecoder
ultimatecoder deleted the master-transcript-mcp-experince branch September 20, 2026 05:58
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