ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/.bmad/bmm/knowledge/debug
History
Marc R Kellerman 8db9d389e1 fix: escape XML attribute values to prevent XML validation errors 
- Added XML escaping for agent metadata attributes (id, name, title, icon)
- Fixed validation error in debug.xml where ampersand in title wasn't escaped
- Now all XML bundle validation passes
 		2025-11-10 10:11:59 -08:00
..
README.md fix: escape XML attribute values to prevent XML validation errors 2025-11-10 10:11:59 -08:00
common-defects.md fix: escape XML attribute values to prevent XML validation errors 2025-11-10 10:11:59 -08:00
debug-inspection-checklist.md fix: escape XML attribute values to prevent XML validation errors 2025-11-10 10:11:59 -08:00
debug-patterns.md fix: escape XML attribute values to prevent XML validation errors 2025-11-10 10:11:59 -08:00
root-cause-checklist.md fix: escape XML attribute values to prevent XML validation errors 2025-11-10 10:11:59 -08:00

README.md

Debug Knowledge Base

Overview

This knowledge base contains systematic debugging methodologies, checklists, and reference materials for Diana, the Debug Specialist & Root Cause Analyst.

Knowledge Fragments

Core Debugging Resources

  1. debug-inspection-checklist.md - Comprehensive Fagan inspection methodology with 6-phase systematic review process
  2. root-cause-checklist.md - Fishbone analysis and 5-whys methodology for systematic root cause investigation
  3. common-defects.md - Reference catalog of frequently occurring defect patterns with classification and prevention strategies
  4. debug-patterns.md - Common debugging strategies, anti-patterns to avoid, and best practices

Usage in Workflows

Each workflow references specific knowledge fragments:

  • Inspect Workflow → Uses debug-inspection-checklist.md for systematic Fagan inspection
  • Root Cause Workflow → Uses root-cause-checklist.md for fishbone and 5-whys analysis
  • Quick Debug Workflow → Uses debug-patterns.md for rapid pattern recognition
  • Pattern Analysis Workflow → Uses common-defects.md for defect classification
  • Static Scan Workflow → Uses common-defects.md for automated defect detection

Knowledge Integration

The debug-index.csv file maps knowledge fragments to specific use cases and tags, enabling efficient knowledge retrieval during debugging sessions.

Maintenance

Knowledge fragments are maintained as part of the BMAD module structure and updated based on debugging experience and lessons learned from resolved incidents.