[goosewobbler]

What

Renames and re-scopes ADR-0005 so its title and filename make clear the "explicit model, no defaults" decision applies only to LLM-enhanced release notes — not to ReleaseKit as a whole.

• 0005-require-an-explicit-llm-model-no-defaults.md → 0005-llm-enhanced-notes-require-an-explicit-model-no-defaults.md
• Title → "LLM-enhanced release notes require an explicit model; ship no defaults"
• Adds a scoping lead sentence to the Decision section (versioning, changelog, and publishing are deterministic and LLM-free — untouched by this decision)
• Updates the ADR index in docs/adr/README.md

Why

The bare title "require an explicit LLM model" reads as a repo-wide stance. In fact a model is called in exactly one place — release-notes enhancement, an explicit opt-in. The narrower title/filename prevents that misreading.

Note on ADR immutability

The ADR index states ADRs are immutable once accepted, with changes made by superseding. This is not a decision change — the decision (no defaults; llm.model required and validated at load) is identical. It's a same-scope title/framing clarification of an ADR merged hours ago in #566, so it's edited in place rather than superseded.

🤖 Generated with Claude Code

Greptile Summary

This PR narrows the scope of ADR-0005 by renaming the file and title to make explicit that the "no defaults, explicit model required" decision applies solely to LLM-enhanced release notes, not to ReleaseKit as a whole.

• The ADR file is renamed from 0005-require-an-explicit-llm-model-no-defaults.md to 0005-llm-enhanced-notes-require-an-explicit-model-no-defaults.md and its title updated to match.
• A scoping lead sentence is added to the Decision section clarifying that versioning, changelog generation, and publishing are deterministic and LLM-free, untouched by this ADR.
• The ADR index in docs/adr/README.md is updated to reflect the new filename and title.

Confidence Score: 5/5

Documentation-only change with no impact on runtime behaviour; safe to merge.

The change is a file rename plus a prose addition that brings the ADR title, filename, and Decision section into alignment. No code is touched, no config is modified, and the README index is updated consistently.

No files require special attention.

Important Files Changed

Filename	Overview
docs/adr/0005-llm-enhanced-notes-require-an-explicit-model-no-defaults.md	Renamed and re-scoped ADR: title, filename, and Decision section updated consistently to restrict the "explicit model, no defaults" stance to LLM-enhanced release notes only.
docs/adr/README.md	ADR index updated with the new filename and title for ADR-0005; all other entries are unchanged.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[ReleaseKit] --> B[Versioning]
    A --> C[Changelog generation]
    A --> D[Publishing]
    A --> E[LLM-enhanced release notes]

    B --> F[Deterministic / LLM-free]
    C --> F
    D --> F

    E --> G{llm.model set?}
    G -- No --> H[Config validation fails loud]
    G -- Yes --> I[Enhancement proceeds]

    style E fill:#f0e6ff,stroke:#9b59b6
    style G fill:#f0e6ff,stroke:#9b59b6
    style H fill:#fdecea,stroke:#e74c3c
    style I fill:#e8f8f0,stroke:#2ecc71
    style F fill:#eaf4fb,stroke:#3498db

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[ReleaseKit] --> B[Versioning]
    A --> C[Changelog generation]
    A --> D[Publishing]
    A --> E[LLM-enhanced release notes]

    B --> F[Deterministic / LLM-free]
    C --> F
    D --> F

    E --> G{llm.model set?}
    G -- No --> H[Config validation fails loud]
    G -- Yes --> I[Enhancement proceeds]

    style E fill:#f0e6ff,stroke:#9b59b6
    style G fill:#f0e6ff,stroke:#9b59b6
    style H fill:#fdecea,stroke:#e74c3c
    style I fill:#e8f8f0,stroke:#2ecc71
    style F fill:#eaf4fb,stroke:#3498db

Loading

_{Reviews (2): Last reviewed commit: "docs(adr): disambiguate the ADR-0005 sco..." | Re-trigger Greptile}

[github-actions]

Standing release PR: #555 · v0.41.0 queued (4 packages) · open 4h 5m · ✅ ready to merge

Release Preview — v0.40.0 → v0.40.1

Note: Labels on this PR are advisory in standing-pr mode. Bumps come from conventional commits in the standing PR; override by editing labels on the standing PR itself. Add release:immediate to bypass the standing PR and release this PR directly.

These changes will be added to the release PR (#555) when merged:

Changelog

monorepo 0.40.0 → 0.40.1

Changed

• disambiguate the ADR-0005 scoping sentence (adr)
• scope ADR-0005 to LLM-enhanced release notes (adr)

All packages → 0.40.1 (sync versioning)

• @releasekit/version
• @releasekit/notes
• @releasekit/publish
• @releasekit/release

After merge — predicted release

No version escalation — this PR's changes will be included in the queued release without affecting the projected versions.

Package	Standing PR	This PR	After merge
monorepo	0.41.0	0.40.1	0.41.0

---

Updated automatically by ReleaseKit