Files
sar/.claude/skills/wds-1-project-brief/data/positioning-reflect-confirm.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

3.4 KiB

Substep 3: Reflect & Confirm

Task

Synthesize what you heard into positioning components and get user confirmation before creating final statement.

Instructions

1. Synthesize Your Understanding

Present the positioning components you captured:

Format:

"Here's what I'm hearing about your positioning:

Target Customer: [who you heard] Their Need: [problem/opportunity you heard] Product Category: [how you'd categorize it] Key Benefit: [primary value you heard] Alternatives: [what people use instead] What Makes It Different: [differentiator you heard]

Am I capturing this right? Anything to adjust or clarify?"

2. Handle User Response

If user confirms:

  • → Proceed to Substep 4 (synthesize final statement)

If user corrects:

  • Listen carefully to what they adjust
  • Update your understanding
  • Reflect back the correction: "Got it - so [corrected understanding]"
  • Ask if that's better
  • Once confirmed → Proceed to Substep 4

If user says "I don't know" or seems uncertain:

  • Help them think through it: "Let's think about [component] - based on what you told me about [context], what would make sense?"
  • Guide them to clarity, don't force a template answer

3. Document What Was Misunderstood

For design log 07-positioning.md:

In the Reflection Checkpoint section, record:

  • Your synthesis (what you presented)
  • Whether user confirmed or corrected
  • If corrected: What you got wrong and what the actual answer was

This creates a learning record for improving agent understanding quality.


Example

Agent: "Here's what I'm hearing about Källa Fordonservice's positioning:

Target Customer: Summer tourists and year-round locals in northern Öland who need vehicle service Their Need: Quick, reliable help when vehicle breaks down - often uncertain if a garage can handle their specific vehicle type Product Category: Full-spectrum auto service garage Key Benefit: Peace of mind - comprehensive service for any vehicle type (lawnmowers to tour buses) from a trusted, certified provider Alternatives: Garages in Borgholm, calling around to multiple shops What Makes It Different: Only comprehensive option in northern Öland, handles ALL vehicle types, 20+ years experience, AutoExperten certified

Am I capturing this right?"

User: "Yeah, that's it. I'd say the main customers are actually more the locals year-round, but summer tourists are more visible because they're stressed."

Agent: "Got it - so year-round locals are primary, summer tourists are a distinct seasonal segment. Both matter, but locals are the core?"

User: "Exactly."

Agent: [Updates understanding, proceeds to Substep 4]

Design Log Update (dialog/07-positioning.md):

### Reflection Checkpoint

**Agent Synthesis:**
Target: Summer tourists + locals (tourist-focused)
Need: Quick help for vehicle breakdowns, uncertainty about service
Category: Full-spectrum garage
Benefit: Peace of mind for any vehicle type
Alternatives: Borgholm garages
Differentiator: Only comprehensive northern Öland option, all vehicles, certified

**User Response:** Corrected

**What Was Misunderstood:**
- Agent emphasized tourists over locals
- Actual: Locals are primary customer base, tourists are seasonal (but visible/stressed)

Next

Once user confirms understanding, load and execute: 04-synthesize-document.md