Skip to content

Commit 375b2fd

Browse files
Add toc-navigation community preset to catalog and README (#2080)
* feat: add Table of Contents to generated markdown documents (#1970) * fix: address Copilot review - clarify TOC placement wording * fix: include TOC sections in structure templates * fix: include TOC in structure templates and fix tasks TOC placement wording * fix: correct TOC anchors to match headings with mandatory suffix * fix: include all ##-level headings in tasks-template TOC * fix: add missing TOC entries in tasks-template, remove leading blank line in * fix: move TOC after metadata block and include all ## headings in tasks-template * fix: use plain text for dynamic phase entries in tasks-template TOC * fix: remove hardcoded anchor links from template TOCs, use plain text exemplars * fix: remove HTML comments from template TOCs * fix: add missing Parallel Example heading to tasks-template TOC * revert: remove all core template changes, pivot to preset approach * feat: deliver TOC navigation as a preset (closes #1970) Pivots from core template changes to a preset approach per reviewer request. Adds presets/toc-navigation/ with 3 template overrides and 3 command overrides that add Table of Contents sections to generated spec.md, plan.md, and tasks.md documents. Addresses all 8 impact concerns from review: - Templates use anchor links (not plain text) matching command instructions - All 12 tasks-template headings accounted for (dynamic phases as plain text) - spec-template anchors include -mandatory suffix - TOC placed after Note paragraph in plan-template - Self-reference exclusion explicit in all commands - Clarify stale TOC instruction in specify command - Implement misparse warning in tasks command Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * feat: publish toc-navigation preset to community catalog (#1970) Move preset to standalone repository per maintainer guidance: https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation - Remove presets/toc-navigation/ from core repo - Add toc-navigation entry to catalog.community.json Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Add toc-navigation preset to main README community presets table Adds Table of Contents Navigation entry (alphabetically between Pirate Speak and VS Code Ask Questions) to the community presets table in README.md as requested by maintainer. --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 40fb276 commit 375b2fd

2 files changed

Lines changed: 25 additions & 0 deletions

File tree

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -244,6 +244,7 @@ The following community-contributed presets customize how Spec Kit behaves — o
244244
| 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) |
245245
| Canon Core | Adapts original Spec Kit workflow to work together with Canon extension | 2 templates, 8 commands || [spec-kit-canon](https://github.com/maximiliamus/spec-kit-canon) |
246246
| 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) |
247+
| Table of Contents Navigation | Adds a navigable Table of Contents to generated spec.md, plan.md, and tasks.md documents | 3 templates, 3 commands || [spec-kit-preset-toc-navigation](https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation) |
247248
| VS Code Ask Questions | Enhances the clarify command to use `vscode/askQuestions` for batched interactive questioning. | 1 command || [spec-kit-presets](https://github.com/fdcastel/spec-kit-presets) |
248249

249250
To build and publish your own preset, see the [Presets Publishing Guide](presets/PUBLISHING.md).

presets/catalog.community.json

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,30 @@
7878
"experimental"
7979
]
8080
},
81+
"toc-navigation": {
82+
"name": "Table of Contents Navigation",
83+
"id": "toc-navigation",
84+
"version": "1.0.0",
85+
"description": "Adds a navigable Table of Contents to generated spec.md, plan.md, and tasks.md documents",
86+
"author": "Quratulain-bilal",
87+
"repository": "https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation",
88+
"download_url": "https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation/archive/refs/tags/v1.0.0.zip",
89+
"homepage": "https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation",
90+
"documentation": "https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation/blob/main/README.md",
91+
"license": "MIT",
92+
"requires": {
93+
"speckit_version": ">=0.4.0"
94+
},
95+
"provides": {
96+
"templates": 3,
97+
"commands": 3
98+
},
99+
"tags": [
100+
"navigation",
101+
"toc",
102+
"documentation"
103+
]
104+
},
81105
"vscode-ask-questions": {
82106
"name": "VS Code Ask Questions",
83107
"id": "vscode-ask-questions",

0 commit comments

Comments
 (0)