Skip to content

v0.3.0

Release Date: 2026-04-26

Highlights

  • Extended Value Stream Layers - Full value stream coverage from requirements to support
  • Quality Domain - ISO 25010-aligned metrics for code quality and testing
  • Team Topologies Support - Stream-aligned, platform, enabling, and overlay team patterns
  • Analysis Package - Gap detection and initiative recommendations
  • Structured-Plan Export - Convert PRISM documents to OKR, V2MOM, and Roadmap formats
  • Developer Documentation - Architecture and contributing guides for open source contributors

Added

Value Stream Layers

Extended layer model covering the full value stream:

Layer Description
requirements Product ideation, specifications, and design
code Application code, libraries, and dependencies
infra Cloud resources, networking, and platform services
runtime Running services, containers, and workloads
adoption Product analytics, user engagement, and self-service
support Customer support, incident management, and escalations

Quality Domain

  • quality domain constant for code quality and testing metrics
  • ISO 25010 alignment for software quality characteristics
  • Integration with existing operations and security domains

Team Topologies

  • Team type with Team Topologies patterns
  • Team types: stream_aligned, platform, enabling, overlay
  • Layer accountability mapping for teams
  • Contact information and ownership tracking

Services

  • Service type with tier, owner team, and layer associations
  • Service-to-metric linkage for SLO tracking
  • Tiered service classification (tier1, tier2, tier3)

Analysis Package (analysis/)

  • Analyze() for comprehensive document analysis
  • Gap detection: maturity gaps, SLO gaps, coverage gaps, initiative gaps
  • Recommendation type for initiative suggestions
  • LLM prompt generation for AI-assisted planning

Export Package (export/)

Integration with structured-plan:

  • ConvertToOKR() - Export goals as OKR objectives with SLO key results
  • ConvertToV2MOM() - Export to Salesforce V2MOM format
  • ConvertToRoadmap() - Export phases as roadmap with deliverables

Maturity Package (maturity/)

Standalone maturity model specifications:

  • Spec type with multi-domain maturity models
  • Criterion for SLO-based level requirements
  • Enabler for implementation tasks
  • XLSX export for maturity model spreadsheets
  • Marp export for maturity model presentations

Output Package (output/)

Multi-format output capabilities:

  • Formatter with text, JSON, markdown, and TOON formats
  • TOON (Token-Optimized Object Notation) for LLM efficiency
  • TableData and DetailData for structured output

Scaffold Package (scaffold/)

Document templates:

  • NewDocument() creates documents with specified domains
  • OperationsMetrics() and SecurityMetrics() example generators

CLI Commands

Layer commands:

  • prism layer list - List all layers with descriptions
  • prism layer show <id> - Show layer details with metrics and golden signals

Team commands:

  • prism team list - List teams grouped by type
  • prism team show <id> - Show team details with services

Service commands:

  • prism service list - List services grouped by layer
  • prism service show <id> - Show service details with metrics

Analysis commands:

  • prism analyze - Analyze document and show gaps
  • prism analyze -f json - Output as JSON for automation
  • prism analyze -f prompt - Generate LLM prompt for recommendations

Export commands:

  • prism export okr - Export as OKR document
  • prism export v2mom - Export as V2MOM document
  • prism export roadmap - Export as roadmap document

Initiative commands:

  • prism initiative list - List initiatives by status
  • prism initiative list --by-phase - Group by phase
  • prism initiative list --by-goal - Group by goal
  • prism initiative show <id> - Show initiative details

Other commands:

  • prism format - Reformat PRISM document

Changed

  • PRISMDocument extended with Layers, Teams, Services arrays
  • Metric type extended with layerId and serviceId references
  • Score calculation updated to handle sparse data gracefully
  • JSON Schema regenerated with new types

Documentation

  • Developer guide with architecture and contributing docs
  • Concepts section with layers, teams, services, and organizational model
  • Operations management documentation with golden signals
  • CLI reference for all new commands
  • Design docs reorganized into docs/design/maturity/ directory
  • Structured-plan integration documentation
  • Maturity strategies and project scoring concepts

Tests

  • CLI tests for layer, team, service commands
  • Score calculation tests with sparse data
  • Analysis package unit tests
  • Export package unit tests for OKR, V2MOM, Roadmap
  • CLI integration tests
  • Cross-platform stdout capture fix for Windows CI

Infrastructure

  • Updated dependencies:
  • github.com/grokify/echartify v0.2.0 (new geometry types)
  • github.com/grokify/structured-plan v0.10.0 (rollout tracking)
  • github.com/plexusone/dashforge v0.2.0
  • github.com/plexusone/omniframe v0.1.0
  • github.com/grokify/oscompat v0.2.0 (testutil package)
  • Example maturity models for operations, security, product, AI domains
  • Updated .gitignore for planning docs and generated files

Upgrade Notes

This release is backward compatible with v0.2.0 documents. New features are additive:

  • Layers, Teams, and Services arrays are optional
  • Existing documents continue to work without modification
  • Add organizational model incrementally as needed

Migration Path

  1. Add Layers - Define your value stream layers
  2. Add Teams - Map your organization using Team Topologies
  3. Add Services - Link services to teams and layers
  4. Update Metrics - Add layerId and serviceId to metrics
  5. Run Analysis - Use prism analyze to identify gaps

Example Usage

# Analyze document for gaps
prism analyze prism.json

# Export to OKR format for structured-plan
prism export okr prism.json -o roadmap.okr.json

# View team topology
prism team list prism.json

# Show service details
prism service show prism.json payments-api