LSDIPPOLLC/linear-adr
.claude/skills/linear-adr/SKILL.md
Create and manage Architecture Decision Records (ADRs) as Linear issues and documents. Use when asked to record a decision, document architecture, or create an ADR.
testing
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add LSDIPPOLLC/ai-orchestration linear-adrInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 5:34 PM6.4s1 file scanned
SKILL.md
- name:
- linear-adr
- description:
- Create and manage Architecture Decision Records (ADRs) as Linear issues and documents. Use when asked to record a decision, document architecture, or create an ADR.
- user-invocable:
- true
- argument-hint:
- <decision title>
Linear ADR Manager
You create and manage Architecture Decision Records (ADRs) tracked as Linear issues with the ADR label and companion Linear documents.
Workspace Context
- Team: Lsdippo
- ADR Label: ADR (yellow, #F2C94C)
ADR Creation Flow
- Gather the decision context from the user
- Create a Linear issue with the ADR label as the tracking ticket
- Create a Linear document with the full ADR content, linked to the issue
- Report back with both the issue ID and document link
ADR Issue Format
Title: ADR: <Decision Title>
Labels: ADR
Priority: Normal (3) unless specified
Description:
## Decision
[What was decided]
## Status
Proposed | Accepted | Deprecated | Superseded
## Document
[Link to full ADR document will be attached]
ADR Document Template
Create the Linear document with this structure:
# ADR: <Decision Title>
## Status
**Proposed** — <date>
## Context
What is the issue that we're seeing that is motivating this decision or change?
## Decision
What is the change that we're proposing and/or doing?
## Consequences
### Positive
- [Benefits of this decision]
### Negative
- [Tradeoffs and costs]
### Neutral
- [Other impacts]
## Alternatives Considered
1. **[Alternative A]** — Why it was rejected
2. **[Alternative B]** — Why it was rejected
## References
- [Links to relevant resources, discussions, or prior art]
Managing ADRs
When asked to list or review ADRs:
- List issues with label=ADR
- Show their status (Proposed/Accepted/Deprecated)
- Fetch the linked document for full details if requested
When asked to update an ADR:
- Update both the issue and the document
- Add a comment on the issue noting the change
Related Skills
LSDIPPOLLC/ralph-wiggum-pm
development
VerifiedTrustedCommunity
Ralph Wiggum: Project Manager — Continuous ticket consumption, code review, and work generation loop. Picks up the next ticket, does the work, creates a PR, runs code review, logs completion, and creates follow-up tickets. Use when asked to start the loop, consume tickets, or grind through work.
SKILL.mdUpdated Apr 16, 2026
LSDIPPOLLC/linear-triage
testing
VerifiedTrustedCommunity
Triage and review Linear issues - list, filter, prioritize, and update issue status. Use when asked to check tickets, review backlog, or see what needs doing.
SKILL.mdUpdated Apr 16, 2026
LSDIPPOLLC/linear-planner
testing
VerifiedTrustedCommunity
Plan and break down work into Linear issues with dependencies, milestones, and projects. Use when asked to plan a feature, scope work, create a roadmap, or break down a project.
SKILL.mdUpdated Apr 16, 2026
LSDIPPOLLC/linear-create
tools
VerifiedTrustedCommunity
Create new Linear issues for bugs, features, improvements, or tasks. Use when asked to file a ticket, log work, track a task, or create an issue.
SKILL.mdUpdated Apr 16, 2026