rlnorthcutt
Joined 14 years ago
Joined 14 years ago
Hats off to the author for not only following the muse into the archives of ancient tech... but for stubbornly continuing forward even when all paths seem open.
I loved the trip down memory lane with some of these things, and really resonate with the dependency hell issue... though the hardware nature of this and multiple machines is a nice twist.
Really fun read. 5 Stars. Would read again.
It does NOT apply the fix itself to maintain separation of concerns and get human in the loop quality checks and planning.
This is a Go-based CLI that points Claude at any GitHub or local repo to generate three specific, high-context Markdown files:
1) ONBOARDING.md: A human-readable guide that maps out the project’s purpose, language stats, file tree, and a "doc library" of existing .md files. Hand this to a new contributor to save an hour of verbal walkthroughs.
2) ANALYSIS.md: A per-file audit that classifies roles (e.g., entrypoint, core, util) and provides structured improvement suggestions. Each suggestion includes a done_when condition specifically optimized so you can paste the block directly into a Claude Code prompt for a working implementation.
3) CLAUDE.md: A project-specific context file that Claude Code reads automatically to understand your architecture and conventions instead of being generically cautious.
Key Features:
- Zero Dependencies: No runtime or language install required; it’s a single binary. - Smart Selection: It uses Claude to identify the most structurally significant files instead of hitting token limits with junk files. - Flexible Backend: It automatically detects your ANTHROPIC_API_KEY or uses your existing Claude CLI installation.
I’d love to hear how this handles your repos or what other "AI-native" documentation formats would be useful for your workflow.
I respect your willingness to modify your original stance upon closer examination. Non-ironic hat tip.
The more interesting mode is -m ext, which outputs a .so that PHP loads as a normal extension. Writing a PHP extension has always meant writing C. Being able to write one in PHP changes who can realistically do it.
So, now PHP devs can ship better CLI tools (with libraries, but with less environment issues), AND can create custom PHP extensions that can speed up parts of the app.