docs: add workflows reference, reorganize into docs/reference/, and add --version flag (#2244)

* docs: add workflows reference, reorganize into docs/reference/, and add --version flag

- Move integrations.md, extensions.md, presets.md into docs/reference/
- New docs/reference/workflows.md: command reference for all workflow
  commands, built-in SDD Cycle workflow with Mermaid diagram, step types,
  expressions, input types, state/resume, and FAQ
- Rename workflow input feature_name to spec with prompt 'Describe what
  you want to build' to match speckit.specify command terminology
- Add --version / -V flag to root specify command with tests
- Update docs/toc.yml, README.md links, and docs/upgrade.md cross-reference
  to use reference/ paths
- Add workflow command to README CLI reference table

* docs: update speckit_version requirement to >=0.7.2 in workflow example
This commit is contained in:
Manfred Riem
2026-04-16 13:34:08 -05:00
committed by GitHub
parent 8d2797dc03
commit 02a1d610df
14 changed files with 369 additions and 34 deletions

View File

@@ -54,7 +54,7 @@ workflow:
description: "A test workflow"
inputs:
feature_name:
spec:
type: string
required: true
scope:
@@ -65,7 +65,7 @@ steps:
- id: step-one
command: speckit.specify
input:
args: "{{ inputs.feature_name }}"
args: "{{ inputs.spec }}"
- id: step-two
command: speckit.plan
@@ -1152,8 +1152,8 @@ class TestWorkflowDefinition:
from specify_cli.workflows.engine import WorkflowDefinition
definition = WorkflowDefinition.from_string(sample_workflow_yaml)
assert "feature_name" in definition.inputs
assert definition.inputs["feature_name"]["required"] is True
assert "spec" in definition.inputs
assert definition.inputs["spec"]["required"] is True
assert definition.inputs["scope"]["default"] == "full"