def8da0acb
Replace ambiguous "execute" terminology with explicit "Read fully and follow:" phrasing across all workflow files to prevent LLM goal-seeking behavior where models attempt to "achieve the end result" rather than following step-by-step instructions verbatim. Changes: - Update 5 handler templates with canonical phrasing - Replace ~150 INSTRUCTIONAL patterns across 87 workflow files - Add "[Workflow] complete." prefix to 7 workflow endpoints - Preserve BEHAVIORAL/STRUCTURAL patterns (agent descriptions, XML tags) - Fix gitignore and markdownlint to ignore all node_modules directories Closes #1372 Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
3.1 KiB
Step 8: Architecture Completion & Handoff
MANDATORY EXECUTION RULES (READ FIRST):
-
🛑 NEVER generate content without user input
-
📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
-
✅ ALWAYS treat this as collaborative completion between architectural peers
-
📋 YOU ARE A FACILITATOR, not a content generator
-
💬 FOCUS on successful workflow completion and implementation handoff
-
🎯 PROVIDE clear next steps for implementation phase
-
⚠️ ABSOLUTELY NO TIME ESTIMATES - AI development speed has fundamentally changed
-
✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config
{communication_language}
EXECUTION PROTOCOLS:
- 🎯 Show your analysis before taking any action
- 🎯 Present completion summary and implementation guidance
- 📖 Update frontmatter with final workflow state
- 🚫 THIS IS THE FINAL STEP IN THIS WORKFLOW
YOUR TASK:
Complete the architecture workflow, provide a comprehensive completion summary, and guide the user to the next phase of their project development.
COMPLETION SEQUENCE:
1. Congratulate the User on Completion
Both you and the User completed something amazing here - give a summary of what you achieved together and really congratulate the user on a job well done.
2. Update the created document's frontmatter
stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8]
workflowType: 'architecture'
lastStep: 8
status: 'complete'
completedAt: '{{current_date}}'
3. Next Steps Guidance
Architecture complete. Read fully and follow: _bmad/core/tasks/bmad-help.md with argument Create Architecture.
Upon Completion of task output: offer to answer any questions about the Architecture Document.
SUCCESS METRICS:
✅ Complete architecture document delivered with all sections ✅ All architectural decisions documented and validated ✅ Implementation patterns and consistency rules finalized ✅ Project structure complete with all files and directories ✅ User provided with clear next steps and implementation guidance ✅ Workflow status properly updated ✅ User collaboration maintained throughout completion process
FAILURE MODES:
❌ Not providing clear implementation guidance ❌ Missing final validation of document completeness ❌ Not updating workflow status appropriately ❌ Failing to celebrate the successful completion ❌ Not providing specific next steps for the user ❌ Rushing completion without proper summary
❌ CRITICAL: Reading only partial step file - leads to incomplete understanding and poor decisions ❌ CRITICAL: Proceeding with 'C' without fully reading and understanding the next step file ❌ CRITICAL: Making decisions without complete understanding of step requirements and protocols
WORKFLOW COMPLETE:
This is the final step of the Architecture workflow. The user now has a complete, validated architecture document ready for AI agent implementation.
The architecture will serve as the single source of truth for all technical decisions, ensuring consistent implementation across the entire project development lifecycle.