Repository navigation
[Preset]: Add workflow-preset #2618
Description
Preset ID
workflow-preset
Preset Name
Workflow Preset
Version
1.2.0
Description
Behavior-first specification, design artifacts, and agent-native handoff orchestration.
The preset keeps /speckit.specify, /speckit.clarify, /speckit.checklist, /speckit.plan, /speckit.tasks, and /speckit.analyze compatible with the core workflow while adding requirement-phase behavior drafts, formal BDD/UIF/behavior contracts, optional design artifacts, and scoped implementation handoffs. It replaces /speckit.implement with Core Agent, Vertical Planner Agent, and Worker Agent modes so implementation can run from persisted, auditable handoff contracts.
Author
bigsmartben
Repository URL
https://github.com/bigsmartben/spec-kit-workflow-preset
Download URL
https://github.com/bigsmartben/spec-kit-workflow-preset/archive/refs/tags/v1.2.0.zip
Release URL
https://github.com/bigsmartben/spec-kit-workflow-preset/releases/tag/v1.2.0
License
MIT
Required Spec Kit Version
=0.8.10.dev0
Required Extensions
None
Templates Provided
templates/plan-template.md- adds behavior/design artifact navigation to the plan templatetemplates/behavior/bdd-draft.feature- requirement-phase BDD draft templatetemplates/behavior/behavior-scenarios-draft.json- structured behavior scenario draft templatetemplates/behavior/uif-intent.json- requirement-phase UIF intent templatetemplates/behavior/data-fixtures-intent.json- data fixture intent templatetemplates/behavior/open-questions.json- behavior clarification questions templatetemplates/behavior/behavior-testability-checklist.md- behavior testability checklist templatetemplates/behavior/bdd-contract.feature- formal BDD contract templatetemplates/behavior/uif-expected.json- Expected UIF contract templatetemplates/behavior/scenario-instances.json- formal scenario instance contract templatetemplates/behavior/data-fixtures.json- formal data fixture contract templatetemplates/behavior/assertions.json- behavior assertion contract templateschemas/speckit.behavior.scenarios.draft.v1.schema.json- structured behavior scenario draft schemaschemas/speckit.behavior.uif.intent.v1.schema.json- UIF intent schemaschemas/speckit.behavior.data-fixtures.intent.v1.schema.json- data fixture intent schemaschemas/speckit.behavior.open-questions.v1.schema.json- behavior open questions schemaschemas/speckit.behavior.uif.expected.v1.schema.json- Expected UIF schemaschemas/speckit.behavior.scenario-instances.v1.schema.json- scenario instances schemaschemas/speckit.behavior.data-fixtures.v1.schema.json- data fixtures schemaschemas/speckit.behavior.assertions.v1.schema.json- behavior assertions schemaschemas/speckit.implement.manifest.v1.schema.json- implementation handoff manifest schemaschemas/speckit.implement.handoff.v2.schema.json- worker handoff schemaschemas/speckit.implement.receipt.v1.schema.json- worker receipt schema
Commands Provided
commands/speckit.specify.md- wraps core specification with requirement-phase behavior draftscommands/speckit.clarify.md- wraps core clarification with behavior-driven ambiguity checkscommands/speckit.checklist.md- wraps core checklist generation with behavior testability checkscommands/speckit.analyze.md- wraps core analysis with behavior-first vertical consistency checkscommands/speckit.plan.md- wraps core planning with optional class and sequence design artifactscommands/speckit.tasks.md- wraps task generation with optional design artifact awarenesscommands/speckit.implement.md- runs agent-native handoff orchestration or executes one worker handoff
Number of Scripts
0
Tags
behavior, bdd, planning, implementation, handoff
Key Features
- Adds a BDD readiness gate before planning so behavior gaps return to requirements before downstream artifacts are generated.
- Projects accepted requirements into BDD, UIF intent, scenario, fixture, and open-question behavior drafts.
- Formalizes behavior into BDD, Expected UIF, scenario instance, data fixture, and assertion contracts during planning.
- Keeps optional object design in
class-diagram.mdand service/sequence design incontracts/sequences.md. - Derives task validation strategy from behavior contracts, interface contracts,
research.md, andquickstart.mdwithout a standalonetest-plan.mdartifact in v1.2.0. - Replaces broad implementation execution with agent-native handoff orchestration using Core Agent, Vertical Planner Agent, and Worker Agent roles.
- Defines standalone JSON schema contracts for implementation manifest, handoff, and receipt artifacts.
Testing Checklist
- Preset installs successfully via
specify preset add - Template resolution works correctly after installation
- Documentation is complete and accurate
- Tested on at least one real project
Submission Requirements
- Valid
preset.ymlmanifest included - README.md with description and usage instructions
- LICENSE file included
- GitHub release created with version tag
- Preset ID follows naming conventions (lowercase-with-hyphens)
Verification Performed
- GitHub Release
v1.2.0is published and is not draft/prerelease: https://github.com/bigsmartben/spec-kit-workflow-preset/releases/tag/v1.2.0 - Release tag archive: https://github.com/bigsmartben/spec-kit-workflow-preset/archive/refs/tags/v1.2.0.zip
- Release tag checkout:
python -m unittest tests/test_preset_contract.py-> 57 tests OK - Fresh Spec Kit project install from the
v1.2.0archive withspecify 0.8.11: installedWorkflow Presetv1.2.0 successfully - Fresh archive install:
specify preset info workflow-preset-> confirmed v1.2.0 metadata and 30 provided entries - Fresh archive install:
specify preset resolve behavior-bdd-contract-template-> resolved to the installed v1.2.0 behavior template - Current preset repository main:
python -m unittest tests/test_preset_contract.py-> 74 tests OK - Current preset repository main:
git diff --check HEAD-> OK
Related
Earlier catalog PRs were closed because community preset submissions are issue-first:
Activity
bigsmartben commentedon May 18, 2026
Review update: I fixed a macOS path normalization issue in the preset repository after submission.\n\nCommit: bigsmartben/spec-kit-workflow-preset@868c3fe\n\nThe fix keeps shard scope verification consistent when temporary directories resolve through paths like /var -> /private/var. Contract tests pass locally with the existing test suite:\n\n
\n/tmp/spec-kit-workflow-preset-venv/bin/python -m unittest tests/test_preset_contract.py\nRan 11 tests\nOK\n\n\nI am leaving the release version/tag unchanged for now during review, and can publish a follow-up patch release if the listing review requires the downloadable archive to include this fix.bigsmartben commentedon May 20, 2026
Update for the
workflow-presetsubmission after follow-up hardening work.Repository commit now pushed to
main:bigsmartben/spec-kit-workflow-preset@a2dddef
What changed since the original submission:
/speckit.implementnow invokes the preset orchestrator script directly instead of going throughspecify workflow run, avoiding the workflow shell step's fixed timeout for long sequential shard runs.Verification performed after the update:
The release tag/download URL in the original submission still points to
v1.0.0. I can publish a patch release and update the issue metadata if the community listing review requires the downloadable archive to include these hardening changes.bigsmartben commentedon May 20, 2026
Updated submission details for the latest community-preset-ready release.
Preset ID:
workflow-presetVersion:
1.0.3Repository: https://github.com/bigsmartben/spec-kit-workflow-preset
Download URL: https://github.com/bigsmartben/spec-kit-workflow-preset/archive/refs/tags/v1.0.3.zip
License: MIT
Required Spec Kit version:
>=0.8.10.dev0Tags: planning, design, implementation, orchestration, handoff
Provides: 4 templates, 3 commands, 0 scripts
Validation completed:
python3 -m unittest tests/test_preset_contract.py-> 36 tests OKgit diff --checkOKspecify preset add --dev /home/bigben/文档/github/spec-kit-workflow-presetOKspecify preset add --from https://github.com/bigsmartben/spec-kit-workflow-preset/archive/refs/tags/v1.0.3.zipOKNote: I briefly opened PR #2641 from the catalog branch, but the community flow should be issue-first. I will close that PR so this submission can proceed through this issue.
bigsmartben commentedon May 20, 2026
Small clarification after the latest metadata update:
v1.0.3is now the intended review target for this preset submission.Canonical submission assets:
The earlier catalog PRs (#2617 and #2641) are closed, so this issue remains the canonical review thread.
github-actions commentedon May 21, 2026
cc @github/spec-kit-maintainers — new catalog submission for review.
bigsmartben commentedon May 26, 2026
Updated the canonical submission to
workflow-presetv1.1.0 and edited the issue body so the issue-first community preset workflow can reprocess it.Canonical assets:
Validation completed:
python3 -m unittest tests/test_preset_contract.py-> 57 tests OKgit diff --check HEAD-> OKv1.1.0.zip-> installed Workflow Preset v1.1.0specify preset info workflow-preset-> confirmed 30 provided entriesspecify preset resolve behavior-bdd-contract-template-> resolvedpython3 -m json.tool presets/catalog.json-> OKuv run --extra test python -m pytest tests/test_presets.py -q-> 247 passeduv run --extra test python -m pytest tests/integrations/test_cli.py -q -k workflow_preset-> 1 passedbigsmartben commentedon May 27, 2026
Updated the canonical
workflow-presetcommunity preset submission to v1.2.0.Canonical assets:
Validation completed for this update:
python -m unittest tests/test_preset_contract.py-> 57 tests OKspecify 0.8.11-> installed Workflow Preset v1.2.0specify preset info workflow-preset-> confirmed v1.2.0 metadata and 30 provided entriesspecify preset resolve behavior-bdd-contract-template-> resolved to the installed v1.2.0 behavior templatepython -m unittest tests/test_preset_contract.py-> 74 tests OKgit diff --check HEAD-> OKAdd Workflow Preset to community catalog (#2725)