π« 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.mdindex 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 tExample:```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: stringdefault: "copilot"prompt: "Integration to use (e.g. claude, copilot, gemini)"- scope:- type: string- default: "full"- enum: ["full", "backend-only", "frontend-only"]steps:- id: specifydiff --git a/tests/workflows/test_bundled_speckit_workflow.py b/tests/workflows/test_bundled_speckit_workflow.pynew file mode 100644index 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.mdindex 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 TypesWorkflows support 12 built-in step types:diff --git a/workflows/catalog.json b/workflows/catalog.jsonindex 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.ymlindex 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: stringdefault: "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