- Rewrite README.md with current architecture, features and stack - Update docs/API.md with all current endpoints (corporate, BI, client 360) - Update docs/ARCHITECTURE.md with cache, modular queries, services, ETL - Update docs/GUIA-USUARIO.md for all roles (admin, corporate, agente) - Add docs/INDEX.md documentation index - Add PROJETO.md comprehensive project reference - Add BI-CCC-Implementation-Guide.md - Include AI agent configs (.claude, .agents, .gemini, _bmad) - Add netbird VPN configuration - Add status report Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
6.8 KiB
name, description, nextStepFile
| name | description | nextStepFile |
|---|---|---|
| step-03-build-strategic-context | Build strategic context from Trigger Map to identify which scenarios to create | ./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:
- Identify which persona(s) most directly drive this goal
- Identify which driving forces (wants AND fears) connect to this goal
- Determine the specific transaction/action that fulfills it
- 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.