From 14f80f24f35c4127aff51a1580b04a03ad7fa9c5 Mon Sep 17 00:00:00 2001 From: Daniel Bentes Date: Fri, 30 May 2025 20:15:49 +0200 Subject: [PATCH] Enhance Command Registry and Memory Bootstrap Task Documentation - Added new commands to the command registry, including Design Architect persona, memory bootstrap, task execution, and validation checklist functionalities, improving the agent's operational capabilities. - Updated descriptions and usage instructions for memory-related commands to clarify their integration with the MCP. - Enhanced the memory bootstrap task documentation with critical execution requirements, error handling protocols, and success criteria to ensure effective memory creation and validation. - Improved overall structure and organization of command and task documentation for better usability and clarity. --- bmad-agent/commands/command-registry.yml | 73 +++++++++++++++-------- bmad-agent/tasks/memory-bootstrap-task.md | 21 +++++++ 2 files changed, 70 insertions(+), 24 deletions(-) diff --git a/bmad-agent/commands/command-registry.yml b/bmad-agent/commands/command-registry.yml index 8f8152c4..fd9de59e 100644 --- a/bmad-agent/commands/command-registry.yml +++ b/bmad-agent/commands/command-registry.yml @@ -50,26 +50,46 @@ quality: description: Switch to Quality Enforcer persona shortcut: "/quality" -# Memory Commands +design-architect: + description: Switch to Design Architect persona + shortcut: "/design-architect" + +# Memory Commands - Core MCP Functions Only remember: - description: Manually add to memory + description: Manually add to memory using MCP usage: "/remember {content}" aliases: [mem, save] recall: - description: Search memories + description: Search memories using MCP usage: "/recall {query}" aliases: [search, find] - -insights: - description: Get proactive insights for current context - usage: "/insights" - -patterns: - description: Show recognized patterns - usage: "/patterns" -# Consultation Commands +# Memory Bootstrap - Verified Implementation +bootstrap-memory: + description: Execute memory bootstrap for brownfield projects + usage: "/bootstrap-memory [--auto|--interactive|--focus={type}]" + aliases: [bootstrap, mem-bootstrap] + modes: + - auto: Silent analysis with bulk memory creation + - interactive: Guided analysis with user validation + - focus: Targeted analysis (architecture, decisions, patterns, issues) + implementation: memory-bootstrap-task.md + +# Task Execution - Verified Implementation +run-task: + description: Execute specific task file + usage: "/run-task {task-name}" + aliases: [task, execute] + implementation: Core orchestrator functionality + +checklist: + description: Run validation checklist + usage: "/checklist {checklist-name}" + aliases: [check, validate] + implementation: checklist-run-task.md + +# Consultation Commands - Basic Only consult: description: Start multi-persona consultation usage: "/consult {type}" @@ -81,10 +101,11 @@ consult: - emergency-response - custom -# Quality Commands +# Quality Commands - Verified Implementation udtm: description: Execute Ultra-Deep Thinking Mode usage: "/udtm" + implementation: udtm_task.md quality-gate: description: Run quality gate validation @@ -93,12 +114,21 @@ quality-gate: - pre-implementation - implementation - completion + implementation: quality_gate_validation.md anti-pattern-check: description: Scan for anti-patterns usage: "/anti-pattern-check" + aliases: [anti-pattern, pattern-check] + implementation: anti_pattern_detection.md -# Workflow Commands +brotherhood-review: + description: Initiate peer validation process + usage: "/brotherhood-review" + aliases: [peer-review, brotherhood] + implementation: brotherhood_review.md + +# Workflow Commands - Verified Implementation suggest: description: Get AI-powered next step recommendations usage: "/suggest" @@ -106,28 +136,23 @@ suggest: handoff: description: Structured persona transition usage: "/handoff {persona}" + implementation: handoff-orchestration-task.md core-dump: description: Save session state usage: "/core-dump" + implementation: core-dump.md -# System Commands +# System Commands - Verified Implementation diagnose: description: Run system health check usage: "/diagnose" - -optimize: - description: Performance analysis - usage: "/optimize" + implementation: system-diagnostics-task.md yolo: - description: Toggle YOLO mode + description: Toggle YOLO mode for immediate execution usage: "/yolo" exit: description: Exit current persona usage: "/exit" - -# Note: This is a placeholder registry. Additional commands and enhanced functionality -# will be added as the BMAD method evolves. The orchestrator can use this registry -# to provide contextual help and command validation. \ No newline at end of file diff --git a/bmad-agent/tasks/memory-bootstrap-task.md b/bmad-agent/tasks/memory-bootstrap-task.md index 62ed4eda..54ce06a0 100644 --- a/bmad-agent/tasks/memory-bootstrap-task.md +++ b/bmad-agent/tasks/memory-bootstrap-task.md @@ -3,6 +3,27 @@ ## Purpose Rapidly establish comprehensive contextual memory for existing projects by systematically analyzing project artifacts, extracting decisions, identifying patterns, and creating foundational memory entries for immediate BMAD memory-enhanced operations. +## ⚡ CRITICAL EXECUTION REQUIREMENTS + +**MANDATORY**: This task requires ACTUAL MEMORY CREATION, not just analysis. + +### Execution Protocol +1. **Analyze** project artifacts (as detailed below) +2. **CREATE** memory entries using `add_memories()` function for each insight +3. **VERIFY** memory creation success after each call +4. **DOCUMENT** total memories created in final report +5. **VALIDATE** core purpose achieved: "Are memories now stored in the system?" + +### Error Handling +- If `add_memories()` fails: Store entries in session state for later sync +- If memory system unavailable: Document entries in `.ai/bootstrap-memories.md` +- Always attempt memory creation - don't assume unavailability without testing + +### Success Criteria +- **MINIMUM**: 5 memories created across different categories +- **TARGET**: 10-15 memories for comprehensive bootstrap +- **VERIFICATION**: Can search and retrieve created memories + ## Bootstrap Process Overview ### Phase 1: Project Context Discovery (10-15 minutes)