Claude Code Best Practices vs Linear Iris

“This fills a real gap. The official Claude Code docs are good for basics but thin on production patterns—subagent orchestration, hook design, memory architecture. This repo documents the emergent best practices from the community in a structured way. Bookmark it before your next agentic project.”

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

“Community best practice repos age fast when the underlying platform ships updates weekly. Half of what's documented here may be outdated or superseded by native Claude Code features within a month. Treat this as a starting point, not a source of truth—and watch for stale patterns that were workarounds for now-fixed limitations.”

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

“The 42k stars are a signal: agentic engineering is becoming a real discipline. We're watching the equivalent of the early DevOps playbooks—informal community knowledge that eventually becomes the baseline everyone assumes. The people building these patterns now are writing the textbooks for the next generation of AI infrastructure engineers.”

“Even for non-engineers, the agent team and memory sections are eye-opening. Understanding how multi-agent systems are actually structured changes how you think about what to ask AI to do. This is a great read if you're hitting the ceiling of what single-session Claude Code can handle.”

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