Skip to content

Release v0.16.0

Release Date: 2026-08-15

specification-workflow-spec's full catalog and toolchain merge into this repo, with complete git history preserved via a history-preserving git subtree merge — git blame/git log on any merged file trace to their real original authors and dates. specification-workflow-spec was a standalone repo that incubated a formal, JSON-Schema-backed specification layer to drive VisionSpec's maturity; that work is now integrated back as VisionSpec's own contract layer. The old repo is archived.

This release also folds in a small housekeeping gap since v0.15.0 (a README addition, a routine dependency bump) and the prism-roadmap v0.17.0 upgrade that finally unblocks tools/prism-sync.

Highlights

  • Loader-enforced provenance: a SpecSource declares which workflow owns a spec's template/rubric (or "local"), and a declared source that doesn't actually provide the file is a load-time error
  • Layered rubric schema and hardened aws-one-way-door/ aws-two-way-door workflows, with symmetric optional deepening — MRD (product scale) or OpportunitySpec (feature scale), both feeding PRD synthesis in both doors
  • Catalog registries for pipelines, loops, and integrations, plus the prism-sync tool for syncing roadmap-domain content from prism-roadmap
  • Own DAG/execution-graph type (pkg/workflow) and external spec-workflows repo loader (pkg/workflows) renamed to pkg/execgraph and pkg/reporeader, freeing those import paths for the merged-in catalog and its loader
  • tools/prism-sync's local replace directive is dropped: grokify/prism-roadmap v0.17.0 now ships the v2mom/OST content it depends on, so it builds from a fresh clone for the first time
  • Fixed a real bug the merge surfaced: the workflow-DAG adapter's synthesis dependency edges were a hardcoded table, never reading the actual loaded workflow's synthesis config

Added

  • pkg/workflow — workflow profile types (SpecConfig, Synthesis, Execution) with per-spec template/rubric provenance (SpecSource) enforced at load time
  • pkg/workflows — embedded catalog of 25 default workflow families (0-1, aws-one-way-door, aws-two-way-door, big-tech families, continuous-discovery, design-thinking, enterprise, google, growth, jtbd, lean-startup, pbhq-lite, quick-fix, shapeup, startup, stripe, v2mom families) with composable loaders (embedded, file, chain, resolving) and a cycle guard covering both extends links and explicit spec sources
  • pkg/template, pkg/spectype — spec type registry and filesystem-free (go:embed) template content
  • pkg/diagram, pkg/gate, pkg/synthesis, pkg/layout — workflow visualization (D2/Mermaid), phase-gate types, synthesis dependency rules, filesystem layout conventions
  • pkg/integration, pkg/integrations, pkg/loop, pkg/loops, pkg/pipeline, pkg/pipelines — registries for execution-target integrations, multi-phase loops, and workflow-to-target pipelines, with a cross-reference test validating pipelines against workflows/integrations/spec-types
  • cmd/catalog — viewer for the embedded registries
  • schema/ — JSON Schema generation and embedded schema files for the above
  • tools/prism-sync — nested-module tool copying roadmap-domain templates/rubrics from prism-roadmap with provenance headers, own go.mod so prism-roadmap never enters the main module graph

Changed

  • Breaking: own DAG/execution-graph type (Node, Phase, TopologicalSort) moved from pkg/workflow to pkg/execgraph — the old path now holds the merged-in workflow profile/catalog types instead
  • Breaking: external spec-workflows repository loader (DiscoverRepo, LoadRepo) moved from pkg/workflows to pkg/reporeader — the old path now holds the merged-in embedded catalog instead
  • aws-one-way-door and aws-two-way-door (replacing the earlier product/feature-named profiles) ship normative enterprise contract templates/rubrics and symmetric optional deepening: MRD (product scale) and OpportunitySpec (feature scale) both feed PRD synthesis in both doors

Fixed

  • specworkflow.FromWorkflow's synthesis dependency edges now read the loaded workflow's actual Synthesis config instead of a hardcoded table that never reflected which workflow was loaded
  • Bridge helpers reconciled with sws's SpecSource provenance-pointer type (Template/Rubric fields changed from name strings to provenance pointers): the SpecConfig converter now leaves the now-inapplicable name-override fields unset instead of a type-mismatched assignment, and the MCP raw-profile dump renders the provenance source instead
  • Unrelated pre-existing bug: pkg/eval's ToClaimsReport assigned a time.Time where a *time.Time was expected

Documentation

  • Add ecosystem section to README describing the engine role
  • goals/okr.md — document RoadmapItem OKR linking (RICEByObjective, UnlinkedScoredItems) from the prism-roadmap v0.17.0 upgrade
  • canvas/prioritization.md — document RICE impact/confidence level parsing and validation from the prism-roadmap v0.17.0 upgrade
  • tools/prism-sync README — document the manual sync process and the graduation path to automated CI once prism-roadmap tags a release with the content it depends on

Infrastructure

  • Bump plexusone/structured-evaluation from 0.11.0 to 0.13.0, then to 0.14.0 for the layered-rubric schema
  • Bump grokify/prism-roadmap to v0.17.0 (MoSCoW-optional RoadmapItem, OKR objective/key-result linking, RICE level validation) and drop tools/prism-sync's local replace directive
  • Full commit history from specification-workflow-spec (formerly a standalone repo, now archived) preserved via a history-preserving git subtree merge

Compatibility

Two breaking changes, both relocations rather than removals:

  • Code importing this repo's own pkg/workflow (the DAG/execution-graph type) or pkg/workflows (the external spec-workflows repo loader) needs to update to pkg/execgraph/pkg/reporeader. No known external consumer of these specific internal paths.
  • Everything else is additive.

Installation

go get github.com/ProductBuildersHQ/visionspec@v0.16.0