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>
This commit is contained in:
156
.claude/skills/wds-8-product-evolution/data/monitoring-guide.md
Normal file
156
.claude/skills/wds-8-product-evolution/data/monitoring-guide.md
Normal file
@@ -0,0 +1,156 @@
|
||||
# Step 07: Monitor Impact
|
||||
|
||||
## Your Task
|
||||
|
||||
Monitor the impact of your Design Delivery (small scope) and measure if it achieved the expected results.
|
||||
|
||||
---
|
||||
|
||||
## Before You Start
|
||||
|
||||
**Ensure you have:**
|
||||
|
||||
- ✅ Completed step 06 (validation complete)
|
||||
- ✅ Design Delivery deployed to production
|
||||
- ✅ Success metrics defined
|
||||
|
||||
---
|
||||
|
||||
## The Kaizen Measurement Cycle
|
||||
|
||||
**改善 (Kaizen) requires measurement:**
|
||||
|
||||
```
|
||||
Ship → Monitor → Learn → Improve → Ship...
|
||||
↑
|
||||
You are here!
|
||||
```
|
||||
|
||||
**Without measurement, you're just guessing!**
|
||||
|
||||
---
|
||||
|
||||
## Set Up Monitoring
|
||||
|
||||
### 1. Define Measurement Period
|
||||
|
||||
**From Design Delivery file:**
|
||||
|
||||
```yaml
|
||||
metrics:
|
||||
measurement_period: '2 weeks after release'
|
||||
```
|
||||
|
||||
### 2. Track Key Metrics
|
||||
|
||||
**See:** [data/monitoring-templates.md](../data/monitoring-templates.md) for Metrics Tracking Dashboard
|
||||
|
||||
### 3. Gather Qualitative Feedback
|
||||
|
||||
**Monitor multiple channels:**
|
||||
|
||||
- User feedback (app reviews, in-app feedback, support tickets)
|
||||
- Team feedback (developer observations, support insights)
|
||||
|
||||
**See:** [data/monitoring-templates.md](../data/monitoring-templates.md) for Qualitative Feedback template
|
||||
|
||||
---
|
||||
|
||||
## Analyze Results
|
||||
|
||||
### After Measurement Period
|
||||
|
||||
**Create:** `analytics/DD-XXX-impact-report.md`
|
||||
|
||||
**See:** [data/monitoring-templates.md](../data/monitoring-templates.md) for Impact Report template
|
||||
|
||||
Key sections:
|
||||
- Executive summary (SUCCESS | PARTIAL | FAILURE)
|
||||
- Metrics results (baseline → target → actual)
|
||||
- What worked / what didn't
|
||||
- Learnings
|
||||
- Recommendations (short-term, long-term)
|
||||
- Next Kaizen cycle opportunity
|
||||
|
||||
---
|
||||
|
||||
## Share Results
|
||||
|
||||
**Communicate impact to team:**
|
||||
|
||||
**See:** [data/monitoring-templates.md](../data/monitoring-templates.md) for Team Results Communication template
|
||||
|
||||
---
|
||||
|
||||
## Update Design Delivery File
|
||||
|
||||
**Final update to `deliveries/DD-XXX-name.yaml`:**
|
||||
|
||||
```yaml
|
||||
delivery:
|
||||
status: 'measured'
|
||||
measurement_complete: '2024-12-28T10:00:00Z'
|
||||
impact_report: 'analytics/DD-XXX-impact-report.md'
|
||||
result: 'success'
|
||||
metrics_achieved:
|
||||
- 'Feature X usage: 58% (target: 60%)'
|
||||
learnings:
|
||||
- 'Onboarding matters for complex features'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Next Step
|
||||
|
||||
After monitoring and learning:
|
||||
|
||||
```
|
||||
[M] Return to Activity Menu — see also data/kaizen-iteration-guide.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Success Metrics
|
||||
|
||||
✅ Measurement period complete
|
||||
✅ All metrics tracked
|
||||
✅ Qualitative feedback gathered
|
||||
✅ Impact report created
|
||||
✅ Results shared with team
|
||||
✅ Learnings documented
|
||||
✅ Next opportunity identified
|
||||
|
||||
---
|
||||
|
||||
## Failure Modes
|
||||
|
||||
❌ Not measuring impact
|
||||
❌ Ending measurement too early
|
||||
❌ Ignoring qualitative feedback
|
||||
❌ Not documenting learnings
|
||||
❌ Not sharing results
|
||||
❌ Not identifying next opportunity
|
||||
|
||||
---
|
||||
|
||||
## Tips
|
||||
|
||||
### DO ✅
|
||||
|
||||
**Be patient:** Give changes time to work, don't end measurement early
|
||||
|
||||
**Be thorough:** Track all metrics, gather qualitative feedback, document learnings
|
||||
|
||||
**Be honest:** Report actual results, acknowledge what didn't work
|
||||
|
||||
### DON'T ❌
|
||||
|
||||
**Don't cherry-pick:** Report all metrics, not just good ones
|
||||
|
||||
**Don't stop measuring:** Kaizen requires continuous measurement
|
||||
|
||||
**Don't skip sharing:** Team needs to know results
|
||||
|
||||
---
|
||||
|
||||
**Remember:** Measurement turns improvements into learnings. Learnings drive the next cycle!
|
||||
Reference in New Issue
Block a user