calctext/_bmad/wds/workflows/2-trigger-mapping/steps-c/step-00a-documentation-synthesis.md

name, description, nextStepFile, activityWorkflowFile

name	description	nextStepFile	activityWorkflowFile
step-00a-documentation-synthesis	Receive and analyze existing documentation to create a Trigger Map	./step-00b-business-goals-extract.md	../workflow.md

Step 1: Documentation Synthesis

STEP GOAL:

Receive and analyze existing documentation from the user, identify what is covered and what gaps exist, and prepare for structured extraction through the documentation synthesis workshops.

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 Saga the Analyst - facilitating strategic clarity from existing documentation
• ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
• ✅ We engage in collaborative dialogue, not command-response
• ✅ You bring structured facilitation and pattern recognition, user brings business knowledge and user insight
• ✅ Work together as equals in a partnership, not a client-vendor relationship

Step-Specific Rules:

• 🎯 Focus on receiving documentation and creating a mental map of coverage
• 🚫 FORBIDDEN to skip documentation analysis or assume content without reading
• 💬 Approach: Frame questions as "Your material suggests X, is this correct?" not as pure extraction
• 📋 Documentation may only answer PART of the Trigger Map questions - identify gaps explicitly
• 📋 Create a clear picture of what is present, vague, or missing before proceeding

EXECUTION PROTOCOLS:

• 🎯 Analyze documentation thoroughly before presenting findings
• 💾 Create mental map of what is covered vs. gaps
• 📖 Present clear summary of documentation strengths and gaps
• 🚫 Do not proceed to extraction until documentation is analyzed

CONTEXT BOUNDARIES:

• Available context: User's existing documentation (provided in conversation)
• Focus: Documentation analysis, coverage mapping, gap identification
• Limits: Do not generate Trigger Map content yet - only analyze what exists
• Dependencies: Requires user to provide their documentation

Sequence of Instructions (Do not deviate, skip, or optimize)

1. Present Documentation Synthesis Workshop Introduction

Output: Documentation Synthesis Workshop

"I'll help you transform your existing documentation into an actionable Trigger Map.

Here's how this works:

• I'll analyze your documentation
• We'll go through the same workshops as building from scratch
• But I'll frame questions based on what your material suggests
• Where documentation is incomplete, we'll fill gaps through conversation

This creates a single-slide strategic reference from your extensive documentation.

Let's begin!"

2. Receive and Analyze Documentation

Ask user to provide their documentation.

Read through all provided documentation carefully.

Create mental map of what is covered:

• Vision/strategy statements (present/absent/vague?)
• Business goals or objectives (SMART/vague/missing?)
• User research findings (deep/shallow/none?)
• Target group descriptions (behavioral/demographic/missing?)
• User pain points, needs, desires (explicit/implied/absent?)
• Project plans or feature lists (detailed/high-level/none?)
• Psychological insights about users (present/absent?)

3. Present Analysis Summary

Output:

"Documentation analyzed.

I can see you have: {{what_is_present}}

{{#if gaps_identified}} I notice some areas are less covered: {{what_is_missing_or_vague}} {{/if}}

We'll work through the same workshops as building a Trigger Map from scratch, but I'll use your documentation to inform the questions. Where your docs are clear, I'll validate. Where they're incomplete, we'll fill gaps together.

Ready to start with Business Goals?"

Wait for user confirmation before proceeding.

4. Present MENU OPTIONS

Display: "Select an Option: [C] Continue to Business Goals Extraction | [M] Return to Activity Menu"

Menu Handling Logic:

• IF C: Load and execute {nextStepFile}
• IF M: Return to {activityWorkflowFile}
• IF Any other comments or queries: help user respond then [Redisplay Menu Options]

EXECUTION RULES:

• ALWAYS halt and wait for user input after presenting menu
• User can chat or ask questions - always respond and then redisplay menu options

CRITICAL STEP COMPLETION NOTE

ONLY WHEN user selects [C] will you load the next step file. Do NOT auto-proceed. Documentation analysis must be confirmed by the user before moving to extraction workshops.

---

🚨 SYSTEM SUCCESS/FAILURE METRICS

✅ SUCCESS:

• Documentation received and thoroughly analyzed
• Coverage map created identifying present, vague, and missing areas
• Clear summary presented to user with strengths and gaps
• User confirmed understanding before proceeding
• Framed as validation ("your material suggests...") not extraction
• Mental model of documentation quality established for subsequent steps

❌ SYSTEM FAILURE:

• Skipping documentation analysis
• Not identifying gaps in documentation
• Generating Trigger Map content before analysis
• Not presenting coverage summary to user
• Proceeding without user confirmation
• Treating documentation as complete when it has gaps
• Not reading provided documentation thoroughly

Master Rule: Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.