Skip to content

v0.2.0

Adds a platform-adoption reference domain, a format-agnostic report intermediate representation, and a full documentation site.

Highlights

  • Platform Adoption domain — a fourth reference domain measuring adoption and leverage of internal platform libraries across the organization's Go repositories via dependency analysis.
  • ReportIR — a format-agnostic intermediate representation of a report, with a JSON renderer and HTMLFromIR, so a report can be computed once and cached, served as JSON, or rendered in more than one format.
  • Documentation site — a MkDocs Material site published at productbuildershq.com/scale.

Added

  • Platform Adoption domain (catalog/domains/platform.json) — library existence (Standards), per-library adoption rates (Consumption / adoption), and the reuse leverage they create (Leverage). The embedded reference catalog now seeds four domains: api, observability, platform, security.
  • ReportIR intermediate representation (report) — BuildIR constructs it, JSON renders it as formatted JSON, and HTMLFromIR renders the HTML story report from a pre-built or cached IR. It carries all computed data (aspects, movers, domains, capabilities, coverage) without requiring the source Framework or Assessment.

Documentation

  • MkDocs Material documentation site under docs/ — getting started, the five aspects, information model, catalog authoring, reports & web component, and the framework / assessment / CLI reference.
  • CLAUDE.md documenting the type/catalog conventions and the framework.json rebuild step.
  • A 2026-Q3 platform assessment example (examples/assessments/).
  • Catalog authoring guide and roadmap; roadmap updated for completed PRISM integration.

Build & Infrastructure

  • Committed assembled framework.json export bundle at the repo root (the deterministic output of scale export) so the full framework is browsable on GitHub.
  • GitHub Actions workflow to build the docs (mkdocs build --strict) on every docs change and publish to GitHub Pages on main.

Dependencies

  • Bump github.com/grokify/prism-core from 0.3.0 to 0.4.0.
  • Bump github.com/buger/jsonparser from 1.2.0 to 1.6.1.

Upgrading

No breaking API changes. The reference catalog gains the platform domain, so code that enumerates catalog.Default() domains will see four domains instead of three. Regenerate the root framework.json after any catalog change with go run ./cmd/scale export -catalog catalog -o framework.json.