gh-levnikolaevich-claude-code-skills-full-development-workflow-skills/skills/ln-322-adr-creator/SKILL.md

name, description

name	description
ln-322-adr-creator	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