Skip to content

Commit eeda669

Browse files
authored
docs: add community presets section to main README (#1960)
- Add 🎨 Community Presets section between Community Extensions and Community Walkthroughs - Add ToC entry for the new section - Populate presets/catalog.community.json with pirate and aide-in-place presets - Entries alphabetized: catalog by id, README table by name
1 parent ebc6106 commit eeda669

File tree

2 files changed

+66
-2
lines changed

2 files changed

+66
-2
lines changed

README.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@
2323
- [⚡ Get Started](#-get-started)
2424
- [📽️ Video Overview](#️-video-overview)
2525
- [🧩 Community Extensions](#-community-extensions)
26+
- [🎨 Community Presets](#-community-presets)
2627
- [🚶 Community Walkthroughs](#-community-walkthroughs)
2728
- [🛠️ Community Friends](#️-community-friends)
2829
- [🤖 Supported AI Agents](#-supported-ai-agents)
@@ -193,6 +194,17 @@ The following community-contributed extensions are available in [`catalog.commun
193194

194195
To submit your own extension, see the [Extension Publishing Guide](extensions/EXTENSION-PUBLISHING-GUIDE.md).
195196

197+
## 🎨 Community Presets
198+
199+
The following community-contributed presets customize how Spec Kit behaves — overriding templates, commands, and terminology without changing any tooling. Presets are available in [`catalog.community.json`](presets/catalog.community.json):
200+
201+
| Preset | Purpose | Provides | Requires | URL |
202+
|--------|---------|----------|----------|-----|
203+
| AIDE In-Place Migration | Adapts the AIDE extension workflow for in-place technology migrations (X → Y pattern) — adds migration objectives, verification gates, knowledge documents, and behavioral equivalence criteria | 2 templates, 8 commands | AIDE extension | [spec-kit-presets](https://github.com/mnriem/spec-kit-presets) |
204+
| Pirate Speak (Full) | Transforms all Spec Kit output into pirate speak — specs become "Voyage Manifests", plans become "Battle Plans", tasks become "Crew Assignments" | 6 templates, 9 commands || [spec-kit-presets](https://github.com/mnriem/spec-kit-presets) |
205+
206+
To build and publish your own preset, see the [Presets Publishing Guide](presets/PUBLISHING.md).
207+
196208
## 🚶 Community Walkthroughs
197209

198210
See Spec-Driven Development in action across different scenarios with these community-contributed walkthroughs:

presets/catalog.community.json

Lines changed: 54 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,58 @@
11
{
22
"schema_version": "1.0",
3-
"updated_at": "2026-03-09T00:00:00Z",
3+
"updated_at": "2026-03-24T00:00:00Z",
44
"catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/presets/catalog.community.json",
5-
"presets": {}
5+
"presets": {
6+
"aide-in-place": {
7+
"name": "AIDE In-Place Migration",
8+
"id": "aide-in-place",
9+
"version": "1.0.0",
10+
"description": "Adapts the AIDE workflow for in-place technology migrations (X → Y pattern). Overrides vision, roadmap, progress, and work item commands with migration-specific guidance.",
11+
"author": "mnriem",
12+
"repository": "https://github.com/mnriem/spec-kit-presets",
13+
"download_url": "https://github.com/mnriem/spec-kit-presets/releases/download/aide-in-place-v1.0.0/aide-in-place.zip",
14+
"homepage": "https://github.com/mnriem/spec-kit-presets",
15+
"documentation": "https://github.com/mnriem/spec-kit-presets/blob/main/aide-in-place/README.md",
16+
"license": "MIT",
17+
"requires": {
18+
"speckit_version": ">=0.2.0",
19+
"extensions": ["aide"]
20+
},
21+
"provides": {
22+
"templates": 2,
23+
"commands": 8
24+
},
25+
"tags": [
26+
"migration",
27+
"in-place",
28+
"brownfield",
29+
"aide"
30+
]
31+
},
32+
"pirate": {
33+
"name": "Pirate Speak (Full)",
34+
"id": "pirate",
35+
"version": "1.0.0",
36+
"description": "Arrr! Transforms all Spec Kit output into pirate speak. Specs, plans, and tasks be written fer scallywags.",
37+
"author": "mnriem",
38+
"repository": "https://github.com/mnriem/spec-kit-presets",
39+
"download_url": "https://github.com/mnriem/spec-kit-presets/releases/download/pirate-v1.0.0/pirate.zip",
40+
"homepage": "https://github.com/mnriem/spec-kit-presets",
41+
"documentation": "https://github.com/mnriem/spec-kit-presets/blob/main/pirate/README.md",
42+
"license": "MIT",
43+
"requires": {
44+
"speckit_version": ">=0.1.0"
45+
},
46+
"provides": {
47+
"templates": 6,
48+
"commands": 9
49+
},
50+
"tags": [
51+
"pirate",
52+
"theme",
53+
"fun",
54+
"experimental"
55+
]
56+
}
57+
}
658
}

0 commit comments

Comments
 (0)