Skip to content

Commit f758eb7

Browse files
committed
Extensions & Presets section clarity
Improves Extensions & Presets section clarity in README.md
1 parent 0a425e7 commit f758eb7

File tree

1 file changed

+12
-15
lines changed

1 file changed

+12
-15
lines changed

README.md

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -441,21 +441,18 @@ specify check
441441

442442
Spec Kit can be tailored to your needs through two complementary systems — **extensions** and **presets** — plus project-local overrides for one-off adjustments:
443443

444-
```mermaid
445-
block-beta
446-
columns 1
447-
overrides["⬆ Highest priority\nProject-Local Overrides\n.specify/templates/overrides/"]
448-
presets["Presets — Customize core & extensions\n.specify/presets/<preset-id>/templates/"]
449-
extensions["Extensions — Add new capabilities\n.specify/extensions/<ext-id>/templates/"]
450-
core["Spec Kit Core — Built-in SDD commands & templates\n.specify/templates/\n⬇ Lowest priority"]
451-
452-
style overrides fill:transparent,stroke:#999
453-
style presets fill:transparent,stroke:#4a9eda
454-
style extensions fill:transparent,stroke:#4a9e4a
455-
style core fill:transparent,stroke:#e6a817
456-
```
457-
458-
**Templates** are resolved at **runtime** — Spec Kit walks the stack top-down and uses the first match. Project-local overrides (`.specify/templates/overrides/`) let you make one-off adjustments for a single project without creating a full preset. **Commands** are applied at **install time** — when you run `specify extension add` or `specify preset add`, command files are written into agent directories (e.g., `.claude/commands/`). If multiple presets or extensions provide the same command, the highest-priority version wins. On removal, the next-highest-priority version is restored automatically. If no overrides or customizations exist, Spec Kit uses its core defaults.
444+
| Priority | Component Type | Location |
445+
| -------: | ------------------------------------------------- | --------------------------------- |
446+
| ⬆ 1 | Project-Local Overrides | `.specify/templates/overrides/` |
447+
| 2 | Presets — Customize core & extensions | `.specify/presets//templates/` |
448+
| 3 | Extensions — Add new capabilities | `.specify/extensions//templates/` |
449+
| ⬇ 4 | Spec Kit Core — Built-in SDD commands & templates | `.specify/templates/` |
450+
451+
- **Templates** are resolved at **runtime** — Spec Kit walks the stack top-down and uses the first match.
452+
- Project-local overrides (`.specify/templates/overrides/`) let you make one-off adjustments for a single project without creating a full preset.
453+
- **Extension/preset commands** are applied at **install time** — when you run `specify extension add` or `specify preset add`, command files are written into agent directories (e.g., `.claude/commands/`).
454+
- If multiple presets or extensions provide the same command, the highest-priority version wins. On removal, the next-highest-priority version is restored automatically.
455+
- If no overrides or customizations exist, Spec Kit uses its core defaults.
459456

460457
### Extensions — Add New Capabilities
461458

0 commit comments

Comments
 (0)