Initial commit

skills/ln-322-adr-creator/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: ln-322-adr-creator
+description: Creates ADRs (Nygard format, 7 sections, ~300-500 words) via short Q&A. Assigns next ADR number and validates standards.
+---
+
+# ADR Creator
+
+Captures a single architecture decision with minimal dialog and saves it to the ADR collection.
+
+## Purpose & Scope
+- Assign next ADR number in `docs/reference/adrs/`.
+- Gather title/category/context/decision/rationale/alternatives/consequences/status via 5 questions.
+- Generate ADR file from template; validate standards; return path.
+
+## When to Use
+- Need to document a specific architectural/technical decision (one per ADR).
+- Project already has reference docs structure (`docs/reference/adrs/`).
+- Not for broad docs creation (use ln-110/ln-114 for initial structures).
+
+## Workflow (concise)
+1) **Detect number:** Scan existing ADR files, pick next zero-padded number, build slug.
+2) **Dialog (5 Qs):** Title; category (Strategic/Technical); Context; Decision + Rationale; Alternatives table (2 rows); Consequences + Related + Status.
+3) **Generate:** Copy template, fill placeholders (title/date/status/category/decision makers/context/decision/rationale/alternatives/consequences/related).
+4) **Validate:** Ensure SCOPE tags, maintenance/Last Updated, POSIX ending; apply DOCUMENTATION_STANDARDS if present; auto-fix missing bits.
+5) **Save & link:** Write `docs/reference/adrs/adr-NNN-slug.md`; optionally update `docs/reference/README.md` if placeholder found; report path and next steps.
+
+## Critical Rules
+- One decision per ADR; English language per standard.
+- Include 2 alternatives with pros/cons/rejection; keep within ~300-500 words.
+- Do not create if `docs/reference/adrs/` missing (warn instead).
+- Preserve zero-padded numbering; no gaps.
+
+## Definition of Done
+- Next ADR number/slug determined; placeholders filled; no leftovers.
+- File saved in adrs/ with ISO date, status, category, consequences, alternatives table.
+- Standards validated (SCOPE, maintenance, POSIX); README updated if placeholder present.
+- Path returned and user reminded to reference in architecture.md if needed.
+
+## Reference Files
+- Template: `ln-322-adr-creator/references/adr_template.md`
+- Standards: `docs/DOCUMENTATION_STANDARDS.md` (if exists)
+
+---
+Version: 7.0.0 (Condensed ADR creation and standards validation)
+Last Updated: 2025-11-26