Karpathy Coding Skills vs Linear Iris

“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 event-driven issue triage: GitHub webhook fires, Iris classifies, labels, drafts a spec, and routes — all inside the tool your team is already using. The DX bet is zero-setup friction if you're already on Linear, which is exactly the right call. The moment of truth is whether the spec output is actually usable or just a templated dump of the issue title plus three bullet points — Linear hasn't published real examples, which is a yellow flag. But compared to the weekend-alternative of a GPT-4 Lambda that reads your GitHub issues and posts to Linear via API, this wins on history-aware assignment and tight workflow integration that would take days to replicate properly.”

“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 is AI-assisted PM tooling, and the direct competitors are GitHub Copilot Workspace, Jira's AI features, and a dozen point solutions like Triage or Airplane. Iris's edge is that it lives inside Linear, which already owns a loyal developer-team segment that actively hates Jira — that's a real moat. The scenario where this breaks is any team with high issue volume and inconsistent labeling history, because Iris's assignment logic is pattern-matching on past behavior, meaning it confidently inherits your team's bad habits. What kills this in 12 months: GitHub ships native triage into Issues and the value prop collapses for teams not already committed to Linear. To be wrong about that, Linear needs to make Iris's spec quality and institutional memory genuinely irreplaceable — possible, but not proven yet.”

“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 '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 job-to-be-done is narrow and honest: stop issues from rotting in the inbox because nobody triaged them. That's a single, real problem that every eng team above five people has. Onboarding is the critical question — if connecting GitHub and seeing Iris take a first action takes longer than two minutes, the 'it just works' promise breaks immediately, and Linear hasn't shown that flow publicly. The product is opinionated in the right direction by using historical patterns rather than asking you to configure a rulebook, but completeness is still a gap: until Iris can close a feedback loop by learning from triage overrides, power users will keep a human PM in the loop and never fully trust the automation.”

“The buyer is an engineering team lead or VP Eng who's already paying for Linear Business at $16/user/mo — Iris is zero incremental cost to them, which means adoption friction is near zero and the feature defends the $16 seat against Jira and Shortcut. That's smart defensive product strategy, not a new revenue line. The moat is workflow lock-in through institutional memory: the longer Iris runs on your repo, the more it knows your team's patterns, making migration increasingly painful. The stress test is straightforward — if Anthropic or OpenAI ships a general-purpose agent that does this for $5/mo outside any PM tool, does Linear's integration advantage hold? Yes, for teams already embedded in Linear. For teams shopping fresh, the answer is less clear.”