akollegger/adr-creator
.agents/skills/adr-creator/SKILL.md
Create or update Architecture Decision Records for this repository. Use when the user wants an ADR drafted, revised, or reviewed in `proposals/adr/`, especially for core technology choices, shared interfaces, costly-to-reverse decisions, or to resolve an open question from `docs/architecture.md`.
$ install --global
skillsauthnpx skillsauth add akollegger/aie-matrix adr-creatorInstall 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 24, 2026, 8:56 PM1.8s1 file scanned
SKILL.md
- name:
- adr-creator
- description:
- Create or update Architecture Decision Records for this repository. Use when the user wants an ADR drafted, revised, or reviewed in `proposals/adr/`, especially for core technology choices, shared interfaces, costly-to-reverse decisions, or to resolve an open question from `docs/architecture.md`.
ADR Creator
Overview
Use this skill to create repository-specific ADRs that follow proposals/adr/README.md exactly. Keep the document concise, decision-oriented, and grounded in the current architecture.
Workflow
- Read
proposals/adr/README.mdand the relevant section ofdocs/architecture.md. - Confirm the change belongs in an ADR:
- core technology choice or replacement
- shared interface definition
- expensive-to-reverse decision
- resolution of an architecture open question
- Determine the ADR filename:
NNNN-short-titlein lowercase kebab-case (e.g.0001-world-graph-backend). - Create a branch named
proposal/NNNN-short-titlematching the ADR filename exactly before writing any files. Do not proceed without switching to this branch. - Create or update
proposals/adr/NNNN-short-title.mdon that branch. - Use this structure exactly:
# ADR-NNNN: Title
**Status:** proposed | accepted | superseded by ADR-XXXX
**Date:** YYYY-MM-DD
**Authors:** @handle
## Context
## Decision
## Rationale
## Alternatives Considered
## Consequences
Writing Rules
- State one decision clearly in
## Decision. - Explain why this option won in
## Rationale, not in scattered paragraphs. - Include credible alternatives, even if rejected quickly.
- Keep consequences concrete: implementation impact, reversibility, operational cost, or coupling.
- Do not invent settled facts; align with
README.md,docs/project-overview.md, anddocs/architecture.md.
Output
When creating a new ADR:
- Confirm the active branch is
proposal/NNNN-short-titlebefore writing files. - Write the ADR file under
proposals/adr/. - Update the index table in
proposals/adr/README.md. - Mention any assumptions that still need maintainer confirmation.
- Remind the author to run
/adr-reviewbefore opening the proposal for comment.
Related Skills
akollegger/speckit-taskstoissues
data-ai
VerifiedTrustedCommunity
Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.
1SKILL.mdUpdated Apr 16, 2026
akollegger/speckit-tasks
data-ai
VerifiedTrustedCommunity
Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.
1SKILL.mdUpdated Apr 16, 2026
akollegger/speckit-specify
testing
VerifiedTrustedCommunity
Create or update the feature specification from a natural language feature description.
1SKILL.mdUpdated Apr 16, 2026
akollegger/speckit-plan
content-media
VerifiedTrustedCommunity
Execute the implementation planning workflow using the plan template to generate design artifacts.
1SKILL.mdUpdated Apr 16, 2026