Skip to content

v1.3.0 — Lifecycle Expansion

Choose a tag to compare

View all tags
@VaiYav VaiYav released this 01 Apr 14:07
· 32 commits to main since this release
v1.3.0
c8b226f

Product Forge v1.3.0 — Lifecycle Expansion

Product Forge now covers the full product lifecycle with 14 phases, cross-artifact consistency checking, and formal change management — up from 9 phases in v1.2.1.

What's New

5 New Commands

Command Phase Description
sync-verify Cross-cutting 7-layer artifact consistency checker. Detects forward drift (spec not in code) and backward drift (code decisions not in spec). Runs automatically between phase transitions (--quick) or full scan on demand. Human-in-the-loop for every CRITICAL/WARNING resolution.
pre-impl-review 5C Combined design review + architecture review + risk assessment before writing any code. Checks state completeness, UX compliance, accessibility, structural soundness, NFR coverage. Produces a risk register with rollout strategy recommendation.
code-review 6B Multi-agent code review with 4 parallel dimensions: Quality (SOLID/DRY), Security (OWASP surface scan from plan.md), Patterns (consistency with codebase-analysis.md), Tests (coverage vs spec.md). Findings use REV-NNN IDs.
release-readiness 9 Pre-ship checklist: feature flags, rollout/rollback strategy, documentation, monitoring & alerts, analytics, deployment dependencies. Consolidates api-docs + security-check + tracking-plan status into one gate.
change-request Cross-cutting Formal scope change management. Captures change → impact analysis across all artifacts → effort delta → decision gate → propagates with CR-NNN markers → runs sync-verify. Deferred changes tracked in backlog.md.

Upgraded Commands

  • forge.md — Full rewrite: 14 phases (was 9), Phase 0 in orchestrator, auto sync-verify between transitions, complete gate audit trail
  • implement.md — Progressive verification every N tasks with implementation-log.md. CRITICAL drift pauses implementation with user options
  • status.md — Shows all 14 phases, gate audit trail, sync-verify history, change request tracking
  • bridge.md — Now delegates to Product Forge plan/tasks wrappers for cross-validation benefits

Schema & Configuration

  • .forge-status.yml schema v2 — schema_version field for migration detection, 5 new phase fields (pre_impl_review, code_review, release_readiness, problem_discovery, retrospective), gates:[] audit trail, sync_runs: history, change_requests:[] tracking, documented extension blocks for all supporting commands
  • Auto-migration from v1 to v2 schema — existing features are upgraded transparently
  • 3 new config keys — progressive_verify_interval (default: 3), auto_sync_between_phases (default: true), release_readiness (default: "optional")

Bug Fixes (16 issues)

  • Fix CR-NNN ID collision between change-request and code-review (code review now uses REV-NNN)
  • Rewrite docs/phases.md (was frozen at v1.0 content — now documents all 14 phases)
  • Fix README verify version, product-spec.md template, forge description
  • Update problem-discovery.md and research.md to write schema v2
  • Document 3 new config keys in docs/config.md
  • Fix bridge.md to delegate to product-forge wrappers instead of SpecKit directly
  • Relax retrospective.md prerequisite (verify:completed minimum, testing optional)
  • Complete status.md detailed view with all phases
  • Document completed_with_known_issues state and supporting command schema fields

Updated Lifecycle

Phase 0   Problem Discovery (optional)
Phase 1   Research (parallel: competitors, UX, codebase, tech, metrics)
Phase 2   Product Spec (interactive, multi-document)
Phase 3   Revalidation (iterative approval cycle)
Phase 4   Bridge → SpecKit (spec.md generation)
Phase 5   Plan (technical plan with cross-validation)
Phase 5B  Tasks (task breakdown with coverage validation)
Phase 5C  Pre-Implementation Review (design + arch + risk)        ← NEW
Phase 6   Implementation (with progressive verification)          ← UPGRADED
Phase 6B  Code Review (multi-agent: quality/security/patterns)    ← NEW
Phase 7   Verify Full (6-layer traceability check)
Phase 8A  Test Plan (optional — Playwright test generation)
Phase 8B  Test Run (optional — execution with auto-fix loop)
Phase 9   Release Readiness (optional — pre-ship checklist)       ← NEW
Post:     Retrospective (predicted vs actual metrics)

Cross-cutting:
  sync-verify (artifact consistency, runnable anytime)            ← NEW
  change-request (formal scope change management)                 ← NEW

Install / Update

# Install
specify extension add product-forge --from https://github.com/VaiYav/speckit-product-forge/archive/refs/tags/v1.3.0.zip

# Update
specify extension update product-forge --from https://github.com/VaiYav/speckit-product-forge/archive/refs/tags/v1.3.0.zip

Full Changelog

See CHANGELOG.md for complete details.

Assets 2
Loading