BMAD-METHOD/common/tasks/create-doc.md

Create Document from Template Task

Purpose

Generate documents from templates by EXECUTING (not just reading) embedded instructions from the perspective of the selected agent persona.

CRITICAL RULES

1. Templates are PROGRAMS - Execute every LLM: instruction exactly as written
2. NEVER show markup - Hide all LLM:, {{placeholders}}, @{examples}, and template syntax
3. STOP and EXECUTE - When you see "apply tasks#" or "execute tasks#", STOP and run that task immediately
4. WAIT for user input - At review points and after elicitation tasks

Execution Flow

0. Check Workflow Plan (if configured)

LLM: Check if plan tracking is enabled in core-config.yaml

• If workflow.trackProgress: true, check for active plan using utils#plan-management
• If plan exists and this document creation is part of the plan:
  • Verify this is the expected next step
  • If out of sequence and enforceSequence: true, warn user and halt without user override
  • If out of sequence and enforceSequence: false, ask for confirmation
• Continue with normal execution after plan check

1. Identify Template

• Load from templates#* or {root}/templates directory
• Agent-specific templates are listed in agent's dependencies
• If agent has templates: [prd-tmpl, architecture-tmpl] for example, then offer to create "PRD" and "Architecture" documents

2. Ask Interaction Mode

1. Incremental - Section by section with reviews
2. YOLO Mode - Complete draft then review (user can type /yolo anytime to switch)

3. Execute Template

• Replace {{placeholders}} with real content
• Execute LLM: instructions as you encounter them
• Process <> loops and ^^CONDITIONS^^
• Use @{examples} for guidance but never output them

4. Key Execution Patterns

When you see: [[LLM: Draft X and immediately execute tasks#advanced-elicitation]]

• Draft the content
• Present it to user
• IMMEDIATELY execute the task
• Wait for completion before continuing

When you see: [[LLM: After section completion, apply tasks#Y]]

• Finish the section
• STOP and execute the task
• Wait for user input

5. Validation & Final Presentation

• Run any specified checklists
• Present clean, formatted content only
• No truncation or summarization
• Begin directly with content (no preamble)
• Include any handoff prompts from template

6. Update Workflow Plan (if applicable)

LLM: After successful document creation

• If plan tracking is enabled and document was part of plan:
  • Call update-workflow-plan task to mark step complete
  • Parameters: task: create-doc, step_id: {from plan}, status: complete
  • Show next recommended step from plan

Common Mistakes to Avoid

❌ Skipping elicitation tasks ❌ Showing template markup to users ❌ Continuing past STOP signals ❌ Combining multiple review points

✅ Execute ALL instructions in sequence ✅ Present only clean, formatted content ✅ Stop at every elicitation point ✅ Wait for user confirmation when instructed

Remember

Templates contain precise instructions for a reason. Follow them exactly to ensure document quality and completeness.