Files
sar/.agents/skills/wds-3-scenarios/data/validation-standards.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

59 lines
1.6 KiB
Markdown

# WDS Scenario Validation Standards
Reference document for Phase 3 validation steps.
---
## What Makes a Valid Scenario
### Minimum Requirements (must pass)
1. All 7 components present (name, feature, entry, mental state, success, path, TM connections)
2. Path is truly linear (zero branches)
3. Mental state is specific and visceral
4. Both success goals are measurable
5. Trigger Map connections are explicit
### Quality Thresholds
- Completeness: 6/7 minimum
- Quality: 5/7 minimum
- Mistakes avoided: 6/6 (all must be avoided)
- Best practices: 2/4 minimum
---
## WDS Navigation Conventions
### Page Naming
- Use user-facing names (not technical: "Tjänster", not "services-page")
- Consistent naming across scenarios (same page = same name)
- Include page purpose in descriptions
### Flow Rules
- Entry page must be reachable from the described discovery method
- Each step transitions naturally to the next
- Final step has clear success marker (✓)
- No dead ends, no impossible jumps
### Shared Pages
- Pages appearing in 2+ scenarios must serve consistent purposes
- Shared pages should accommodate all relevant personas
---
## SEO Integration
### Phase 1 → Phase 3 Connection
- Every page should map to at least one keyword from the Phase 1 keyword map
- Page names should be compatible with planned URL slugs
- No keyword cannibalization (two pages competing for same keyword)
---
## Validation Severity Levels
| Level | Meaning | Action |
|-------|---------|--------|
| ❌ Critical | Blocks Phase 4 progress | Must fix before handover |
| ⚠️ Warning | Quality concern | Should fix, can proceed |
| ✅ Pass | Meets standards | No action needed |