Skip to content

💫 Toolkit to help you get started with SDD or any other process!

docs: add README capability map (#4974)

Manfred Rieme6ab4474b9e3
diff --git a/README.md b/README.md
index 373a07cbe..082d82f07 100644
--- a/README.md
+++ b/README.md
@@ -19,8 +19,8 @@
</p>
Spec Kit is an open source toolkit that gives AI coding agents structured
-processes, reusable templates, and documented outcomes. Start with one of the
-three processes below, customize it, or bring your own.
+processes, reusable templates, and documented outcomes. Start with a ready-made
+process, customize it, or bring your own.
## Choose your process
@@ -29,9 +29,40 @@ three processes below, customize it, or bring your own.
| Build a feature or application | [Spec-Driven Development](#spec-driven-development) | A specification carried through planning, implementation, and convergence |
| Diagnose and repair broken behavior | [Bug fixing](#bug-fixing) | An assessed cause, scoped fix, and recorded verification |
| Decide whether an idea deserves investment | [Idea assessment](#idea-assessment) | An evidence-backed go, clarify, or stop decision |
-
-These are **independent entry points**, not three mandatory phases. SDD ships in
-core; bug fixing and assessment are bundled extensions you install when needed.
+| Adopt or create a different process | [Your own process](#capabilities) | A process adapted or assembled from reusable primitives |
+
+These are **independent entry points**, not mandatory phases. SDD ships in core;
+bug fixing and assessment are bundled extensions you install when needed, and
+the primitives below let you adopt or create other processes.
+
+## Capabilities
+
+Spec Kit combines ready-to-use processes with composable mechanisms:
+
+| Capability | Spec Kit mechanism |
+| --- | --- |
+| Connect to or switch between coding agents | [Integration](https://github.github.io/spec-kit/reference/integrations.html) |
+| Add a command, quality gate, or complete process | [Extension](https://github.github.io/spec-kit/reference/extensions.html) |
+| Connect a process to an external tool or service | [Extension](https://github.github.io/spec-kit/reference/extensions.html) |
+| React to coding-agent lifecycle events | [Extension event hook](https://github.github.io/spec-kit/reference/extensions.html#project-extension-and-hook-configuration) |
+| Adapt templates, commands, terminology, or methodology | [Preset](https://github.github.io/spec-kit/reference/presets.html) |
+| Enforce organizational or regulatory standards | [Preset](https://github.github.io/spec-kit/reference/presets.html) |
+| Override a template for one project | [Project-local override](https://github.github.io/spec-kit/guides/customization.html#project-local-overrides-and-resolution) |
+| Automate prompts, commands, gates, and shell tasks | [Workflow](https://github.github.io/spec-kit/reference/workflows.html) |
+| Modify an installed workflow without forking it | [Workflow overlay](https://github.github.io/spec-kit/reference/workflows.html#workflow-overlays) |
+| Add reusable executable behavior to workflows | [Workflow step](https://github.github.io/spec-kit/reference/workflows.html#custom-step-packages) |
+| Install a curated setup for a role or team | [Bundle](https://github.github.io/spec-kit/reference/bundles.html) |
+| Discover community components | Catalog |
+| Host a private catalog of approved components | Catalog |
+| Access private catalogs and component downloads | [Authentication](https://github.github.io/spec-kit/reference/authentication.html) |
+| Work offline or behind a firewall | [Local sources and self-hosted catalogs](https://github.github.io/spec-kit/install/air-gapped.html) |
+| Inspect which layer supplies a command, template, or script | [Artifact inventory](https://github.github.io/spec-kit/reference/artifacts.html) |
+
+Search the active catalogs with commands such as `specify extension search`,
+`specify preset search`, `specify workflow search`, and `specify bundle search`.
+Spec Kit includes community catalogs, and organizations can add their own
+curated sources. Catalog listings are not audits or endorsements, so review
+community source code before installing or running it.
<a id="-get-started"></a>
<a id="-prerequisites"></a>