Skip to content

πŸ’« Toolkit to help you get started with SDD or any other process!

docs: add community presets section to main README (#1960)

Manfred Riemeeda669c19a3
diff --git a/README.md b/README.md
index a407d43e9..ff909d7d2 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,7 @@
- [⚑ Get Started](#-get-started)
- [πŸ“½οΈ Video Overview](#️-video-overview)
- [🧩 Community Extensions](#-community-extensions)
+- [🎨 Community Presets](#-community-presets)
- [🚢 Community Walkthroughs](#-community-walkthroughs)
- [πŸ› οΈ Community Friends](#️-community-friends)
- [πŸ€– Supported AI Agents](#-supported-ai-agents)
@@ -193,6 +194,17 @@ The following community-contributed extensions are available in [`catalog.commun
To submit your own extension, see the [Extension Publishing Guide](extensions/EXTENSION-PUBLISHING-GUIDE.md).
+## 🎨 Community Presets
+
+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):
+
+| Preset | Purpose | Provides | Requires | URL |
+|--------|---------|----------|----------|-----|
+| 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) |
+| 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) |
+
+To build and publish your own preset, see the [Presets Publishing Guide](presets/PUBLISHING.md).
+
## 🚢 Community Walkthroughs
See Spec-Driven Development in action across different scenarios with these community-contributed walkthroughs:
diff --git a/presets/catalog.community.json b/presets/catalog.community.json
index 368f208b7..9f7f045b3 100644
--- a/presets/catalog.community.json
+++ b/presets/catalog.community.json
@@ -1,6 +1,58 @@
{
"schema_version": "1.0",
- "updated_at": "2026-03-09T00:00:00Z",
+ "updated_at": "2026-03-24T00:00:00Z",
"catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/presets/catalog.community.json",
- "presets": {}
+ "presets": {
+ "aide-in-place": {
+ "name": "AIDE In-Place Migration",
+ "id": "aide-in-place",
+ "version": "1.0.0",
+ "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.",
+ "author": "mnriem",
+ "repository": "https://github.com/mnriem/spec-kit-presets",
+ "download_url": "https://github.com/mnriem/spec-kit-presets/releases/download/aide-in-place-v1.0.0/aide-in-place.zip",
+ "homepage": "https://github.com/mnriem/spec-kit-presets",
+ "documentation": "https://github.com/mnriem/spec-kit-presets/blob/main/aide-in-place/README.md",
+ "license": "MIT",
+ "requires": {
+ "speckit_version": ">=0.2.0",
+ "extensions": ["aide"]
+ },
+ "provides": {
+ "templates": 2,
+ "commands": 8
+ },
+ "tags": [
+ "migration",
+ "in-place",
+ "brownfield",
+ "aide"
+ ]
+ },
+ "pirate": {
+ "name": "Pirate Speak (Full)",
+ "id": "pirate",
+ "version": "1.0.0",
+ "description": "Arrr! Transforms all Spec Kit output into pirate speak. Specs, plans, and tasks be written fer scallywags.",
+ "author": "mnriem",
+ "repository": "https://github.com/mnriem/spec-kit-presets",
+ "download_url": "https://github.com/mnriem/spec-kit-presets/releases/download/pirate-v1.0.0/pirate.zip",
+ "homepage": "https://github.com/mnriem/spec-kit-presets",
+ "documentation": "https://github.com/mnriem/spec-kit-presets/blob/main/pirate/README.md",
+ "license": "MIT",
+ "requires": {
+ "speckit_version": ">=0.1.0"
+ },
+ "provides": {
+ "templates": 6,
+ "commands": 9
+ },
+ "tags": [
+ "pirate",
+ "theme",
+ "fun",
+ "experimental"
+ ]
+ }
+ }
}