Skip to content

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

fix: remove unused scope input from bundled speckit workflow (#4401)

Gyanu Mayankda2b0ae744c5
diff --git a/docs/reference/workflows.md b/docs/reference/workflows.md
index df634ffe7..41a890ba6 100644
--- a/docs/reference/workflows.md
+++ b/docs/reference/workflows.md
@@ -18,7 +18,7 @@ Runs a workflow from a catalog ID, URL, or local file path. Inputs declared by t
Example:
```bash
-specify workflow run speckit -i spec="Build a kanban board with drag-and-drop task management" -i scope=full
+specify workflow run speckit -i spec="Build a kanban board with drag-and-drop task management"
```
With `--json`, a single machine-readable object is printed instead of formatted text (the default output is unchanged when the flag is omitted):
@@ -449,10 +449,6 @@ inputs:
type: string
default: "copilot"
prompt: "Integration to use (e.g. claude, copilot, gemini)"
- scope:
- type: string
- default: "full"
- enum: ["full", "backend-only", "frontend-only"]
steps:
- id: specify
diff --git a/tests/workflows/test_bundled_speckit_workflow.py b/tests/workflows/test_bundled_speckit_workflow.py
new file mode 100644
index 000000000..77351ff01
--- /dev/null
+++ b/tests/workflows/test_bundled_speckit_workflow.py
@@ -0,0 +1,32 @@
+"""Guards for the bundled Full SDD Cycle workflow."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import yaml
+
+from specify_cli.workflows.engine import WorkflowDefinition, validate_workflow
+
+BUNDLED = (
+ Path(__file__).resolve().parents[2] / "workflows" / "speckit" / "workflow.yml"
+)
+
+
+def test_bundled_speckit_workflow_has_no_unused_scope_input() -> None:
+ """Every declared input must be referenced; scope was a dead prompt (#4384)."""
+ text = BUNDLED.read_text(encoding="utf-8")
+ definition = WorkflowDefinition.from_string(text)
+ assert validate_workflow(definition) == []
+ assert "scope" not in definition.inputs
+ assert "spec" in definition.inputs
+
+ raw = yaml.safe_load(text)
+ assert "scope" not in raw.get("inputs", {})
+ assert "inputs.scope" not in text
+
+ for step in raw["steps"]:
+ args = (step.get("input") or {}).get("args")
+ if args is None:
+ continue
+ assert "inputs.scope" not in str(args)
diff --git a/workflows/README.md b/workflows/README.md
index 70a34bc53..676ea6faf 100644
--- a/workflows/README.md
+++ b/workflows/README.md
@@ -70,12 +70,19 @@ specify workflow run ./my-workflow.yml --input spec="Build a user authentication
### Multiple Inputs
+When a workflow declares more than one input, pass each with a separate
+`--input` flag. For example, a custom workflow that gates steps on a
+`scope` selector:
+
```bash
-specify workflow run speckit \
+specify workflow run ./my-workflow.yml \
--input spec="Build a user authentication system with OAuth support" \
--input scope="backend-only"
```
+The bundled `speckit` workflow only declares `spec` (and optional
+`integration`); it does not take a `scope` input.
+
## Step Types
Workflows support 12 built-in step types:
diff --git a/workflows/catalog.json b/workflows/catalog.json
index 967120afb..c26a3230a 100644
--- a/workflows/catalog.json
+++ b/workflows/catalog.json
@@ -1,6 +1,6 @@
{
"schema_version": "1.0",
- "updated_at": "2026-04-13T00:00:00Z",
+ "updated_at": "2026-09-03T00:00:00Z",
"catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/workflows/catalog.json",
"workflows": {
"speckit": {
@@ -8,7 +8,7 @@
"name": "Full SDD Cycle",
"description": "Runs specify \u2192 plan \u2192 tasks \u2192 implement with review gates",
"author": "GitHub",
- "version": "1.0.0",
+ "version": "1.0.1",
"url": "https://raw.githubusercontent.com/github/spec-kit/main/workflows/speckit/workflow.yml",
"tags": ["sdd", "full-cycle"]
}
diff --git a/workflows/speckit/workflow.yml b/workflows/speckit/workflow.yml
index 230675b32..571318af4 100644
--- a/workflows/speckit/workflow.yml
+++ b/workflows/speckit/workflow.yml
@@ -2,7 +2,7 @@ schema_version: "1.0"
workflow:
id: "speckit"
name: "Full SDD Cycle"
- version: "1.0.0"
+ version: "1.0.1"
author: "GitHub"
description: "Runs specify β†’ plan β†’ tasks β†’ implement with review gates"
@@ -35,10 +35,6 @@ inputs:
type: string
default: "auto"
prompt: "Integration to use (e.g. claude, copilot, gemini; 'auto' uses the project's initialized integration)"
- scope:
- type: string
- default: "full"
- enum: ["full", "backend-only", "frontend-only"]
steps:
- id: specify