Tagged “decisions”
RFC template for engineering teams (+ design doc)
A copy-paste engineering RFC and design doc template in Markdown, with Confluence notes, a review process, and how an RFC becomes a recorded decision.
How to link decisions to Jira tickets: 5 options compared
Five ways to track decisions in Jira and keep them attached to tickets and PRs: issue links, Confluence pages, Linear docs, ADRs, and automatic capture.
How we distill decisions from Slack noise
Inside Lockstep's distillation funnel: a four-test rubric, tiered models, prompt-cached extraction, and a human gate that nothing skips.
Best decision log software for product & engineering teams (2026)
Seven decision log tools compared: Notion, Confluence, Lockstep, ADR files, Linear, GitHub Discussions, and Loomio. Capture, structure, price, and fit.
The load-bearing hallway: what AI coding agents break first
Git, Jira, and PRDs were never the coordination layer — the human hallway was. AI coding agents delete it. What hospitals and remote teams teach us.
The engineering decision log: what to write down, and when
A practical guide to keeping a decision log: one question that tells you what counts, the four fields every entry needs, and the two moments teams always miss.
Architecture Decision Records (ADRs): a practical guide
What an ADR is, the minimal template, and when to write one. Then why ADRs fail on the read side, and what changes when AI coding agents are the reader.
AGENTS.md: What It Is, Example File, and What to Leave Out
AGENTS.md is a markdown file of instructions for AI coding agents. What it is, which tools read it, a complete example file, and what to leave out.