Skip to content

[Extension]: Add golden-demo #3127

Description

@jasstt

Extension ID

golden-demo

Extension Name

Golden Demo

Version

0.1.0

Description

Adds behavioral drift detection to the SDD workflow. After planning,
extracts acceptance criteria from spec.md/plan.md into
.specify/golden-demo/test-vectors.md. After implementation, runs a
dry-run drift report against those vectors — comparing intended
behavior (spec) with implemented behavior (code).

Author

jasstt

Repository URL

https://github.com/jasstt/spec-kit-golden-demo

Download URL

https://github.com/jasstt/spec-kit-golden-demo/archive/refs/tags/v0.1.0.zip

License

MIT

Homepage (optional)

No response

Documentation URL (optional)

No response

Changelog URL (optional)

No response

Required Spec Kit Version

=0.1.0

Required Tools (optional)

Number of Commands

2

Number of Hooks (optional)

No response

Tags

testing, drift-detection, behavioral-oracle, tdd, quality

Key Features

  • Automatically scans spec.md and plan.md for acceptance criteria during the plan phase.
  • Extracts discovered acceptance criteria into a dedicated .specify/golden-demo/test-vectors.md artifact.
  • Connects to the after_plan hook to generate these test vectors seamlessly.
  • Connects to the after_implement hook to perform a dry-run behavioral drift check against the generated vectors.
  • Provides a zero-TDD path foundation by synthesizing behavioral vectors for projects not using traditional test files.

Testing Checklist

  • Extension installs successfully via download URL
  • All commands execute without errors
  • Documentation is complete and accurate
  • No security vulnerabilities identified
  • Tested on at least one real project

Submission Requirements

  • Valid extension.yml manifest included
  • README.md with installation and usage instructions
  • LICENSE file included
  • GitHub release created with version tag
  • All command files exist and are properly formatted
  • Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on

  • Windows 11 (PowerShell) with Spec Kit v0.11.4

Test project: Local dummy project initialized via specify init golden-demo-test --integration claude

Test scenarios:

  1. Initialized a fresh Spec Kit project and installed the extension using specify extension add --dev.
  2. Verified the extension successfully registered via specify extension list.
  3. Validated that the after_plan hook triggers correctly and parses acceptance criteria from specs into .specify/golden-demo/test-vectors.md.
  4. Validated that the after_implement hook reads the output artifact and correctly executes the dry-run output to the console.

Example Usage

# Install extension
specify extension add golden-demo --from https://github.com/jasstt/spec-kit-golden-demo/archive/refs/tags/v0.1.0.zip

# The commands trigger automatically via hooks during normal SDD workflows:
# 1. Runs after planning:
/speckit.plan
# Prompts: "Golden Demo: extract test vectors from spec and plan?"

# 2. Runs after implementation:
/speckit.implement
# Prompts: "Golden Demo: run behavioral drift check?"

Proposed Catalog Entry

**Proposed Catalog Entry**

{
  "golden-demo": {
    "name": "Golden Demo",
    "id": "golden-demo",
    "description": "Extracts acceptance criteria from specs, builds test vectors, and produces a behavioral drift report — complementary to Architecture Guard and CDD.",
    "author": "jasstt",
    "version": "0.1.0",
    "download_url": "https://github.com/jasstt/spec-kit-golden-demo/archive/refs/tags/v0.1.0.zip",
    "repository": "https://github.com/jasstt/spec-kit-golden-demo",
    "homepage": "https://github.com/jasstt/spec-kit-golden-demo",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.1.0"
    },
    "provides": {
      "commands": 2
    },
    "tags": ["testing", "drift-detection", "behavioral-oracle", "tdd", "quality"],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-06-27T00:00:00Z",
    "updated_at": "2026-06-27T00:00:00Z"
  }
}

Additional Context

No response

Metadata

Metadata

Assignees

Type

No type
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