[Preset]: Add workflow-preset

[bigsmartben]

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 template
• templates/behavior/bdd-draft.feature - requirement-phase BDD draft template
• templates/behavior/behavior-scenarios-draft.json - structured behavior scenario draft template
• templates/behavior/uif-intent.json - requirement-phase UIF intent template
• templates/behavior/data-fixtures-intent.json - data fixture intent template
• templates/behavior/open-questions.json - behavior clarification questions template
• templates/behavior/behavior-testability-checklist.md - behavior testability checklist template
• templates/behavior/bdd-contract.feature - formal BDD contract template
• templates/behavior/uif-expected.json - Expected UIF contract template
• templates/behavior/scenario-instances.json - formal scenario instance contract template
• templates/behavior/data-fixtures.json - formal data fixture contract template
• templates/behavior/assertions.json - behavior assertion contract template
• schemas/speckit.behavior.scenarios.draft.v1.schema.json - structured behavior scenario draft schema
• schemas/speckit.behavior.uif.intent.v1.schema.json - UIF intent schema
• schemas/speckit.behavior.data-fixtures.intent.v1.schema.json - data fixture intent schema
• schemas/speckit.behavior.open-questions.v1.schema.json - behavior open questions schema
• schemas/speckit.behavior.uif.expected.v1.schema.json - Expected UIF schema
• schemas/speckit.behavior.scenario-instances.v1.schema.json - scenario instances schema
• schemas/speckit.behavior.data-fixtures.v1.schema.json - data fixtures schema
• schemas/speckit.behavior.assertions.v1.schema.json - behavior assertions schema
• schemas/speckit.implement.manifest.v1.schema.json - implementation handoff manifest schema
• schemas/speckit.implement.handoff.v2.schema.json - worker handoff schema
• schemas/speckit.implement.receipt.v1.schema.json - worker receipt schema

Commands Provided

• commands/speckit.specify.md - wraps core specification with requirement-phase behavior drafts
• commands/speckit.clarify.md - wraps core clarification with behavior-driven ambiguity checks
• commands/speckit.checklist.md - wraps core checklist generation with behavior testability checks
• commands/speckit.analyze.md - wraps core analysis with behavior-first vertical consistency checks
• commands/speckit.plan.md - wraps core planning with optional class and sequence design artifacts
• commands/speckit.tasks.md - wraps task generation with optional design artifact awareness
• commands/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.md and service/sequence design in contracts/sequences.md.
• Derives task validation strategy from behavior contracts, interface contracts, research.md, and quickstart.md without a standalone test-plan.md artifact 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.yml manifest 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.0 is 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.0 archive with specify 0.8.11: installed Workflow Preset v1.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:

• Add workflow-preset to community catalog #2617
• Add Workflow Preset to community catalog #2641

[bigsmartben]

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]

Update for the workflow-preset submission after follow-up hardening work.

Repository commit now pushed to main:
bigsmartben/spec-kit-workflow-preset@a2dddef

What changed since the original submission:

• /speckit.implement now invokes the preset orchestrator script directly instead of going through specify workflow run, avoiding the workflow shell step's fixed timeout for long sequential shard runs.
• Shard CLI stdout/stderr is received by a script-level log receiver and written to per-shard log files instead of being streamed into the main agent transcript.
• Final dispatch output is compacted: successful shards keep log paths and status only; failed shards keep a short error tail plus log paths.
• Each shard CLI is launched in a fresh process session, and interrupt cleanup targets the process group to avoid orphaned descendants.
• Handoff digest generation and per-shard handoff file writes now run in parallel while preserving returned shard order.
• Contract tests were expanded to cover timeout-free script dispatch, log receiver behavior, compact main output, process-group lifecycle cleanup, and parallel handoff writing.

Verification performed after the update:

python3 -m unittest tests/test_preset_contract.py
Ran 21 tests in 0.261s
OK

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]

Updated submission details for the latest community-preset-ready release.

Preset ID: workflow-preset
Version: 1.0.3
Repository: 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.dev0
Tags: planning, design, implementation, orchestration, handoff
Provides: 4 templates, 3 commands, 0 scripts

Validation completed:

• python3 -m unittest tests/test_preset_contract.py -> 36 tests OK
• JSON schema parse checks OK
• git diff --check OK
• specify preset add --dev /home/bigben/文档/github/spec-kit-workflow-preset OK
• specify preset add --from https://github.com/bigsmartben/spec-kit-workflow-preset/archive/refs/tags/v1.0.3.zip OK

Note: 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]

Small clarification after the latest metadata update: v1.0.3 is now the intended review target for this preset submission.

Canonical submission assets:

• Repository: https://github.com/bigsmartben/spec-kit-workflow-preset
• Tag archive: https://github.com/bigsmartben/spec-kit-workflow-preset/archive/refs/tags/v1.0.3.zip
• Release: https://github.com/bigsmartben/spec-kit-workflow-preset/releases/tag/v1.0.3

The earlier catalog PRs (#2617 and #2641) are closed, so this issue remains the canonical review thread.

[github-actions]

cc @github/spec-kit-maintainers — new catalog submission for review.

[bigsmartben]

Updated the canonical submission to workflow-preset v1.1.0 and edited the issue body so the issue-first community preset workflow can reprocess it.

Canonical assets:

• Repository: https://github.com/bigsmartben/spec-kit-workflow-preset
• Release: https://github.com/bigsmartben/spec-kit-workflow-preset/releases/tag/v1.1.0
• Tag archive: https://github.com/bigsmartben/spec-kit-workflow-preset/archive/refs/tags/v1.1.0.zip
• Fork integration commit: bigsmartben@4635ac7

Validation completed:

• Preset repo: python3 -m unittest tests/test_preset_contract.py -> 57 tests OK
• Preset repo: git diff --check HEAD -> OK
• Fresh archive install from v1.1.0.zip -> installed Workflow Preset v1.1.0
• Fresh archive install: specify preset info workflow-preset -> confirmed 30 provided entries
• Fresh archive install: specify preset resolve behavior-bdd-contract-template -> resolved
• Spec Kit fork: python3 -m json.tool presets/catalog.json -> OK
• Spec Kit fork: bundled preset contract tests -> 57 tests OK
• Spec Kit fork: uv run --extra test python -m pytest tests/test_presets.py -q -> 247 passed
• Spec Kit fork: uv run --extra test python -m pytest tests/integrations/test_cli.py -q -k workflow_preset -> 1 passed

[bigsmartben]

Updated the canonical workflow-preset community preset submission to v1.2.0.

Canonical assets:

• Repository: https://github.com/bigsmartben/spec-kit-workflow-preset
• Release: https://github.com/bigsmartben/spec-kit-workflow-preset/releases/tag/v1.2.0
• Tag archive: https://github.com/bigsmartben/spec-kit-workflow-preset/archive/refs/tags/v1.2.0.zip

Validation completed for this update:

• Release tag checkout: python -m unittest tests/test_preset_contract.py -> 57 tests OK
• Fresh Spec Kit project install from the v1.2.0 archive with specify 0.8.11 -> installed Workflow Preset v1.2.0
• 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