- 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>
192 lines
6.8 KiB
Markdown
192 lines
6.8 KiB
Markdown
---
|
|
name: 'step-03-build-strategic-context'
|
|
description: 'Build strategic context from Trigger Map to identify which scenarios to create'
|
|
|
|
# File References
|
|
nextStepFile: './step-04-suggest-scenarios.md'
|
|
---
|
|
|
|
# Step 3: Build Strategic Context
|
|
|
|
## STEP GOAL:
|
|
|
|
Extract strategic context from the Trigger Map — tracing paths from business goals through personas and driving forces to transactions — assign pages to each scenario chain, prioritize them, and verify complete coverage of all pages.
|
|
|
|
## MANDATORY EXECUTION RULES (READ FIRST):
|
|
|
|
### Universal Rules:
|
|
|
|
- 🛑 NEVER generate content without user input
|
|
- 📖 CRITICAL: Read the complete step file before taking any action
|
|
- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
|
|
- 📋 YOU ARE A FACILITATOR, not a content generator
|
|
- ✅ YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config `{communication_language}`
|
|
|
|
### Role Reinforcement:
|
|
|
|
- ✅ You are a UX Scenario Facilitator collaborating with the project owner
|
|
- ✅ If you already have been given a name, communication_style and identity, continue to use those while playing this new role
|
|
- ✅ We engage in collaborative dialogue, not command-response
|
|
- ✅ You bring scenario thinking and user journey expertise, user brings their project knowledge, together we create concrete UX scenario outlines
|
|
- ✅ Maintain collaborative equal-partner tone throughout
|
|
|
|
### Step-Specific Rules:
|
|
|
|
- 🎯 Focus only on building strategic context, assigning pages, and prioritizing
|
|
- 🚫 FORBIDDEN to create scenario outlines — only identify and plan scenarios
|
|
- 💬 Approach: Systematically trace paths from business goals to user actions
|
|
- 📋 Every page from the inventory must be assigned to exactly one scenario chain
|
|
|
|
## EXECUTION PROTOCOLS:
|
|
|
|
- 🔗 Trace complete chains from Business Goal → Persona → Force → Transaction → Scenario
|
|
- 📋 Answer all 7 Decision Matrix questions for each scenario chain
|
|
- 📊 Assign pages ensuring no repetition and full coverage
|
|
- 🚫 FORBIDDEN to leave any page unassigned
|
|
|
|
## CONTEXT BOUNDARIES:
|
|
|
|
- Available context: Product Brief, Trigger Map, approved page inventory from Step 2
|
|
- Focus: Strategic context extraction, page assignment, prioritization
|
|
- Limits: No scenario outlining, no file creation — only planning
|
|
- Dependencies: Approved scope analysis from Step 2
|
|
|
|
## Sequence of Instructions (Do not deviate, skip, or optimize)
|
|
|
|
### 1. Build Strategic Context Chains
|
|
|
|
**What is a strategic context chain?**
|
|
|
|
A strategic context chain traces the path from business strategy to user action:
|
|
|
|
```
|
|
Business Goal → Persona → Driving Force → Transaction → Scenario
|
|
```
|
|
|
|
**Example:**
|
|
```
|
|
BG01: Reduce info calls by 40%
|
|
→ Hasse (Primary - stressed tourist)
|
|
→ Fear: Being stranded with broken RV
|
|
→ Transaction: Confirm mechanic capability + get directions
|
|
→ 01: "Hasse's Emergency Search"
|
|
```
|
|
|
|
For **each business goal** from the Trigger Map:
|
|
|
|
1. Identify which persona(s) most directly drive this goal
|
|
2. Identify which driving forces (wants AND fears) connect to this goal
|
|
3. Determine the specific transaction/action that fulfills it
|
|
4. Name a candidate scenario using the persona's name
|
|
|
|
**For each scenario chain, answer the Decision Matrix (all 7 required):**
|
|
|
|
| # | Question | Answer |
|
|
|---|----------|--------|
|
|
| 1 | Which business goal? | [Specific goal from Trigger Map] |
|
|
| 2 | Which persona? | [Name + priority level] |
|
|
| 3 | Which driving force? | [Specific want or fear] |
|
|
| 4 | What's the transaction? | [Concrete action user takes] |
|
|
| 5 | Where does user come from? | [Natural starting point - be specific] |
|
|
| 6 | What value does user get? | [Tangible outcome] |
|
|
| 7 | What value does business get? | [Measurable result] |
|
|
|
|
### 2. Assign Pages to Scenario Chains
|
|
|
|
For each scenario chain, list which pages from the inventory (Step 02) the user visits.
|
|
|
|
**Rules:**
|
|
- Each page appears in exactly ONE scenario chain (no repetition)
|
|
- If a page could fit multiple scenarios, assign it to the highest-priority one
|
|
- Shared elements (navigation, footer) are excluded from page assignment
|
|
|
|
### 3. Prioritize
|
|
|
|
Rank the scenario chains:
|
|
|
|
**Priority 1 — Critical Path:**
|
|
- Top business goal + primary persona + core product value
|
|
- These scenarios are created first and in most detail
|
|
|
|
**Priority 2 — Supporting:**
|
|
- Secondary persona scenarios, alternative entry paths
|
|
- Important but not the strategic core
|
|
|
|
**Priority 3 — Edge Cases:**
|
|
- Admin tasks, rare user segments, error recovery
|
|
- May be deferred to later phases
|
|
|
|
### 4. Coverage Check
|
|
|
|
After building all scenario chains, verify:
|
|
|
|
- [ ] Every page from inventory is assigned to exactly one scenario chain
|
|
- [ ] Primary persona has at least one Priority 1 scenario
|
|
- [ ] Top business goal is addressed by at least one scenario
|
|
- [ ] No page appears in multiple scenarios
|
|
|
|
**If pages are unassigned:** Create additional scenario chains or expand existing ones to cover them.
|
|
|
|
### 5. Present Scenario Chain List
|
|
|
|
Present the complete scenario chain list:
|
|
|
|
```
|
|
## Strategic Context Chains
|
|
|
|
### Priority 1
|
|
**Chain 01:** [Business Goal] → [Persona] → [Force] → [Transaction]
|
|
- Scenario: 01-[slug]
|
|
- Pages: [list]
|
|
|
|
### Priority 2
|
|
**Chain 02:** [Business Goal] → [Persona] → [Force] → [Transaction]
|
|
- Scenario: 02-[slug]
|
|
- Pages: [list]
|
|
|
|
### Coverage: [X/Y] pages assigned
|
|
```
|
|
|
|
### 6. Present MENU OPTIONS
|
|
|
|
Display: "Are you ready to [C] Continue to Scenario Suggestions?"
|
|
|
|
#### Menu Handling Logic:
|
|
|
|
- IF C: Load, read entire file, then execute {nextStepFile}
|
|
|
|
#### EXECUTION RULES:
|
|
|
|
- ALWAYS halt and wait for user input after presenting menu
|
|
- ONLY proceed to next step when user selects 'C'
|
|
- After other menu items execution, return to this menu
|
|
- User can chat or ask questions - always respond and then end with display again of the menu options
|
|
|
|
## CRITICAL STEP COMPLETION NOTE
|
|
|
|
ONLY WHEN [C continue option] is selected and [scenario chain list with full page coverage presented], will you then load and read fully `{nextStepFile}` to execute and begin scenario suggestions.
|
|
|
|
---
|
|
|
|
## 🚨 SYSTEM SUCCESS/FAILURE METRICS
|
|
|
|
### ✅ SUCCESS:
|
|
|
|
- All business goals traced through complete strategic context chains
|
|
- All 7 Decision Matrix questions answered for each scenario chain
|
|
- Every page from inventory assigned to exactly one scenario chain
|
|
- Scenario chains prioritized with clear rationale
|
|
- Coverage check passes (all pages assigned, no duplicates)
|
|
- Complete scenario chain list presented to user
|
|
- Menu presented and user input handled correctly
|
|
|
|
### ❌ SYSTEM FAILURE:
|
|
|
|
- Leaving pages unassigned
|
|
- Assigning pages to multiple scenario chains
|
|
- Skipping Decision Matrix questions
|
|
- Creating scenario outlines during this step
|
|
- Not verifying coverage before proceeding
|
|
|
|
**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
|