Files
bi-agents/_bmad/wds/workflows/3-scenarios/steps-c/step-03-build-strategic-context.md
Cassel 647cbec54f docs: update all documentation and add AI tooling configs
- 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>
2026-03-19 13:29:03 -04:00

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:

  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.