name: wds-8-product-evolution

description: Brownfield improvements — the full WDS pipeline in miniature for existing products

Phase 8: Product Evolution

Goal: Improve existing products through targeted, incremental changes — running the full WDS pipeline in miniature for each improvement.

Your Role: You work like a developer on the team. Pick a view that needs improving, scope it as a scenario, design the solution, implement it in a branch, test it, and deploy. Each cycle is one focused improvement.

WORKFLOW ARCHITECTURE

Phase 8 is menu-driven, not linear. Each activity is a compressed version of a full WDS phase.

Core Principles

Brownfield First: You're joining an existing product, not building from scratch
Focused Scope: One view, one scenario, one improvement at a time
Full Pipeline in Miniature: Analyze → Scope → Design → Implement → Test → Deploy
Branch-Based: Every change lives in its own branch until deployed
Kaizen: Small, incremental, data-driven — each cycle informs the next

Step Processing Rules

READ COMPLETELY: Always read the entire step file before action
FOLLOW SEQUENCE: Execute all sections in order
WAIT FOR INPUT: Halt at decision points and wait for user
SAVE STATE: Update design log when completing steps

INITIALIZATION

1. Configuration Loading

Load and read full config from {project-root}/_bmad/wds/config.yaml and resolve:

project_name, output_folder, user_name
communication_language, document_output_language

2. Design Log

Read {output_folder}/_progress/00-design-log.md. Check Current and Backlog for context.

3. Activity Menu

What would you like to do?

[A] Analyze Product          — Understand current state, find improvement targets
[S] Scope Improvement        — Create a scenario for a specific update
[D] Design Solution          — Sketch and specify the update
[I] Implement                — Code in a new branch
[T] Acceptance Test          — Test against spec
[P] Deploy                   — PR and deliver to the team

Activity Routing

Choice	Workflow File	Steps	Borrows From
[A]	workflow-analyze.md	steps-a/	Phase 3 (scenarios)
[S]	workflow-scope.md	Inline	Phase 3 (scenarios)
[D]	workflow-design.md	steps-d/	Phase 4 (UX design)
[I]	workflow-implement.md	Inline	Phase 5 (development)
[T]	workflow-test.md	steps-t/	Phase 5 T
[P]	workflow-deploy.md	steps-p/	Phase 4 H

REFERENCE CONTENT

Location	Purpose
`data/kaizen-principles.md`	Kaizen philosophy and patterns
`data/existing-product-guide.md`	Brownfield project guide
`data/context-templates.md`	Context gathering templates
`data/design-templates.md`	Design update templates
`data/delivery-templates.md`	Delivery packaging templates
`data/monitoring-templates.md`	Monitoring and impact templates

OUTPUT

Scenarios: {output_folder}/evolution/scenarios/
Specifications: {output_folder}/evolution/specs/
Test Reports: {output_folder}/evolution/test-reports/
Git branches with implementation

AFTER COMPLETION

Update design log
Suggest next improvement or return to Activity Menu

workflow.md 3.3 KB Permalink Verlauf Originalformat