Skip to content

Commit 3ecab63

Browse files
committed
docs: Clarify template vs command resolution in README
- Separate template resolution (top-down, first-match-wins stack) from command registration (written directly into agent directories) - Update Mermaid diagram paths to use <preset-id> and <ext-id> placeholders consistent with existing documentation Addresses PR review feedback on #1898.
1 parent c34127b commit 3ecab63

1 file changed

Lines changed: 3 additions & 3 deletions

File tree

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -331,8 +331,8 @@ Spec Kit can be tailored to your needs through two complementary systems — **e
331331
block-beta
332332
columns 1
333333
overrides["⬆ Highest priority\nProject-Local Overrides\n.specify/templates/overrides/"]
334-
presets["Presets — Customize core & extensions\n.specify/presets/preset/"]
335-
extensions["Extensions — Add new capabilities\n.specify/extensions/ext/"]
334+
presets["Presets — Customize core & extensions\n.specify/presets/<preset-id>/templates/"]
335+
extensions["Extensions — Add new capabilities\n.specify/extensions/<ext-id>/templates/"]
336336
core["Spec Kit Core — Built-in SDD commands & templates\n.specify/templates/\n⬇ Lowest priority"]
337337
338338
style overrides fill:transparent,stroke:#999
@@ -341,7 +341,7 @@ block-beta
341341
style core fill:transparent,stroke:#e6a817
342342
```
343343

344-
Templates and commands resolve top-down: the first match wins. Project-local overrides (`.specify/templates/overrides/`) let you make one-off adjustments for a single project without creating a full preset. If no overrides or customizations exist, Spec Kit uses its core defaults.
344+
Templates resolve top-down: the first match wins. Project-local overrides (`.specify/templates/overrides/`) let you make one-off adjustments for a single project without creating a full preset. Commands work differently — presets and extensions register their command files directly into agent directories (e.g., `.claude/commands/`), overwriting any earlier version. If no overrides or customizations exist, Spec Kit uses its core defaults.
345345

346346
### Extensions — Add New Capabilities
347347

0 commit comments

Comments
 (0)