From eeda669c19a32711546b8b8ec4060e7540365ac0 Mon Sep 17 00:00:00 2001 From: Manfred Riem <15701806+mnriem@users.noreply.github.com> Date: Tue, 24 Mar 2026 12:56:36 -0500 Subject: [PATCH] docs: add community presets section to main README (#1960) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- README.md | 12 ++++++++ presets/catalog.community.json | 56 ++++++++++++++++++++++++++++++++-- 2 files changed, 66 insertions(+), 2 deletions(-) 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" + ] + } + } }