Skip to content

[Preset]: Add test-first-governance #3502

Description

@mnriem

Filed on behalf of @ka-zo (Zoltán Katona, PhD), author of #3491, by GitHub Copilot.

Preset ID

test-first-governance

Preset Name

Test-First Governance

Version

1.3.0

Description

Governs TDD with coverage-complete BDD/ATDD Gherkin scenarios, explicit suite ownership, professional test reports, traceability, and risk-based quality gates.

Author

Zoltán Katona, PhD

Repository URL

https://github.com/ka-zo/spec-kit-preset-test-first-governance

Download URL

https://github.com/ka-zo/spec-kit-preset-test-first-governance/archive/refs/tags/1.3.0.zip

Documentation URL

https://github.com/ka-zo/spec-kit-preset-test-first-governance/blob/main/README.md

License

MIT

Required Spec Kit Version

=0.12.11

Required Extensions (optional)

None.

Templates Provided

  • constitution-template — appends test-first governance principles for TDD, BDD, ATDD, and quality gates
  • spec-template — appends evidence ownership, Gherkin, traceability, edge-case, and acceptance-coverage sections
  • plan-template — appends test architecture, tooling, gate applicability, threshold, and evidence-retention planning
  • tasks-template — appends test-first task ordering, suite tags, Red-Green-Refactor checkpoints, and validation gates
  • checklist-template — appends reusable TDD, BDD, ATDD, and quality-gate criteria
  • test-traceability-template — provides normalized requirement-to-test traceability and a scenario coverage matrix
  • defect-log-template — provides feature-level defect, triage, risk-acceptance, and verification-closure reporting
  • test-summary-template — provides feature-level test-summary and release-evidence reporting
  • overall-test-summary-template — provides aggregate project or release-level test-summary reporting
  • gherkin-feature-template — provides a standalone Gherkin feature template for BDD and ATDD scenarios

Commands Provided

  • speckit.constitution — adds mandatory test-first principles to constitution generation
  • speckit.specify — adds evidence ownership and Gherkin scenario requirements to specification
  • speckit.plan — adds test architecture, suite directories, tooling, traceability artifacts, and quality gates to planning
  • speckit.tasks — makes applicable TDD, BDD, and ATDD work mandatory and orders it before implementation
  • speckit.checklist — adds test-first quality criteria to checklist generation
  • speckit.analyze — validates traceability, Gherkin mirroring, scenario coverage, and gate completeness
  • speckit.implement — governs implementation through Red-Green-Refactor cycles and mandatory validation gates
  • speckit.converge — creates an aggregate project or release-level test summary

Number of Scripts (optional)

None.

Tags

tdd, bdd, atdd, quality-gates, traceability

Key Features

  • Governs incremental Red-Green-Refactor development for production logic
  • Requires coverage-complete, non-duplicative BDD and ATDD scenarios where applicable
  • Establishes explicit suite ownership while allowing evidence to satisfy multiple roles without duplication
  • Maintains requirement-to-test traceability and a scenario coverage matrix
  • Produces feature-level defect logs, traceability reports, and test summaries
  • Produces an aggregate rolling or release-specific test summary
  • Applies risk-based coverage, linting, formatting, static-analysis, security, and runtime quality gates
  • Supports governed N/A decisions with rationale and alternative evidence
  • Wraps the Spec Kit workflow from constitution through implementation, analysis, and convergence
  • Is designed to compose with other presets while taking high priority for test-first governance

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
  • Linked README (Documentation URL) explains how to use this preset and includes a valid specify preset add ... command (preferably specify preset add --from <download-url> using the exact download URL)
  • LICENSE file included
  • GitHub release created with version tag
  • Preset ID follows naming conventions (lowercase-with-hyphens)

Related PR: #3491

Metadata

Metadata

Assignees

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions