From 5254efec46ead44a5bda83289ac6ce1996fe6bd0 Mon Sep 17 00:00:00 2001 From: Vianca Date: Thu, 19 Mar 2026 12:39:00 -0700 Subject: [PATCH 1/2] docs: update publishing guide with Category and Effect columns The README table now has Category and Effect columns (added in #1897), but the publishing guide template still showed the old 3-column format. Update to match so extension authors know to include both fields. Made-with: Cursor --- extensions/EXTENSION-PUBLISHING-GUIDE.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/extensions/EXTENSION-PUBLISHING-GUIDE.md b/extensions/EXTENSION-PUBLISHING-GUIDE.md index 39b744b2e1..0b459dc013 100644 --- a/extensions/EXTENSION-PUBLISHING-GUIDE.md +++ b/extensions/EXTENSION-PUBLISHING-GUIDE.md @@ -209,9 +209,22 @@ Edit `extensions/catalog.community.json` and add your extension: Add your extension to the Available Extensions table in `extensions/README.md`: ```markdown -| Your Extension Name | Brief description of what it does | [repo-name](https://github.com/your-org/spec-kit-your-extension) | +| Your Extension Name | Brief description of what it does | `category` | Effect | [repo-name](https://github.com/your-org/spec-kit-your-extension) | ``` +**Category** — pick the one that best fits your extension: + +- `docs` — reads, validates, or generates spec artifacts +- `code` — reviews, validates, or modifies source code +- `process` — orchestrates workflow across phases +- `integration` — syncs with external platforms +- `visibility` — reports on project health or progress + +**Effect** — choose one: + +- `Read-only` — produces reports without modifying files +- `Read+Write` — modifies files, creates artifacts, or updates specs + Insert your extension in alphabetical order in the table. ### 4. Submit Pull Request From 8b3a2e27beeba0922d680d58df4a2c5151191d9d Mon Sep 17 00:00:00 2001 From: Vianca Date: Thu, 19 Mar 2026 12:59:24 -0700 Subject: [PATCH 2/2] docs: copilot comments --- extensions/EXTENSION-PUBLISHING-GUIDE.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/extensions/EXTENSION-PUBLISHING-GUIDE.md b/extensions/EXTENSION-PUBLISHING-GUIDE.md index 0b459dc013..fe381e308e 100644 --- a/extensions/EXTENSION-PUBLISHING-GUIDE.md +++ b/extensions/EXTENSION-PUBLISHING-GUIDE.md @@ -209,10 +209,10 @@ Edit `extensions/catalog.community.json` and add your extension: Add your extension to the Available Extensions table in `extensions/README.md`: ```markdown -| Your Extension Name | Brief description of what it does | `category` | Effect | [repo-name](https://github.com/your-org/spec-kit-your-extension) | +| Your Extension Name | Brief description of what it does | `` | | [repo-name](https://github.com/your-org/spec-kit-your-extension) | ``` -**Category** — pick the one that best fits your extension: +**(Table) Category** — pick the one that best fits your extension: - `docs` — reads, validates, or generates spec artifacts - `code` — reviews, validates, or modifies source code @@ -222,8 +222,8 @@ Add your extension to the Available Extensions table in `extensions/README.md`: **Effect** — choose one: -- `Read-only` — produces reports without modifying files -- `Read+Write` — modifies files, creates artifacts, or updates specs +- Read-only — produces reports without modifying files +- Read+Write — modifies files, creates artifacts, or updates specs Insert your extension in alphabetical order in the table.