git-why vs Linear AI Project Specs

“The commit message has always been inadequate documentation and AI-generated code makes this worse, not better. git-why is the first tool I've seen that treats agent reasoning as a first-class artifact of the development process. This is especially valuable for onboarding — imagine joining a codebase and being able to ask 'why does this function exist?' and getting the actual AI's reasoning chain.”

“The primitive here is clear: structured issue decomposition from unstructured text, embedded at the point where a PM would otherwise be copy-pasting bullet points into tickets for two hours. The DX bet is that zero configuration inside an existing workflow beats a standalone tool you have to onboard — and that's the right bet. The moment of truth is pasting a PRD and seeing whether the generated sub-tasks are actually granular enough to assign, not just vague epics reworded. Linear's existing issue graph gives the model real context about team structure and past work, which is the one thing a weekend Lambda-plus-GPT-4 script can't replicate without a full API implementation. I'd have skipped this if it were a standalone product, but as a native Linear feature it earns its keep.”

“The reasoning traces captured by AI agents are often verbose, self-referential, and not actually representative of the true 'why' behind a decision — they're post-hoc justifications as much as genuine reasoning. git-why could end up storing a lot of confident-sounding noise that misleads future developers. Also, the repo size implications of storing detailed traces for every commit need serious consideration.”

“Category is AI-assisted project scaffolding, and the direct competitor is literally a PM with a ChatGPT tab open, which most teams already have. The scenario where this breaks is a poorly written PRD — garbage in, confidently structured garbage out, and now your sprint is organized around the wrong sub-tasks. What kills this in 12 months isn't a competitor, it's habituation: teams will generate issues, realize the estimates and scoping are still wrong, and stop using it after the novelty wears off unless Linear keeps improving the model's domain-specific output quality. The thing keeping me from a skip is that this is genuinely integrated into the workflow rather than a sidebar chatbot bolted on — that's a real UX choice with real friction reduction, and Linear has earned enough trust that teams will actually try it.”

“As AI writes an increasing fraction of production code, the question of 'why does this codebase look this way' becomes critically important for maintenance, auditing, and regulatory compliance. git-why is early and rough, but it's pointing at something that will eventually become mandatory for AI-generated code in regulated industries.”

“The concept translates beautifully to creative work — imagine version control for design decisions with the AI's reasoning about why it chose this color palette or layout attached. git-why for Figma would be genuinely revolutionary. The core insight here is timeless: preserve the intent, not just the artifact.”

“The job-to-be-done is precise: convert a spec into a trackable work breakdown without manual ticket creation, which is a real, recurring pain point for every PM who's ever stared at a Notion doc and then spent 45 minutes copying it into Jira. Onboarding is non-existent in the best way — if you're already in Linear, you paste a doc and get issues; there's no new tool to learn. The opinion baked into this product is that issue structure should be derived from intent, not assembled from templates, which is a genuinely defensible stance. The gap I'd watch is whether the assignee suggestions are based on meaningful workload and skill signals or just round-robin recency — if it's the latter, PMs will quietly stop trusting the output and just delete those fields every time.”

“The buyer is already paying for Linear, which makes this a retention and upsell feature, not a new acquisition problem — that's a structurally sound place to add AI. The moat is workflow lock-in compounded by data: Linear now has your team's historical issue taxonomy, velocity data, and assignee patterns, which means the suggestions get better the longer you stay, and that loop doesn't exist if you churn to a competitor. The stress test is what happens when Atlassian ships the same feature in Jira, which they will, probably within 18 months — Linear's answer has to be execution quality and the fact that teams who switched from Jira did it precisely because they don't want Atlassian's bloat. The specific business decision that makes this viable: it's priced into existing plans, so it lowers churn without requiring a pricing conversation.”