Files
sar/.agents/skills/wds-8-product-evolution/workflow-deploy.md
julian 17c08e6392 chore: initial monorepo scaffold + WDS Phase 1+2 artifacts
- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24)
- apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004)
- apps/web: React 19 + Vite 8 (ESM)
- libs/shared/api-interface: Zod contract base
- Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit
- WDS artifacts:
  - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs)
  - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact)
- Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md
- AGENTS.md + README.md como entrada para devs/agentes

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 14:34:20 +00:00

2.0 KiB

name, description, borrows_from
name description borrows_from
deploy Create PR and deliver the improvement to the team Phase 4 [H] (design delivery)

Deploy

Goal: Package the tested improvement as a PR and deliver it to the development team.


INITIALIZATION

Design Log

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

Steps

Step 1: Pre-Deploy Checklist

Verify everything is ready:

  • All acceptance criteria pass (from [T] test report)
  • Branch is clean (no uncommitted changes)
  • Commits are logical and well-described
  • No unrelated changes included
  • Documentation updated (if applicable)

Step 2: Create Pull Request

Create a PR from the evolution branch:

gh pr create --title "[Improvement]: [Brief description]" --body "..."

PR body includes:

  • What changed — Summary of the improvement
  • Why — Link to scenario and analysis
  • How to test — Steps from the test report
  • Screenshots — Before/after if visual change
  • Acceptance criteria — Checklist from spec

Step 3: Package Delivery Context

Create a delivery summary at {output_folder}/evolution/deliveries/:

# Delivery: [Scenario Name]

## PR
[Link to PR]

## Artifacts
- Analysis: [link]
- Scenario: [link]
- Specification: [link]
- Test Report: [link]

## Change Summary
[What was changed and why]

## Impact
[Expected improvement based on success criteria]

## Monitoring
[What to watch after deployment — metrics, error rates, user feedback]

Step 4: Notify Team

If the project uses design log tracking or team notifications:

  1. Create completion notification
  2. Reference all artifacts (analysis → scenario → spec → test → PR)
  3. Include any monitoring instructions

Step 5: Plan Next Cycle

After deployment:

  1. Archive this improvement cycle
  2. Review remaining improvement targets from [A] analysis
  3. Suggest next target or new analysis round

AFTER COMPLETION

  1. Update design log with completed improvement
  2. Return to Phase 8 Activity Menu for next cycle