Add post on learning MCP with an LLM as reviewer - #116
Merged
Merged
Conversation
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 globalparse_block_htmlsetting, 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-imagesran 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/testpasses — HTML-Proofer clean across 42 files, 186 external and 80 internal links./scripts/optimize-images --check— all images within budgetOne 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