diff --git a/docs/adr/0005-require-an-explicit-llm-model-no-defaults.md b/docs/adr/0005-llm-enhanced-notes-require-an-explicit-model-no-defaults.md similarity index 84% rename from docs/adr/0005-require-an-explicit-llm-model-no-defaults.md rename to docs/adr/0005-llm-enhanced-notes-require-an-explicit-model-no-defaults.md index f25f07b1..cbfc258c 100644 --- a/docs/adr/0005-require-an-explicit-llm-model-no-defaults.md +++ b/docs/adr/0005-llm-enhanced-notes-require-an-explicit-model-no-defaults.md @@ -1,4 +1,4 @@ -# 5. Require an explicit LLM model; ship no defaults +# 5. LLM-enhanced release notes require an explicit model; ship no defaults Date: 2026-07-19 @@ -16,7 +16,9 @@ Crucially, there is no zero-config path to protect: LLM enhancement is already a ## Decision -**ReleaseKit ships no model defaults. `llm.model` is required and validated at config load.** +This decision is scoped to LLM-enhanced release notes — the only place ReleaseKit calls a model. Versioning, changelog generation, and publishing are deterministic and LLM-free; this decision does not touch them. + +**For LLM-enhanced release notes, ReleaseKit ships no model defaults. When enhancement is enabled, `llm.model` is required and validated at config load.** - `llm.model` is a required, non-empty string (Zod `z.string().min(1)`) — a missing or empty model fails at config validation, not silently inside the notes soft-fail catch. - `provider` is a closed Zod enum (`openai | openai-compatible | anthropic | ollama`); `openai-compatible` additionally requires `baseURL`. diff --git a/docs/adr/README.md b/docs/adr/README.md index 064a1e39..3392a10e 100644 --- a/docs/adr/README.md +++ b/docs/adr/README.md @@ -10,4 +10,4 @@ Roadmap sequencing lives in [ROADMAP.md](../../ROADMAP.md); implementation detai | [0002](./0002-no-mcp-server-cli-is-the-agent-surface.md) | The agent-facing surface is the CLI, not an MCP server | Accepted | | [0003](./0003-optional-change-file-input.md) | Change files are supported as an optional input, in changesets format | Accepted | | [0004](./0004-ecosystem-enablement-detection-enables-config-opts-out.md) | Ecosystem enablement: detection enables, config opts out | Accepted | -| [0005](./0005-require-an-explicit-llm-model-no-defaults.md) | Require an explicit LLM model; ship no defaults | Accepted | +| [0005](./0005-llm-enhanced-notes-require-an-explicit-model-no-defaults.md) | LLM-enhanced release notes require an explicit model; ship no defaults | Accepted |