linear-adr

Create and manage Architecture Decision Records as Linear issues with linked documents.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/LSDIPPOLLC/ai-orchestration --skill linear-adr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-adr
Source: https://github.com/LSDIPPOLLC/ai-orchestration/tree/main/.claude/skills/linear-adr
Command: npx skills add https://github.com/LSDIPPOLLC/ai-orchestration --skill linear-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the manual overhead of documenting architecture decisions by turning ADRs into trackable Linear work items with linked, full-text documentation.

Core Features & Use Cases

  • Create ADRs as Linear issues + documents: Automatically creates an ADR-labeled Linear issue and a companion Linear document containing the ADR text.
  • Manage ADR lifecycle: Supports Proposed/Accepted/Deprecated/Superseded status tracking and keeps the issue and document aligned.
  • List or update ADRs on request: Lists ADR issues by label and fetches linked documents when full details are needed, and updates both the issue and document when changes are made.

Quick Start

Ask the assistant: "Create an Architecture Decision Record titled 'Adopt X for caching' including the context, decision, consequences, alternatives, and references."

Frequently Asked Questions about linear-adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track architecture decision records in Linear?

Track architecture decision records in Linear by creating ADR-labeled issues with linked documents, enabling full-text documentation and lifecycle status management directly within your issue tracker.

What is the best way to document architecture decisions for engineering teams?

Documenting architecture decisions for engineering teams is best handled by creating trackable work items with companion documents, ensuring decisions remain searchable and aligned with their lifecycle status.

Can I manage the ADR lifecycle status within Linear issue tracking?

Yes, you can manage the ADR lifecycle within Linear issue tracking by applying statuses like Proposed, Accepted, Deprecated, or Superseded, which keeps both the issue and linked document aligned.

How do I create an Architecture Decision Record with context, decision, and consequences?

Create an Architecture Decision Record by prompting the assistant with a title and sections for context, decision, consequences, alternatives, and references, which automatically generates a Linear issue and document.

Does Linear MCP integration support listing and updating existing ADR documents?

Linear MCP integration supports listing ADR issues by label, fetching linked documents for full details, and updating both the issue and document metadata when changes are made to architecture decisions.

Why use Linear issues for architecture decision documentation instead of standalone docs?

Using Linear issues for architecture decision documentation removes manual overhead by turning ADRs into trackable work items, ensuring decisions are searchable and their lifecycle is actively monitored alongside engineering tasks.