Karpathy Coding Skills vs Perplexity AI 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 clean: a single API endpoint that handles search retrieval, multi-hop resolution, and CoT synthesis without you wiring together a retriever, a reranker, and a reasoning model yourself. The DX bet is that you pay per search rather than manage chunking, embedding pipelines, or freshness invalidation — and that's the right bet for the 80% case. First 10 minutes survive: you swap your OpenAI call, add `search_domain_filter` and `reasoning_mode: true`, get citations back in the response object. My one gripe is that the reasoning trace isn't exposed as a structured field — you get the synthesis but not the hop-by-hop retrieval path, which makes debugging citation quality genuinely annoying. Not a weekend script replacement: building reliable multi-hop web retrieval with deduplication and grounding at this latency profile yourself is a real engineering problem. Ship it, but the opaque reasoning trace is a craft failure that will bite teams doing quality evaluation.”

“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.”

“Category: search-augmented generation API. Direct competitors: Bing Grounding in Azure OpenAI, Google Grounding with Gemini, and — let's be honest — a LangChain retriever pointing at Tavily. The specific scenario where this breaks is any workflow that needs deterministic source selection: when a user needs to restrict retrieval to a known corpus of internal documents plus live web, the domain filter is too coarse and you end up hallucinating synthesis from sources you didn't want. The $1-per-1000-searches pricing survives at moderate API volume but collapses fast for consumer apps with high query rates — a product doing 10M queries/month is looking at $10K just in search costs before inference. What kills this in 12 months: Google ships Grounding natively in Gemini 2.x at a price point that undercuts this, because Google owns the index and Perplexity doesn't. For the tool to survive that, the team needs to ship proprietary retrieval quality advantages that aren't just 'we also call the web.' Current state is good enough to ship for developer use cases where freshness matters and corpus is open web.”

“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 Sonar Pro 2 bets on: by 2028, the default architecture for knowledge-intensive LLM applications is retrieve-then-reason, not pretrain-then-prompt, and the team that owns the retrieval layer owns the application layer above it. That's a falsifiable claim — it fails if long-context models trained on near-real-time data make live retrieval unnecessary, which is a real dependency. The second-order effect if this wins is more interesting than the first-order: developers stop thinking of 'search' and 'reasoning' as separate infrastructure choices, which means Perplexity accumulates usage data on what multi-hop reasoning chains look like across domains — that's a training signal no one else has at scale. The trend line this rides is the shift from RAG-as-engineering-problem to RAG-as-API-call, and Sonar is on-time but not early — Bing and Google are both here. The future state where this is infrastructure: every serious research or analyst tool calls Sonar instead of building a retrieval stack, the same way every payments product calls Stripe instead of touching card rails. That's a plausible bet, but only if retrieval quality keeps compounding faster than the index owners can match.”

“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 is a developer team lead or CTO pulling from an API/infra budget — clear enough. But the pricing architecture is where this gets uncomfortable: $1 per 1,000 searches sounds cheap until you model a B2C product at scale, at which point you're paying for every user query including the ones that return nothing useful, and you can't pass that cost through to a $10/month subscription without margin collapse. The moat question is the real problem: Perplexity doesn't own the web index, doesn't own the underlying model, and the 'grounded reasoning' workflow is a pipeline any well-resourced competitor can replicate. Enterprise rate limit increases as the differentiator is not a moat. When the underlying model gets 10x cheaper, Perplexity's cost advantage narrows because their retrieval infrastructure cost doesn't compress at the same rate. This survives as a business if they convert API usage into enough workflow lock-in — custom pipelines, fine-tuned domain filters, proprietary citation formats — that switching costs accumulate. Right now those switching costs don't exist, and I'm not paying for a commodity pipeline at non-commodity margins.”