Karpathy Coding Skills vs Perplexity Sonar Pro 2 API

“I dropped this in my project root on Monday and by Wednesday I'd noticed my Claude sessions were producing tighter PRs. Could be placebo, but the 'surgical changes' rule alone seems to cut diff sizes by 30-40% in my experience. It costs nothing to try.”

“The primitive here is clear: grounded web synthesis with streaming citations exposed as an API endpoint, not a chat UI you have to scrape. The DX bet is that streaming citations alongside the reasoning trace is the right abstraction — and it is, because it lets you build trust signals into your app without reinventing retrieval. The moment of truth is whether the citation stream is parseable and stable enough to build on, and from the docs it looks like it actually is. This isn't something you replicate with a weekend script — you'd need a search index, a reranker, and a streaming LLM pipeline just to get to baseline. Ship for the specific case of building research-heavy features; skip if you just need vanilla RAG.”

“This is a CLAUDE.md file with four bullet points. The 16k stars are for Karpathy's credibility as a meme, not the engineering content. Any experienced prompt engineer has been writing these instructions for months. There's nothing novel here — the viral success is marketing, not substance.”

“Direct competitor is the Bing Grounding API in Azure OpenAI and Google's Grounding with Search in Gemini — both of which are backed by companies with vastly deeper index infrastructure. Perplexity's actual differentiator is the multi-step reasoning loop and the citation streaming, which neither competitor does as cleanly at the API level today. The scenario where this breaks is enterprise legal or compliance contexts where you need source provenance guarantees, not just URL citations — that's still a black box. What kills this in 12 months: OpenAI ships deep research natively in the API with better citation tooling, which is a near-certainty. The window is real but narrow, so ship now with eyes open.”

“What's interesting here isn't the file — it's the behavior. The community converged on four agreed-upon principles for AI coding in under 48 hours, without any coordination. That's an emergent standards moment. Expect these four principles (or close variants) to be embedded in default system prompts within 6 months.”

“The thesis here is falsifiable: by 2027, applications will need grounded, multi-step reasoning as a commodity API layer, not as a consumer product. That bet depends on LLM hallucination rates staying high enough that citation grounding remains valuable, and on Perplexity maintaining crawl freshness that model providers can't match with training data alone. The second-order effect that matters: if this API wins adoption, Perplexity becomes infrastructure for a generation of research-adjacent apps, which means they collect query data that trains the next model cycle — a compounding moat that's actually real. The trend line is the shift from static RAG to agentic search-and-synthesize; Perplexity is on-time, not early, but executing better than most. The future state where this is infrastructure is every B2B SaaS with a research or due-diligence feature.”

“The 'simplicity first' rule applies just as well to AI-generated copy and design briefs as it does to code. I've adapted this into a writing CLAUDE.md for my content workflow and it actually does reduce the 'AI maximalism' problem where everything comes back more elaborate than you wanted.”

“The buyer here is a developer at a company building a research or knowledge product, pulling from a product or engineering budget — fine. But $5 per 1,000 requests sounds cheap until you model the usage: a mid-size B2B app running 50,000 deep research queries a month is paying $250 just in API costs before any other infrastructure, and deep research queries are the expensive ones. The moat problem is the real issue: Perplexity's defensibility is the quality of their search index and the reasoning loop, but both Google and Microsoft are actively eroding this with grounding APIs backed by better crawl infrastructure. There's no workflow lock-in, no proprietary data flywheel on the API side, and no pricing architecture that scales with customer success rather than against it. I'd want to see a clear story for why enterprise customers choose this over Azure Grounding in 18 months before I called it viable.”