v0.9.0 Release Notes¶

Release Date: 2026-06-08

This release introduces spec-workflows repository integration, enabling organizations to customize workflows, templates, and rubrics through the fork pattern. Auto-discovery makes it seamless to use spec-workflows in any project.

Highlights¶

External spec-workflows repository integration
Auto-discovery of spec-workflows from current directory upward
workflows command to list available methodologies
init --workflow flag for methodology selection
Workflow field in project configuration

What's New¶

Spec-Workflows Integration¶

VisionSpec can now load workflows, templates, and rubrics from external spec-workflows repositories. This enables organizations to fork and customize the standard workflows without modifying visionspec itself.

# Clone the spec-workflows repository
git clone https://github.com/ProductBuildersHQ/spec-workflows ~/.config/visionspec/spec-workflows

# List available workflows (auto-discovers the repo)
visionspec workflows

# Initialize with a specific workflow
visionspec init my-product --workflow=aws-working-backwards/product

Auto-Discovery¶

VisionSpec automatically searches for spec-workflows in this order:

--workflows-repo flag (explicit override)
VISIONSPEC_WORKFLOWS_REPO environment variable
Walk up from current directory looking for spec-workflows/ or .spec-workflows/
~/.config/visionspec/spec-workflows/ (user default)

This mirrors how Claude Code discovers CLAUDE.md files, making it natural for monorepos and nested projects.

Workflows Command¶

# List available workflows
visionspec workflows

# Output:
# Repository: /path/to/spec-workflows
#
# Available workflows (6):
#
#   aws-working-backwards:
#     - aws-working-backwards/product
#     - aws-working-backwards/feature
#
#   big-tech:
#     - big-tech/product
#     - big-tech/feature
#
#   lean-startup:
#     - lean-startup/product
#     - lean-startup/feature

Workflow Selection on Init¶

Projects can now specify which workflow methodology they follow:

# Initialize with AWS Working Backwards for a new product
visionspec init my-product --workflow=aws-working-backwards/product

# Initialize with Lean Startup for a feature
visionspec init my-feature --workflow=lean-startup/feature

The workflow is stored in visionspec.yaml:

name: my-product
workflow: aws-working-backwards/product

Methodology-Specific Templates and Rubrics¶

When a workflow is specified, templates and rubrics are loaded from the methodology-specific directory with fallback to defaults:

spec-workflows/
├── templates/
│   ├── aws-working-backwards/    # Methodology-specific
│   │   └── mrd.md
│   └── default/                  # Fallback
│       ├── mrd.md
│       ├── prd.md
│       └── ...
└── rubrics/
    ├── aws-working-backwards/
    │   └── prd.yaml
    └── default/
        └── prd.yaml

New Package¶

Package	Description
`pkg/workflows`	Spec-workflows repository loading and discovery

CLI Changes¶

New Commands¶

Command	Description
`workflows`	List available workflows from spec-workflows repo

New Flags¶

Flag	Command	Description
`--workflows-repo`	Global	Path to spec-workflows repository
`--workflow`	`init`	Workflow methodology/level to use

Configuration¶

Project Configuration¶

New field in visionspec.yaml:

# Workflow methodology and level
workflow: aws-working-backwards/product

Environment Variables¶

Variable	Description
`VISIONSPEC_WORKFLOWS_REPO`	Path to spec-workflows repository

Companion Repository¶

This release works best with the spec-workflows repository, which provides:

6 workflows (aws-working-backwards, big-tech, lean-startup × product/feature)
Default templates for all spec types
Default rubrics for evaluation
Rule details for AI assistant guidance
Extension framework for organization customization

Installation¶

go install github.com/ProductBuildersHQ/visionspec/cmd/visionspec@v0.9.0

Requirements¶

Go 1.22+
structured-evaluation v0.6.0