diff --git a/bmad-core/tasks/facilitate-brainstorming-session.md b/bmad-core/tasks/facilitate-brainstorming-session.md index 62b0e455..c7a45975 100644 --- a/bmad-core/tasks/facilitate-brainstorming-session.md +++ b/bmad-core/tasks/facilitate-brainstorming-session.md @@ -1,6 +1,6 @@ --- docOutputLocation: docs/brainstorming-session-results.md -template: "{root}/templates/brainstorming-output-tmpl.md" +template: "{root}/templates/brainstorming-output-tmpl.yaml" --- # Facilitate Brainstorming Session Task diff --git a/docs/template-markup-references.md b/docs/template-markup-references.md deleted file mode 100644 index 66264457..00000000 --- a/docs/template-markup-references.md +++ /dev/null @@ -1,86 +0,0 @@ -# Old Template Markup System References - -This document catalogs all references to the old template markup system found in the BMAD-METHOD documentation and codebase. - -## Summary of Old Markup Patterns - -The old template markup system used the following patterns: - -- `[[LLM: ...]]` - LLM-only processing directives -- `{{placeholders}}` - Variable substitution -- `<>` - Repeatable sections -- `^^CONDITION: condition_name^^` - Conditional blocks -- `@{examples}` - Example content markers - -## Files Containing References - -### 1. Primary Documentation Files - -#### `/Users/brianmadison/dev-bmc/BMAD-METHOD/docs/user-guide.md` - -- **Lines 149-155**: Describes template structure with placeholders and LLM instructions -- **Lines 229-230**: References advanced elicitation with embedded LLM instructions -- **Lines 527-549**: Shows custom template creation with LLM instructions and placeholders -- **Lines 590-632**: Detailed template patterns including variables, AI processing, and conditionals -- **Lines 619-623**: References to `@{example}` patterns and `[[LLM:]]` instructions - -#### `/Users/brianmadison/dev-bmc/BMAD-METHOD/docs/core-architecture.md` - -- **Lines 93-104**: Describes templates as self-contained with embedded LLM instructions -- **Lines 97-104**: Mentions template-format.md specification with placeholders and LLM directives - -#### `/Users/brianmadison/dev-bmc/BMAD-METHOD/CLAUDE.md` - -- **Lines 37, 262**: References to template instructions using `[[LLM: ...]]` markup -- **Line 38**: Mentions templates with embedded LLM instructions - -### 2. Common Utilities - -#### `/Users/brianmadison/dev-bmc/BMAD-METHOD/common/utils/bmad-doc-template.md` - -- **Lines 296-324**: Migration section describes converting from legacy markdown+frontmatter templates -- **Lines 319-323**: Specific conversion instructions for old markup patterns - -### 3. Task Files - -#### `/Users/brianmadison/dev-bmc/BMAD-METHOD/bmad-core/tasks/shard-doc.md` - -- **Lines 11-30**: Contains LLM instructions embedded in the task -- **Line 160**: References preserving template markup including `{{placeholders}}` and `[[LLM instructions]]` - -#### `/Users/brianmadison/dev-bmc/BMAD-METHOD/expansion-packs/bmad-creator-tools/tasks/generate-expansion-pack.md` - -- **Lines 10-14**: Describes template systems with LLM instruction embedding -- **Lines 107-118**: Template section planning with LLM instructions -- **Lines 229-245**: Detailed LLM instruction patterns for templates -- **Lines 569-593**: Advanced template design patterns -- **Lines 229, 573**: Specific examples of `[[LLM:]]` usage -- **Line 574**: References conditional content with `^^CONDITION:^^` -- **Line 576**: Mentions iteration controls with `<>` - -### 4. Agent and Template Files - -Multiple agent and task files contain actual usage of the old markup system (22 files found with `[[LLM:]]` patterns), including: - -- Story templates -- Checklists -- Task definitions -- Workflow plans - -## Key Observations - -1. **Documentation vs Implementation**: The documentation heavily references the old markup system, while the new YAML-based template system (`bmad-doc-template.md`) is already defined but not yet reflected in the main documentation. - -2. **Migration Path**: The `bmad-doc-template.md` file includes a migration section (lines 316-324) that explicitly maps old patterns to new YAML structures. - -3. **Active Usage**: Many core tasks and templates still actively use the old markup patterns, particularly `[[LLM:]]` instructions embedded within markdown files. - -4. **Inconsistency**: Some files reference a `template-format.md` file that doesn't exist in the expected locations, suggesting incomplete migration or documentation updates. - -## Recommendations - -1. **Update User Guide**: The user guide needs significant updates to reflect the new YAML-based template system -2. **Update Core Architecture Docs**: Remove references to embedded LLM instructions in templates -3. **Create Template Migration Guide**: A comprehensive guide for converting existing templates -4. **Update Extension Pack Documentation**: The bmad-creator-tools expansion pack documentation needs updates -5. **Audit Active Templates**: Review and migrate templates that still use the old markup system