diff --git a/CHANGELOG.md b/CHANGELOG.md index 98fb9ac68..907ed6037 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,36 +4,37 @@ ### Highlights -* Whiteport Design Studio (WDS) module enabled in the installer -* Support @next installation channel (`npx bmad-method@next install`) โ€” get the latest tip of main instead of waiting for the next stable published version -* Everything now installs as a skill โ€” all workflows, agents, and tasks converted to markdown with SKILL.md entrypoints (not yet optimized skills, but unified format) -* An experimental preview of the new Quick Dev is available, which will become the main Phase 4 development tool -* Edge Case Hunter added as a parallel code review layer in Phase 4, improving code quality by exhaustively tracing branching paths and boundary conditions (#1791) -* Documentation now available in Chinese (zh-CN) with complete translation (#1822, #1795) +- Whiteport Design Studio (WDS) module enabled in the installer +- Support @next installation channel (`npx bmad-method@next install`) โ€” get the latest tip of main instead of waiting for the next stable published version +- Everything now installs as a skill โ€” all workflows, agents, and tasks converted to markdown with SKILL.md entrypoints (not yet optimized skills, but unified format) +- An experimental preview of the new Quick Dev is available, which will become the main Phase 4 development tool +- Edge Case Hunter added as a parallel code review layer in Phase 4, improving code quality by exhaustively tracing branching paths and boundary conditions (#1791) +- Documentation now available in Chinese (zh-CN) with complete translation (#1822, #1795) ### ๐Ÿ’ฅ Breaking Changes -* Convert entire BMAD method to skills-based architecture with unified skill manifests (#1834) -* Convert all core workflows from YAML+instructions to single workflow.md format -* Migrate all remaining platforms to native Agent Skills format (#1841) -* Remove legacy YAML/XML workflow engine plumbing (#1864) +- Convert entire BMAD method to skills-based architecture with unified skill manifests (#1834) +- Convert all core workflows from YAML+instructions to single workflow.md format +- Migrate all remaining platforms to native Agent Skills format (#1841) +- Remove legacy YAML/XML workflow engine plumbing (#1864) ### ๐ŸŽ Features -* Add Pi coding agent as supported platform (#1854) -* Add unified skill scanner decoupled from legacy collectors (#1859) -* Add continuous delivery workflows for npm publishing with trusted OIDC publishing (#1872) +- Add Pi coding agent as supported platform (#1854) +- Add unified skill scanner decoupled from legacy collectors (#1859) +- Add continuous delivery workflows for npm publishing with trusted OIDC publishing (#1872) ### โ™ป๏ธ Refactoring -* Update terminology from "commands" to "skills" across all documentation (#1850) +- Update terminology from "commands" to "skills" across all documentation (#1850) +- Rename "Scrum Master" role to "Agile Delivery Lead" (SM โ†’ ADL) across all agents, workflows, and documentation ### ๐Ÿ› Bug Fixes -* Fix code review removing mandatory minimum issue count that caused infinite review loops (#1913) -* Fix silent loss of brainstorming ideas in PRD by adding reconciliation step (#1914) -* Reduce npm tarball from 533 to 348 files (91% size reduction, 6.2 MB โ†’ 555 KB) via .npmignore (#1900) -* Fix party-mode skill conversion review findings (#1919) +- Fix code review removing mandatory minimum issue count that caused infinite review loops (#1913) +- Fix silent loss of brainstorming ideas in PRD by adding reconciliation step (#1914) +- Reduce npm tarball from 533 to 348 files (91% size reduction, 6.2 MB โ†’ 555 KB) via .npmignore (#1900) +- Fix party-mode skill conversion review findings (#1919) --- @@ -41,14 +42,14 @@ ### ๐ŸŽ Features -* Add edge case hunter review task - new reusable review task that exhaustively traces branching paths and boundary conditions in code, reporting only unhandled gaps. Method-driven analysis complementary to adversarial review (#1790) +- Add edge case hunter review task - new reusable review task that exhaustively traces branching paths and boundary conditions in code, reporting only unhandled gaps. Method-driven analysis complementary to adversarial review (#1790) ### ๐Ÿ› Bug Fixes -* Fix brainstorming to not overwrite previous sessions; now prompts to continue existing brainstorming or start a new one when older brainstorming sessions are found -* Fix installer templates - replace legacy `@` path prefixes with explicit `{project-root}` syntax for consistency (#1769) -* Fix edge case hunter - remove zero-findings halt condition that was pressuring the LLM to hallucinate findings when none legitimately exist (#1797) -* Fix broken docs domain references in README and GitHub issue templates (#1777) +- Fix brainstorming to not overwrite previous sessions; now prompts to continue existing brainstorming or start a new one when older brainstorming sessions are found +- Fix installer templates - replace legacy `@` path prefixes with explicit `{project-root}` syntax for consistency (#1769) +- Fix edge case hunter - remove zero-findings halt condition that was pressuring the LLM to hallucinate findings when none legitimately exist (#1797) +- Fix broken docs domain references in README and GitHub issue templates (#1777) --- @@ -56,24 +57,24 @@ ### ๐ŸŽ Features -* Add bmad-os-root-cause-analysis skill for analyzing bug-fix commits and producing structured root cause analysis reports with pyramid communication format (#1741) +- Add bmad-os-root-cause-analysis skill for analyzing bug-fix commits and producing structured root cause analysis reports with pyramid communication format (#1741) ### ๐Ÿ› Bug Fixes -* Fix installer to refuse installation when ancestor directory has BMAD commands, preventing duplicate command autocompletion in nested directories (#1735) -* Fix OpenCode integration by replacing unsupported `name` frontmatter with `mode: all` and update directory names to plural form (#1764) -* Fix CSV manifest pipeline double-escaping of quotes that was corrupting output files; switch Gemini templates to single quotes (#1746) -* Fix workflow descriptions to use proper quotes so they format better in skill conversion and don't break yaml front matter -* Fix workflow help task chaining by removing ambiguous "with-argument" clause that caused LLMs to misinterpret help.md as skill calls (#1740) +- Fix installer to refuse installation when ancestor directory has BMAD commands, preventing duplicate command autocompletion in nested directories (#1735) +- Fix OpenCode integration by replacing unsupported `name` frontmatter with `mode: all` and update directory names to plural form (#1764) +- Fix CSV manifest pipeline double-escaping of quotes that was corrupting output files; switch Gemini templates to single quotes (#1746) +- Fix workflow descriptions to use proper quotes so they format better in skill conversion and don't break yaml front matter +- Fix workflow help task chaining by removing ambiguous "with-argument" clause that caused LLMs to misinterpret help.md as skill calls (#1740) ### โ™ป๏ธ Refactoring -* Standardize all workflow descriptions to use proper quotes to prevent breaking command or skill front matter during skill conversion +- Standardize all workflow descriptions to use proper quotes to prevent breaking command or skill front matter during skill conversion ### ๐Ÿ“š Documentation -* Fix broken TEA hyperlinks to point to new repository URL (#1772) -* Rebrand BMAD acronym to "Build More Architect Dreams" across documentation (#1765) +- Fix broken TEA hyperlinks to point to new repository URL (#1772) +- Rebrand BMAD acronym to "Build More Architect Dreams" across documentation (#1765) --- @@ -81,36 +82,36 @@ ### ๐ŸŽ Features -* Add CodeBuddy platform support with installer configuration (#1483) -* Add LLM audit prompt for file reference conventions - new audit tool using parallel subagents (#1720) -* Migrate Codex installer from `.codex/prompts` to `.agents/skills` format to align with Codex CLI changes (#1729) -* Convert review-pr and audit-file-refs tools to proper bmad-os skills with slash commands `bmad-os-review-pr` and `bmad-os-audit-file-refs` (#1732) +- Add CodeBuddy platform support with installer configuration (#1483) +- Add LLM audit prompt for file reference conventions - new audit tool using parallel subagents (#1720) +- Migrate Codex installer from `.codex/prompts` to `.agents/skills` format to align with Codex CLI changes (#1729) +- Convert review-pr and audit-file-refs tools to proper bmad-os skills with slash commands `bmad-os-review-pr` and `bmad-os-audit-file-refs` (#1732) ### ๐Ÿ› Bug Fixes -* Fix 24 broken step references in create-architecture workflow after directory rename (#1734) -* Fix step file path references in check-implementation-readiness workflow (#1709, #1716) -* Fix 3 broken file references and enable strict file reference validation in CI (#1717) -* Fix Rovo Dev integration with custom installer that generates prompts.yml manifest (#1701) -* Fix 104 relative step file references to use standardized `{project-root}/_bmad/` paths across 68 files (#1722) -* Fix code fence imbalance in step-03-starter.md that caused rendering issues (#1724) -* Remove Windsurf from recommended/preferred IDEs list (#1727) -* Fix default Codex install location from global to project for better defaults (#1698) -* Add npx cache workaround to Quick Start for stale beta versions (#1685) -* Add language instructions to replace placeholder text in Research overview (#1703) -* Ignore `.junie/` IDE integration folder in git and prettier configs (#1719) +- Fix 24 broken step references in create-architecture workflow after directory rename (#1734) +- Fix step file path references in check-implementation-readiness workflow (#1709, #1716) +- Fix 3 broken file references and enable strict file reference validation in CI (#1717) +- Fix Rovo Dev integration with custom installer that generates prompts.yml manifest (#1701) +- Fix 104 relative step file references to use standardized `{project-root}/_bmad/` paths across 68 files (#1722) +- Fix code fence imbalance in step-03-starter.md that caused rendering issues (#1724) +- Remove Windsurf from recommended/preferred IDEs list (#1727) +- Fix default Codex install location from global to project for better defaults (#1698) +- Add npx cache workaround to Quick Start for stale beta versions (#1685) +- Add language instructions to replace placeholder text in Research overview (#1703) +- Ignore `.junie/` IDE integration folder in git and prettier configs (#1719) ### โ™ป๏ธ Refactoring -* Update open source tool skills structure for future plugin migration -* Standardize all workflow descriptions for skill generation with concise format and explicit trigger phrases -* Remove `disable-model-invocation` flag from all IDE installer templates to enable workflow skill calls +- Update open source tool skills structure for future plugin migration +- Standardize all workflow descriptions for skill generation with concise format and explicit trigger phrases +- Remove `disable-model-invocation` flag from all IDE installer templates to enable workflow skill calls ### ๐Ÿ“š Documentation -* Elevate `bmad-help` as primary on-ramp across all documentation -* Update workflow names with `bmad-bmm-` prefix and standardize table formatting -* Clarify phase routing and catalog path in help task +- Elevate `bmad-help` as primary on-ramp across all documentation +- Update workflow names with `bmad-bmm-` prefix and standardize table formatting +- Clarify phase routing and catalog path in help task --- @@ -120,32 +121,32 @@ V6 Stable Release! The End of Beta! ### ๐ŸŽ Features -* Add PRD workflow steps 2b (vision/differentiators) and 2c (executive summary) for more complete product requirements documentation -* Add new `bmad uninstall` command with interactive and non-interactive modes for selective component removal -* Add dedicated GitHub Copilot installer that generates enriched `.agent.md`, `.prompt.md` files and project configuration -* Add TEA browser automation prerequisite prompts to guide Playwright CLI/MCP setup after configuration +- Add PRD workflow steps 2b (vision/differentiators) and 2c (executive summary) for more complete product requirements documentation +- Add new `bmad uninstall` command with interactive and non-interactive modes for selective component removal +- Add dedicated GitHub Copilot installer that generates enriched `.agent.md`, `.prompt.md` files and project configuration +- Add TEA browser automation prerequisite prompts to guide Playwright CLI/MCP setup after configuration ### ๐Ÿ› Bug Fixes -* Fix version comparison to use semantic versioning, preventing incorrect downgrade recommendations to older beta versions -* Fix `--custom-content` flag to properly populate sources and selected files in module config -* Fix module configuration UX messaging to show accurate completion status and improve feedback timing -* Fix changelog URL in installer start message for proper GitHub resolution -* Remove incorrect `mode: primary` from OpenCode agent template and restore `name` field across all templates -* Auto-discover PRD files in validate-prd workflow to reduce manual path input -* Fix installer non-interactive mode hanging and improve IDE configuration handling during updates -* Fix workflow-level config.yaml copying for custom content modules +- Fix version comparison to use semantic versioning, preventing incorrect downgrade recommendations to older beta versions +- Fix `--custom-content` flag to properly populate sources and selected files in module config +- Fix module configuration UX messaging to show accurate completion status and improve feedback timing +- Fix changelog URL in installer start message for proper GitHub resolution +- Remove incorrect `mode: primary` from OpenCode agent template and restore `name` field across all templates +- Auto-discover PRD files in validate-prd workflow to reduce manual path input +- Fix installer non-interactive mode hanging and improve IDE configuration handling during updates +- Fix workflow-level config.yaml copying for custom content modules ### โ™ป๏ธ Refactoring -* Remove alias variables from Phase 4 workflows, use canonical `{implementation_artifacts}` and `{planning_artifacts}` -* Add missing `project_context` references to workflows for consistency +- Remove alias variables from Phase 4 workflows, use canonical `{implementation_artifacts}` and `{planning_artifacts}` +- Add missing `project_context` references to workflows for consistency ### ๐Ÿ“š Documentation -* Add post-install notes documentation for modules -* Improve project-context documentation and fix folder structure -* Add BMad Builder link to index for extenders +- Add post-install notes documentation for modules +- Improve project-context documentation and fix folder structure +- Add BMad Builder link to index for extenders --- @@ -162,43 +163,43 @@ V6 Stable Release! The End of Beta! ### ๐ŸŽ Features -* **Non-Interactive Installation** โ€” Added `--directory`, `--modules`, `--tools`, `--custom-content`, `--user-name`, `--communication-language`, `--document-output-language`, `--output-folder`, and `-y/--yes` flags for CI/CD automation (#1520) -* **CSV File Reference Validation** โ€” Extended validator to scan `.csv` files for broken workflow references, checking 501 references across 212 files (#1573) -* **Kiro IDE Support** โ€” Replaced broken custom installer with config-driven templates using `#[[file:...]]` syntax and `inclusion: manual` frontmatter (#1589) -* **OpenCode Template Consolidation** โ€” Combined split templates with `mode: primary` frontmatter for Tab-switching support, fixing agent discovery (#1556) -* **Modules Reference Page** โ€” Added official external modules reference documentation (#1540) +- **Non-Interactive Installation** โ€” Added `--directory`, `--modules`, `--tools`, `--custom-content`, `--user-name`, `--communication-language`, `--document-output-language`, `--output-folder`, and `-y/--yes` flags for CI/CD automation (#1520) +- **CSV File Reference Validation** โ€” Extended validator to scan `.csv` files for broken workflow references, checking 501 references across 212 files (#1573) +- **Kiro IDE Support** โ€” Replaced broken custom installer with config-driven templates using `#[[file:...]]` syntax and `inclusion: manual` frontmatter (#1589) +- **OpenCode Template Consolidation** โ€” Combined split templates with `mode: primary` frontmatter for Tab-switching support, fixing agent discovery (#1556) +- **Modules Reference Page** โ€” Added official external modules reference documentation (#1540) ### ๐Ÿ› Bug Fixes -* **Installer Streamlining** โ€” Removed "None - Skip module installation" option, eliminated ~100 lines of dead code, and added ESM/.cjs support for module installers (#1590) -* **CodeRabbit Workflow** โ€” Changed `pull_request` to `pull_request_target` to fix 403 errors and enable reviews on fork PRs (#1583) -* **Party Mode Return Protocol** โ€” Added RETURN PROTOCOL to prevent lost-in-the-middle failures after Party Mode completes (#1569) -* **Spacebar Toggle** โ€” Fixed SPACE key not working in autocomplete multiselect prompts for tool/IDE selection (#1557) -* **OpenCode Agent Routing** โ€” Fixed agents installing to wrong directory by adding `targets` array for routing `.opencode/agent/` vs `.opencode/command/` (#1549) -* **Technical Research Workflow** โ€” Fixed step-05 routing to step-06 and corrected `stepsCompleted` values (#1547) -* **Forbidden Variable Removal** โ€” Removed `workflow_path` variable from 16 workflow step files (#1546) -* **Kilo Installer** โ€” Fixed YAML formatting issues by trimming activation header and converting to yaml.parse/stringify (#1537) -* **bmad-help** โ€” Now reads project-specific docs and respects `communication_language` setting (#1535) -* **Cache Errors** โ€” Removed `--prefer-offline` npm flag to prevent stale cache errors during installation (#1531) +- **Installer Streamlining** โ€” Removed "None - Skip module installation" option, eliminated ~100 lines of dead code, and added ESM/.cjs support for module installers (#1590) +- **CodeRabbit Workflow** โ€” Changed `pull_request` to `pull_request_target` to fix 403 errors and enable reviews on fork PRs (#1583) +- **Party Mode Return Protocol** โ€” Added RETURN PROTOCOL to prevent lost-in-the-middle failures after Party Mode completes (#1569) +- **Spacebar Toggle** โ€” Fixed SPACE key not working in autocomplete multiselect prompts for tool/IDE selection (#1557) +- **OpenCode Agent Routing** โ€” Fixed agents installing to wrong directory by adding `targets` array for routing `.opencode/agent/` vs `.opencode/command/` (#1549) +- **Technical Research Workflow** โ€” Fixed step-05 routing to step-06 and corrected `stepsCompleted` values (#1547) +- **Forbidden Variable Removal** โ€” Removed `workflow_path` variable from 16 workflow step files (#1546) +- **Kilo Installer** โ€” Fixed YAML formatting issues by trimming activation header and converting to yaml.parse/stringify (#1537) +- **bmad-help** โ€” Now reads project-specific docs and respects `communication_language` setting (#1535) +- **Cache Errors** โ€” Removed `--prefer-offline` npm flag to prevent stale cache errors during installation (#1531) ### โ™ป๏ธ Refactoring -* **Complete @clack/prompts Migration** โ€” Migrated 24 files from legacy libraries (ora, chalk, boxen, figlet, etc.), replaced ~100 console.log+chalk calls, consolidated installer output to single spinner, and removed 5 dependencies (#1586) -* **Downloads Page Removal** โ€” Removed downloads page, bundle generation, and archiver dependency in favor of GitHub's native archives (#1577) -* **Workflow Verb Standardization** โ€” Replaced "invoke/run" with "load and follow/load" in review workflow prompts (#1570) -* **Documentation Language** โ€” Renamed "brownfield" to "established projects" and flattened directory structure for accessibility (#1539) +- **Complete @clack/prompts Migration** โ€” Migrated 24 files from legacy libraries (ora, chalk, boxen, figlet, etc.), replaced ~100 console.log+chalk calls, consolidated installer output to single spinner, and removed 5 dependencies (#1586) +- **Downloads Page Removal** โ€” Removed downloads page, bundle generation, and archiver dependency in favor of GitHub's native archives (#1577) +- **Workflow Verb Standardization** โ€” Replaced "invoke/run" with "load and follow/load" in review workflow prompts (#1570) +- **Documentation Language** โ€” Renamed "brownfield" to "established projects" and flattened directory structure for accessibility (#1539) ### ๐Ÿ“š Documentation -* **Comprehensive Site Review** โ€” Fixed broken directory tree diagram, corrected grammar/capitalization, added SEO descriptions, and reordered how-to guides (#1578) -* **SEO Metadata** โ€” Added description front matter to 9 documentation pages for search engine optimization (#1566) -* **PR Template** โ€” Added pull request template for consistent PR descriptions (#1554) -* **Manual Release Cleanup** โ€” Removed broken manual-release workflow and related scripts (#1576) +- **Comprehensive Site Review** โ€” Fixed broken directory tree diagram, corrected grammar/capitalization, added SEO descriptions, and reordered how-to guides (#1578) +- **SEO Metadata** โ€” Added description front matter to 9 documentation pages for search engine optimization (#1566) +- **PR Template** โ€” Added pull request template for consistent PR descriptions (#1554) +- **Manual Release Cleanup** โ€” Removed broken manual-release workflow and related scripts (#1576) ### ๐Ÿ”ง Maintenance -* **Dual-Mode AI Code Review** โ€” Configured Augment Code (audit mode) and CodeRabbit (adversarial mode) for improved code quality (#1511) -* **Package-Lock Sync** โ€” Cleaned up 471 lines of orphaned dependencies after archiver removal (#1580) +- **Dual-Mode AI Code Review** โ€” Configured Augment Code (audit mode) and CodeRabbit (adversarial mode) for improved code quality (#1511) +- **Package-Lock Sync** โ€” Cleaned up 471 lines of orphaned dependencies after archiver removal (#1580) --- @@ -213,14 +214,14 @@ V6 Stable Release! The End of Beta! ### ๐ŸŽ Features -* **Slash Command Workflow Access** โ€” Research and PRD workflows now accessible via direct slash commands: `/domain-research`, `/market-research`, `/technical-research`, `/create-prd`, `/edit-prd`, `/validate-prd` (bd620e38, 731bee26) -* **Version Checking** โ€” CLI now checks npm for newer versions and displays a warning banner when updates are available (d37ee7f2) +- **Slash Command Workflow Access** โ€” Research and PRD workflows now accessible via direct slash commands: `/domain-research`, `/market-research`, `/technical-research`, `/create-prd`, `/edit-prd`, `/validate-prd` (bd620e38, 731bee26) +- **Version Checking** โ€” CLI now checks npm for newer versions and displays a warning banner when updates are available (d37ee7f2) ### โ™ป๏ธ Refactoring -* **Workflow File Splitting** โ€” Split monolithic `workflow.md` files into specific `workflow-*.md` files for individual workflow invocation (bd620e38) -* **Installer Multi-Workflow Support** โ€” Installer manifest generator now supports `workflow-*.md` pattern, allowing multiple workflow files per directory (731bee26) -* **Internal Skill Renaming** โ€” Renamed internal project skills to use `bmad-os-` prefix for consistent naming (5276d58b) +- **Workflow File Splitting** โ€” Split monolithic `workflow.md` files into specific `workflow-*.md` files for individual workflow invocation (bd620e38) +- **Installer Multi-Workflow Support** โ€” Installer manifest generator now supports `workflow-*.md` pattern, allowing multiple workflow files per directory (731bee26) +- **Internal Skill Renaming** โ€” Renamed internal project skills to use `bmad-os-` prefix for consistent naming (5276d58b) --- @@ -237,33 +238,33 @@ V6 Stable Release! The End of Beta! ### ๐ŸŽ Features -* **Cross-File Reference Validator** โ€” Validates ~483 references across ~217 source files, detecting absolute path leaks and broken references (PR #1494) -* **AutocompleteMultiselect Prompt** โ€” Upgraded `@clack/prompts` to v1.0.0 with custom searchable multiselect, Tab-to-fill-placeholder behavior, and improved tool/IDE selection UX (PR #1514) -* **OT Domains** โ€” Added `process_control` and `building_automation` domains with high complexity ratings (PR #1510) -* **Documentation Reference Pages** โ€” Added `docs/reference/agents.md`, `commands.md`, and `testing.md` (PR #1525) +- **Cross-File Reference Validator** โ€” Validates ~483 references across ~217 source files, detecting absolute path leaks and broken references (PR #1494) +- **AutocompleteMultiselect Prompt** โ€” Upgraded `@clack/prompts` to v1.0.0 with custom searchable multiselect, Tab-to-fill-placeholder behavior, and improved tool/IDE selection UX (PR #1514) +- **OT Domains** โ€” Added `process_control` and `building_automation` domains with high complexity ratings (PR #1510) +- **Documentation Reference Pages** โ€” Added `docs/reference/agents.md`, `commands.md`, and `testing.md` (PR #1525) ### ๐Ÿ› Bug Fixes -* **Critical Installer Fixes** โ€” Fixed CRLF line ending parsing on Windows, Gemini CLI TOML support, file extension preservation, Codex task generation, Windows path handling, and CSV parsing (PR #1492) -* **Double Tool Questioning** โ€” Removed redundant tool questioning during installation (df176d42) -* **QA Agent Rename** โ€” Renamed Quinn agent to `qa` for naming consistency (PR #1508) -* **Documentation Organization** โ€” Fixed documentation ordering and links, hide BMGD pages from main LLM docs (PR #1525) +- **Critical Installer Fixes** โ€” Fixed CRLF line ending parsing on Windows, Gemini CLI TOML support, file extension preservation, Codex task generation, Windows path handling, and CSV parsing (PR #1492) +- **Double Tool Questioning** โ€” Removed redundant tool questioning during installation (df176d42) +- **QA Agent Rename** โ€” Renamed Quinn agent to `qa` for naming consistency (PR #1508) +- **Documentation Organization** โ€” Fixed documentation ordering and links, hide BMGD pages from main LLM docs (PR #1525) ### โ™ป๏ธ Refactoring -* **Excalidraw/Flattener Removal** โ€” Removed dead artifacts no longer supported beyond beta: Excalidraw workflows, flattener tool, and 12+ diagram creation workflows (-3,798 lines) (f699a368) -* **Centralized Constants** โ€” Centralized `BMAD_FOLDER_NAME` to reduce hardcoded strings (PR #1492) -* **Cross-Platform Paths** โ€” Fixed path separator inconsistencies in agent IDs (PR #1492) +- **Excalidraw/Flattener Removal** โ€” Removed dead artifacts no longer supported beyond beta: Excalidraw workflows, flattener tool, and 12+ diagram creation workflows (-3,798 lines) (f699a368) +- **Centralized Constants** โ€” Centralized `BMAD_FOLDER_NAME` to reduce hardcoded strings (PR #1492) +- **Cross-Platform Paths** โ€” Fixed path separator inconsistencies in agent IDs (PR #1492) ### ๐Ÿ“š Documentation -* **BMGD Diataxis Refactor** โ€” Refactored BMGD documentation using Diataxis principles for better organization (PR #1502) -* **Generate Project Context** โ€” Restored `generate-project-context` workflow for brownfield project analysis (PR #1491) +- **BMGD Diataxis Refactor** โ€” Refactored BMGD documentation using Diataxis principles for better organization (PR #1502) +- **Generate Project Context** โ€” Restored `generate-project-context` workflow for brownfield project analysis (PR #1491) ### ๐Ÿ”ง Maintenance -* **Dependency Updates** โ€” Upgraded `@clack/prompts` from v0.11.0 to v1.0.0 and added `@clack/core` (PR #1514) -* **CI Integration** โ€” Added `validate:refs` to CI quality workflow with warning annotations (PR #1494) +- **Dependency Updates** โ€” Upgraded `@clack/prompts` from v0.11.0 to v1.0.0 and added `@clack/core` (PR #1514) +- **CI Integration** โ€” Added `validate:refs` to CI quality workflow with warning annotations (PR #1494) --- @@ -271,31 +272,31 @@ V6 Stable Release! The End of Beta! ### ๐ŸŽ Features -* **Add generate-project-context workflow** โ€” New 3-step workflow for project context generation, integrated with quick-flow-solo-dev agent -* **Shard market research customer analysis** โ€” Refactor monolithic customer insights into 4-step detailed customer behavior analysis workflow +- **Add generate-project-context workflow** โ€” New 3-step workflow for project context generation, integrated with quick-flow-solo-dev agent +- **Shard market research customer analysis** โ€” Refactor monolithic customer insights into 4-step detailed customer behavior analysis workflow ### ๐Ÿ› Bug Fixes -* **Fix npm install peer dependency issues** โ€” Add `.npmrc` with `legacy-peer-deps=true`, update Starlight to 0.37.5, and add `--legacy-peer-deps` flag to module installer (PR #1476) -* **Fix leaked source paths in PRD validation report** โ€” Replace absolute `/src/core/` paths with `{project-root}/_bmad/core/` (#1481) -* **Fix orphaned market research customer analysis** โ€” Connect step-01-init to step-02-customer-behavior to complete workflow sharding (#1486) -* **Fix duplicate 2-letter brainstorming code** โ€” Change BS to BSP to resolve conflict with cis Brainstorming module -* **Fix tech writer sidecar functionality** โ€” Enable proper sidecar operation (#1487) -* **Fix relative paths in workflow steps** โ€” Correct paths in step-11-polish (#1497) and step-e-04-complete (#1498) -* **Fix party-mode workflow file extension** โ€” Correct extension in workflow.xml (#1499) -* **Fix generated slash commands** โ€” Add `disable-model-invocation` to all generated commands (#1501) -* **Fix agent scan and help CSV files** โ€” Correct module-help.csv entries -* **Fix HELP_STEP placeholder replacement** โ€” Fix placeholder not replaced in compiled agents, fix hardcoded path, fix single quote (#1437) +- **Fix npm install peer dependency issues** โ€” Add `.npmrc` with `legacy-peer-deps=true`, update Starlight to 0.37.5, and add `--legacy-peer-deps` flag to module installer (PR #1476) +- **Fix leaked source paths in PRD validation report** โ€” Replace absolute `/src/core/` paths with `{project-root}/_bmad/core/` (#1481) +- **Fix orphaned market research customer analysis** โ€” Connect step-01-init to step-02-customer-behavior to complete workflow sharding (#1486) +- **Fix duplicate 2-letter brainstorming code** โ€” Change BS to BSP to resolve conflict with cis Brainstorming module +- **Fix tech writer sidecar functionality** โ€” Enable proper sidecar operation (#1487) +- **Fix relative paths in workflow steps** โ€” Correct paths in step-11-polish (#1497) and step-e-04-complete (#1498) +- **Fix party-mode workflow file extension** โ€” Correct extension in workflow.xml (#1499) +- **Fix generated slash commands** โ€” Add `disable-model-invocation` to all generated commands (#1501) +- **Fix agent scan and help CSV files** โ€” Correct module-help.csv entries +- **Fix HELP_STEP placeholder replacement** โ€” Fix placeholder not replaced in compiled agents, fix hardcoded path, fix single quote (#1437) ### ๐Ÿ“š Documentation -* **Add exact slash commands to Getting Started guide** โ€” Provide precise command examples for users (#1505) -* **Remove .claude/commands from version control** โ€” Commands are generated, not tracked (#1506) +- **Add exact slash commands to Getting Started guide** โ€” Provide precise command examples for users (#1505) +- **Remove .claude/commands from version control** โ€” Commands are generated, not tracked (#1506) ### ๐Ÿ”ง Maintenance -* **Update Starlight to 0.37.5** โ€” Latest version with peer dependency compatibility -* **Add GitHub issue templates** โ€” New bug-report.yaml and documentation.yaml templates +- **Update Starlight to 0.37.5** โ€” Latest version with peer dependency compatibility +- **Add GitHub issue templates** โ€” New bug-report.yaml and documentation.yaml templates --- @@ -319,13 +320,16 @@ V6 Stable Release! The End of Beta! ### ๐Ÿ”ง Features & Improvements **Module Changes:** + - **TEA Module Moved to External** (#1430, #1443): The TEA module is now external. SDET module added with a single "automate" workflow focused on test automation - **SDET Module**: New module with streamlined test automation capabilities **IDE Integration:** + - **Gemini CLI TOML Format** (#1431): Previous update accidentally switched Gemini to md instead of toml. **Sprint Status:** + - **Default project_key** (#1446): File-system based sprint status now uses a default project_key so certain LLMs do not complain ### ๐Ÿ› Bug Fixes @@ -695,7 +699,7 @@ Located in `src/modules/bmb/workflows/agent/data/`: - **Removed document-sharding-guide.md** from docs root (moved to core) - **Removed web-bundles-gemini-gpt-guide.md** - Consolidated into web-bundles/index.md - **Removed getting-started/installation.md** - Migrated to bmad-core-concepts -- **Removed all ide-info/*.md files** - Consolidated into web-bundles documentation +- **Removed all ide-info/\*.md files** - Consolidated into web-bundles documentation ### ๐Ÿ”ง Create-Tech-Spec Sharded Conversion @@ -826,6 +830,7 @@ Located in `src/modules/bmb/workflows/agent/data/`: - **Installer Cleanup**: Removed unused configuration code from BMM installer **Planning Artifacts Path:** + - Default: `planning_artifacts/` (configurable in module.yaml) - Previous: `docs/` - Benefit: Clear separation between planning work and permanent documentation diff --git a/docs/_STYLE_GUIDE.md b/docs/_STYLE_GUIDE.md index 99d686df6..8c455b025 100644 --- a/docs/_STYLE_GUIDE.md +++ b/docs/_STYLE_GUIDE.md @@ -1,5 +1,5 @@ --- -title: "Documentation Style Guide" +title: 'Documentation Style Guide' description: Project-specific documentation conventions based on Google style and Diataxis structure --- @@ -55,17 +55,17 @@ Critical warnings only โ€” data loss, security issues ```md | Phase | Name | What Happens | | ----- | -------- | -------------------------------------------- | -| 1 | Analysis | Brainstorm, research *(optional)* | -| 2 | Planning | Requirements โ€” PRD or tech-spec *(required)* | +| 1 | Analysis | Brainstorm, research _(optional)_ | +| 2 | Planning | Requirements โ€” PRD or tech-spec _(required)_ | ``` **Skills:** ```md -| Skill | Agent | Purpose | -| ------------ | ------- | ------------------------------------ | +| Skill | Agent | Purpose | +| -------------------- | ------- | ------------------------------------ | | `bmad-brainstorming` | Analyst | Brainstorm a new project | -| `bmad-create-prd` | PM | Create Product Requirements Document | +| `bmad-create-prd` | PM | Create Product Requirements Document | ``` ## Folder Structure Blocks @@ -353,7 +353,7 @@ Only for BMad Method and Enterprise tracks. Quick Flow skips to implementation. ### Can I change my plan later? -Yes. The SM agent has a `bmad-correct-course` workflow for handling scope changes. +Yes. The ADL agent has a `bmad-correct-course` workflow for handling scope changes. **Have a question not answered here?** [Open an issue](...) or ask in [Discord](...). ``` diff --git a/docs/reference/agents.md b/docs/reference/agents.md index 072bdb84e..8ee998cda 100644 --- a/docs/reference/agents.md +++ b/docs/reference/agents.md @@ -15,17 +15,17 @@ This page lists the default BMM (Agile suite) agents that install with BMad Meth - Triggers are the short menu codes (e.g., `CP`) and fuzzy matches shown in each agent menu. - QA (Quinn) is the lightweight test automation agent in BMM. The full Test Architect (TEA) lives in its own module. -| Agent | Skill ID | Triggers | Primary workflows | -| --------------------------- | -------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------- | -| Analyst (Mary) | `bmad-analyst` | `BP`, `RS`, `CB`, `DP` | Brainstorm Project, Research, Create Brief, Document Project | -| Product Manager (John) | `bmad-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | Create/Validate/Edit PRD, Create Epics and Stories, Implementation Readiness, Correct Course | -| Architect (Winston) | `bmad-architect` | `CA`, `IR` | Create Architecture, Implementation Readiness | -| Scrum Master (Bob) | `bmad-sm` | `SP`, `CS`, `ER`, `CC` | Sprint Planning, Create Story, Epic Retrospective, Correct Course | -| Developer (Amelia) | `bmad-dev` | `DS`, `CR` | Dev Story, Code Review | -| QA Engineer (Quinn) | `bmad-qa` | `QA` | Automate (generate tests for existing features) | -| Quick Flow Solo Dev (Barry) | `bmad-master` | `QS`, `QD`, `CR` | Quick Spec, Quick Dev, Code Review | -| UX Designer (Sally) | `bmad-ux-designer` | `CU` | Create UX Design | -| Technical Writer (Paige) | `bmad-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Document Project, Write Document, Update Standards, Mermaid Generate, Validate Doc, Explain Concept | +| Agent | Skill ID | Triggers | Primary workflows | +| --------------------------- | ------------------ | ---------------------------------- | --------------------------------------------------------------------------------------------------- | +| Analyst (Mary) | `bmad-analyst` | `BP`, `RS`, `CB`, `DP` | Brainstorm Project, Research, Create Brief, Document Project | +| Product Manager (John) | `bmad-pm` | `CP`, `VP`, `EP`, `CE`, `IR`, `CC` | Create/Validate/Edit PRD, Create Epics and Stories, Implementation Readiness, Correct Course | +| Architect (Winston) | `bmad-architect` | `CA`, `IR` | Create Architecture, Implementation Readiness | +| Agile Delivery Lead (Bob) | `bmad-adl` | `SP`, `CS`, `ER`, `CC` | Sprint Planning, Create Story, Epic Retrospective, Correct Course | +| Developer (Amelia) | `bmad-dev` | `DS`, `CR` | Dev Story, Code Review | +| QA Engineer (Quinn) | `bmad-qa` | `QA` | Automate (generate tests for existing features) | +| Quick Flow Solo Dev (Barry) | `bmad-master` | `QS`, `QD`, `CR` | Quick Spec, Quick Dev, Code Review | +| UX Designer (Sally) | `bmad-ux-designer` | `CU` | Create UX Design | +| Technical Writer (Paige) | `bmad-tech-writer` | `DP`, `WD`, `US`, `MG`, `VD`, `EC` | Document Project, Write Document, Update Standards, Mermaid Generate, Validate Doc, Explain Concept | ## Trigger Types @@ -41,13 +41,13 @@ Examples: `CP` (Create PRD), `DS` (Dev Story), `CA` (Create Architecture), `QS` Some triggers start a free-form conversation instead of a structured workflow. These expect you to describe what you need alongside the trigger code. -| Agent | Trigger | What to provide | -| --- | --- | --- | -| Technical Writer (Paige) | `WD` | Description of the document to write | -| Technical Writer (Paige) | `US` | Preferences or conventions to add to standards | -| Technical Writer (Paige) | `MG` | Diagram description and type (sequence, flowchart, etc.) | -| Technical Writer (Paige) | `VD` | Document to validate and focus areas | -| Technical Writer (Paige) | `EC` | Concept name to explain | +| Agent | Trigger | What to provide | +| ------------------------ | ------- | -------------------------------------------------------- | +| Technical Writer (Paige) | `WD` | Description of the document to write | +| Technical Writer (Paige) | `US` | Preferences or conventions to add to standards | +| Technical Writer (Paige) | `MG` | Diagram description and type (sequence, flowchart, etc.) | +| Technical Writer (Paige) | `VD` | Document to validate and focus areas | +| Technical Writer (Paige) | `EC` | Concept name to explain | **Example:** diff --git a/docs/reference/commands.md b/docs/reference/commands.md index 0de99157c..251c32893 100644 --- a/docs/reference/commands.md +++ b/docs/reference/commands.md @@ -11,9 +11,9 @@ Skills are pre-built prompts that load agents, run workflows, or execute tasks i BMad offers two ways to start work, and they serve different purposes. -| Mechanism | How you invoke it | What happens | -| --- | --- | --- | -| **Skill** | Type the skill name (e.g. `bmad-help`) in your IDE | Directly loads an agent, runs a workflow, or executes a task | +| Mechanism | How you invoke it | What happens | +| ---------------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------- | +| **Skill** | Type the skill name (e.g. `bmad-help`) in your IDE | Directly loads an agent, runs a workflow, or executes a task | | **Agent menu trigger** | Load an agent first, then type a short code (e.g. `DS`) | The agent interprets the code and starts the matching workflow while staying in character | Agent menu triggers require an active agent session. Use skills when you know which workflow you want. Use triggers when you are already working with an agent and want to switch tasks without leaving the conversation. @@ -24,12 +24,12 @@ When you run `npx bmad-method install`, the installer reads the manifests for ev The installer uses templates for each skill type: -| Skill type | What the generated file does | -| --- | --- | +| Skill type | What the generated file does | +| ------------------ | ------------------------------------------------------------------------ | | **Agent launcher** | Loads the agent persona file, activates its menu, and stays in character | -| **Workflow skill** | Loads the workflow config and follows its steps | -| **Task skill** | Loads a standalone task file and follows its instructions | -| **Tool skill** | Loads a standalone tool file and follows its instructions | +| **Workflow skill** | Loads the workflow config and follows its steps | +| **Task skill** | Loads a standalone task file and follows its instructions | +| **Tool skill** | Loads a standalone tool file and follows its instructions | :::note[Re-running the installer] If you add or remove modules, run the installer again. It regenerates all skill files to match your current module selection. @@ -39,12 +39,12 @@ If you add or remove modules, run the installer again. It regenerates all skill The installer writes skill files into an IDE-specific directory inside your project. The exact path depends on which IDE you selected during installation. -| IDE / CLI | Skills directory | -| --- | --- | -| Claude Code | `.claude/skills/` | -| Cursor | `.cursor/skills/` | -| Windsurf | `.windsurf/skills/` | -| Other IDEs | See the installer output for the target path | +| IDE / CLI | Skills directory | +| ----------- | -------------------------------------------- | +| Claude Code | `.claude/skills/` | +| Cursor | `.cursor/skills/` | +| Windsurf | `.windsurf/skills/` | +| Other IDEs | See the installer output for the target path | Each skill is a directory containing a `SKILL.md` file. For example, a Claude Code installation looks like: @@ -77,12 +77,12 @@ The generated skill directories in your project are the canonical list. Open the Agent skills load a specialized AI persona with a defined role, communication style, and menu of workflows. Once loaded, the agent stays in character and responds to menu triggers. -| Example skill | Agent | Role | -| --- | --- | --- | -| `bmad-dev` | Amelia (Developer) | Implements stories with strict adherence to specs | -| `bmad-pm` | John (Product Manager) | Creates and validates PRDs | -| `bmad-architect` | Winston (Architect) | Designs system architecture | -| `bmad-sm` | Bob (Scrum Master) | Manages sprints and stories | +| Example skill | Agent | Role | +| ---------------- | ------------------------- | ------------------------------------------------- | +| `bmad-dev` | Amelia (Developer) | Implements stories with strict adherence to specs | +| `bmad-pm` | John (Product Manager) | Creates and validates PRDs | +| `bmad-architect` | Winston (Architect) | Designs system architecture | +| `bmad-adl` | Bob (Agile Delivery Lead) | Manages sprints and stories | See [Agents](./agents.md) for the full list of default agents and their triggers. @@ -90,14 +90,14 @@ See [Agents](./agents.md) for the full list of default agents and their triggers Workflow skills run a structured, multi-step process without loading an agent persona first. They load a workflow configuration and follow its steps. -| Example skill | Purpose | -| --- | --- | -| `bmad-create-prd` | Create a Product Requirements Document | -| `bmad-create-architecture` | Design system architecture | -| `bmad-create-epics-and-stories` | Create epics and stories | -| `bmad-dev-story` | Implement a story | -| `bmad-code-review` | Run a code review | -| `bmad-quick-spec` | Define an ad-hoc change (Quick Flow) | +| Example skill | Purpose | +| ------------------------------- | -------------------------------------- | +| `bmad-create-prd` | Create a Product Requirements Document | +| `bmad-create-architecture` | Design system architecture | +| `bmad-create-epics-and-stories` | Create epics and stories | +| `bmad-dev-story` | Implement a story | +| `bmad-code-review` | Run a code review | +| `bmad-quick-spec` | Define an ad-hoc change (Quick Flow) | See [Workflow Map](./workflow-map.md) for the complete workflow reference organized by phase. @@ -126,11 +126,11 @@ bmad-help I'm stuck on the PRD workflow #### Other Tasks and Tools -| Example skill | Purpose | -| --- | --- | -| `bmad-shard-doc` | Split a large markdown file into smaller sections | -| `bmad-index-docs` | Index project documentation | -| `bmad-editorial-review-prose` | Review document prose quality | +| Example skill | Purpose | +| ----------------------------- | ------------------------------------------------- | +| `bmad-shard-doc` | Split a large markdown file into smaller sections | +| `bmad-index-docs` | Index project documentation | +| `bmad-editorial-review-prose` | Review document prose quality | ## Naming Convention diff --git a/docs/tutorials/getting-started.md b/docs/tutorials/getting-started.md index 43b5ba2e9..1175dc0f1 100644 --- a/docs/tutorials/getting-started.md +++ b/docs/tutorials/getting-started.md @@ -1,5 +1,5 @@ --- -title: "Getting Started" +title: 'Getting Started' description: Install BMad and build your first project --- @@ -14,11 +14,12 @@ Build software faster using AI-powered workflows with specialized agents that gu - Use agents and workflows effectively :::note[Prerequisites] + - **Node.js 20+** โ€” Required for the installer - **Git** โ€” Recommended for version control - **AI-powered IDE** โ€” Claude Code, Cursor, or similar - **A project idea** โ€” Even a simple one works for learning -::: + ::: :::tip[The Easiest Path] **Install** โ†’ `npx bmad-method install` @@ -50,6 +51,7 @@ bmad-help I have an idea for a SaaS product, I already know all the features I w ``` BMad-Help will respond with: + - What's recommended for your situation - What the first required task is - What the rest of the process looks like @@ -68,9 +70,9 @@ BMad helps you build software through guided workflows with specialized AI agent | Phase | Name | What Happens | | ----- | -------------- | --------------------------------------------------- | -| 1 | Analysis | Brainstorming, research, product brief *(optional)* | +| 1 | Analysis | Brainstorming, research, product brief _(optional)_ | | 2 | Planning | Create requirements (PRD or tech-spec) | -| 3 | Solutioning | Design architecture *(BMad Method/Enterprise only)* | +| 3 | Solutioning | Design architecture _(BMad Method/Enterprise only)_ | | 4 | Implementation | Build epic by epic, story by story | **[Open the Workflow Map](../reference/workflow-map.md)** to explore phases, workflows, and context management. @@ -100,6 +102,7 @@ If you want the newest prerelease build instead of the default release channel, When prompted to select modules, choose **BMad Method**. The installer creates two folders: + - `_bmad/` โ€” agents, workflows, tasks, and configuration - `_bmad-output/` โ€” empty for now, but this is where your artifacts will be saved @@ -134,6 +137,7 @@ Create it manually at `_bmad-output/project-context.md` or generate it after arc ### Phase 1: Analysis (Optional) All workflows in this phase are optional: + - **brainstorming** (`bmad-brainstorming`) โ€” Guided ideation - **research** (`bmad-research`) โ€” Market and technical research - **create-product-brief** (`bmad-create-product-brief`) โ€” Recommended foundation document @@ -141,11 +145,13 @@ All workflows in this phase are optional: ### Phase 2: Planning (Required) **For BMad Method and Enterprise tracks:** + 1. Invoke the **PM agent** (`bmad-pm`) in a new chat 2. Run the `bmad-create-prd` workflow (`bmad-create-prd`) 3. Output: `PRD.md` **For Quick Flow track:** + - Use the `bmad-quick-spec` workflow (`bmad-quick-spec`) instead of PRD, then skip to implementation :::note[UX Design (Optional)] @@ -155,6 +161,7 @@ If your project has a user interface, invoke the **UX-Designer agent** (`bmad-ux ### Phase 3: Solutioning (BMad Method/Enterprise) **Create Architecture** + 1. Invoke the **Architect agent** (`bmad-architect`) in a new chat 2. Run `bmad-create-architecture` (`bmad-create-architecture`) 3. Output: Architecture document with technical decisions @@ -162,14 +169,15 @@ If your project has a user interface, invoke the **UX-Designer agent** (`bmad-ux **Create Epics and Stories** :::tip[V6 Improvement] -Epics and stories are now created *after* architecture. This produces better quality stories because architecture decisions (database, API patterns, tech stack) directly affect how work should be broken down. +Epics and stories are now created _after_ architecture. This produces better quality stories because architecture decisions (database, API patterns, tech stack) directly affect how work should be broken down. ::: 1. Invoke the **PM agent** (`bmad-pm`) in a new chat 2. Run `bmad-create-epics-and-stories` (`bmad-create-epics-and-stories`) 3. The workflow uses both PRD and Architecture to create technically-informed stories -**Implementation Readiness Check** *(Highly Recommended)* +**Implementation Readiness Check** _(Highly Recommended)_ + 1. Invoke the **Architect agent** (`bmad-architect`) in a new chat 2. Run `bmad-check-implementation-readiness` (`bmad-check-implementation-readiness`) 3. Validates cohesion across all planning documents @@ -180,19 +188,19 @@ Once planning is complete, move to implementation. **Each workflow should run in ### Initialize Sprint Planning -Invoke the **SM agent** (`bmad-sm`) and run `bmad-sprint-planning` (`bmad-sprint-planning`). This creates `sprint-status.yaml` to track all epics and stories. +Invoke the **ADL agent** (`bmad-adl`) and run `bmad-sprint-planning` (`bmad-sprint-planning`). This creates `sprint-status.yaml` to track all epics and stories. ### The Build Cycle For each story, repeat this cycle with fresh chats: -| Step | Agent | Workflow | Command | Purpose | -| ---- | ----- | -------------- | -------------------------- | ---------------------------------- | -| 1 | SM | `bmad-create-story` | `bmad-create-story` | Create story file from epic | -| 2 | DEV | `bmad-dev-story` | `bmad-dev-story` | Implement the story | -| 3 | DEV | `bmad-code-review` | `bmad-code-review` | Quality validation *(recommended)* | +| Step | Agent | Workflow | Command | Purpose | +| ---- | ----- | ------------------- | ------------------- | ---------------------------------- | +| 1 | ADL | `bmad-create-story` | `bmad-create-story` | Create story file from epic | +| 2 | DEV | `bmad-dev-story` | `bmad-dev-story` | Implement the story | +| 3 | DEV | `bmad-code-review` | `bmad-code-review` | Quality validation _(recommended)_ | -After completing all stories in an epic, invoke the **SM agent** (`bmad-sm`) and run `bmad-retrospective` (`bmad-retrospective`). +After completing all stories in an epic, invoke the **ADL agent** (`bmad-adl`) and run `bmad-retrospective` (`bmad-retrospective`). ## What You've Accomplished @@ -221,18 +229,18 @@ your-project/ ## Quick Reference -| Workflow | Command | Agent | Purpose | -| ------------------------------------- | ------------------------------------------ | --------- | ----------------------------------------------- | -| **`bmad-help`** โญ | `bmad-help` | Any | **Your intelligent guide โ€” ask anything!** | -| `bmad-create-prd` | `bmad-create-prd` | PM | Create Product Requirements Document | -| `bmad-create-architecture` | `bmad-create-architecture` | Architect | Create architecture document | -| `bmad-generate-project-context` | `bmad-generate-project-context` | Analyst | Create project context file | -| `bmad-create-epics-and-stories` | `bmad-create-epics-and-stories` | PM | Break down PRD into epics | -| `bmad-check-implementation-readiness` | `bmad-check-implementation-readiness` | Architect | Validate planning cohesion | -| `bmad-sprint-planning` | `bmad-sprint-planning` | SM | Initialize sprint tracking | -| `bmad-create-story` | `bmad-create-story` | SM | Create a story file | -| `bmad-dev-story` | `bmad-dev-story` | DEV | Implement a story | -| `bmad-code-review` | `bmad-code-review` | DEV | Review implemented code | +| Workflow | Command | Agent | Purpose | +| ------------------------------------- | ------------------------------------- | --------- | ------------------------------------------ | +| **`bmad-help`** โญ | `bmad-help` | Any | **Your intelligent guide โ€” ask anything!** | +| `bmad-create-prd` | `bmad-create-prd` | PM | Create Product Requirements Document | +| `bmad-create-architecture` | `bmad-create-architecture` | Architect | Create architecture document | +| `bmad-generate-project-context` | `bmad-generate-project-context` | Analyst | Create project context file | +| `bmad-create-epics-and-stories` | `bmad-create-epics-and-stories` | PM | Break down PRD into epics | +| `bmad-check-implementation-readiness` | `bmad-check-implementation-readiness` | Architect | Validate planning cohesion | +| `bmad-sprint-planning` | `bmad-sprint-planning` | ADL | Initialize sprint tracking | +| `bmad-create-story` | `bmad-create-story` | ADL | Create a story file | +| `bmad-dev-story` | `bmad-dev-story` | DEV | Implement a story | +| `bmad-code-review` | `bmad-code-review` | DEV | Review implemented code | ## Common Questions @@ -240,7 +248,7 @@ your-project/ Only for BMad Method and Enterprise tracks. Quick Flow skips from tech-spec to implementation. **Can I change my plan later?** -Yes. The SM agent has a `bmad-correct-course` workflow (`bmad-correct-course`) for handling scope changes. +Yes. The ADL agent has a `bmad-correct-course` workflow (`bmad-correct-course`) for handling scope changes. **What if I want to brainstorm first?** Invoke the Analyst agent (`bmad-analyst`) and run `bmad-brainstorming` (`bmad-brainstorming`) before starting your PRD. @@ -252,6 +260,7 @@ Not strictly. Once you learn the flow, you can run workflows directly using the :::tip[First Stop: BMad-Help] **Invoke `bmad-help` anytime** โ€” it's the fastest way to get unstuck. Ask it anything: + - "What should I do after installing?" - "I'm stuck on workflow X" - "What are my options for Y?" @@ -266,10 +275,11 @@ BMad-Help inspects your project, detects what you've completed, and tells you ex ## Key Takeaways :::tip[Remember These] + - **Start with `bmad-help`** โ€” Your intelligent guide that knows your project and options - **Always use fresh chats** โ€” Start a new chat for each workflow - **Track matters** โ€” Quick Flow uses quick-spec; Method/Enterprise need PRD and architecture - **BMad-Help runs automatically** โ€” Every workflow ends with guidance on what's next -::: + ::: Ready to start? Install BMad, invoke `bmad-help`, and let your intelligent guide lead the way. diff --git a/docs/zh-cn/_STYLE_GUIDE.md b/docs/zh-cn/_STYLE_GUIDE.md index c6e9eff58..f979a3bba 100644 --- a/docs/zh-cn/_STYLE_GUIDE.md +++ b/docs/zh-cn/_STYLE_GUIDE.md @@ -1,5 +1,5 @@ --- -title: "Documentation Style Guide" +title: 'Documentation Style Guide' description: Project-specific documentation conventions based on Google style and Diataxis structure --- @@ -55,8 +55,8 @@ Critical warnings only โ€” data loss, security issues ```md | Phase | Name | What Happens | | ----- | -------- | -------------------------------------------- | -| 1 | Analysis | Brainstorm, research *(optional)* | -| 2 | Planning | Requirements โ€” PRD or tech-spec *(required)* | +| 1 | Analysis | Brainstorm, research _(optional)_ | +| 2 | Planning | Requirements โ€” PRD or tech-spec _(required)_ | ``` **Commands:** @@ -353,7 +353,7 @@ Only for BMad Method and Enterprise tracks. Quick Flow skips to implementation. ### Can I change my plan later? -Yes. The SM agent has a `correct-course` workflow for handling scope changes. +Yes. The ADL agent has a `correct-course` workflow for handling scope changes. **Have a question not answered here?** [Open an issue](...) or ask in [Discord](...). ``` diff --git a/docs/zh-cn/reference/commands.md b/docs/zh-cn/reference/commands.md index 773998cfd..0f6a7cb56 100644 --- a/docs/zh-cn/reference/commands.md +++ b/docs/zh-cn/reference/commands.md @@ -1,5 +1,5 @@ --- -title: "ๅ‘ฝไปค" +title: 'ๅ‘ฝไปค' description: BMad ๆ–œๆ ๅ‘ฝไปคๅ‚่€ƒโ€”โ€”ๅฎƒไปฌๆ˜ฏไป€ไนˆใ€ๅฆ‚ไฝ•ๅทฅไฝœไปฅๅŠๅœจๅ“ช้‡Œๆ‰พๅˆฐๅฎƒไปฌใ€‚ sidebar: order: 3 @@ -11,9 +11,9 @@ sidebar: BMad ๆไพ›ไธค็งๅผ€ๅง‹ๅทฅไฝœ็š„ๆ–นๅผ๏ผŒๅฎƒไปฌๆœๅŠกไบŽไธๅŒ็š„็›ฎ็š„ใ€‚ -| ๆœบๅˆถ | ่ฐƒ็”จๆ–นๅผ | ๅ‘็”Ÿไป€ไนˆ | -| --- | --- | --- | -| **ๆ–œๆ ๅ‘ฝไปค** | ๅœจ IDE ไธญ่พ“ๅ…ฅ `bmad-...` | ็›ดๆŽฅๅŠ ่ฝฝๆ™บ่ƒฝไฝ“ใ€่ฟ่กŒๅทฅไฝœๆตๆˆ–ๆ‰ง่กŒไปปๅŠก | +| ๆœบๅˆถ | ่ฐƒ็”จๆ–นๅผ | ๅ‘็”Ÿไป€ไนˆ | +| -------------------- | ------------------------------------------- | -------------------------------------------------- | +| **ๆ–œๆ ๅ‘ฝไปค** | ๅœจ IDE ไธญ่พ“ๅ…ฅ `bmad-...` | ็›ดๆŽฅๅŠ ่ฝฝๆ™บ่ƒฝไฝ“ใ€่ฟ่กŒๅทฅไฝœๆตๆˆ–ๆ‰ง่กŒไปปๅŠก | | **ๆ™บ่ƒฝไฝ“่œๅ•่งฆๅ‘ๅ™จ** | ๅ…ˆๅŠ ่ฝฝๆ™บ่ƒฝไฝ“๏ผŒ็„ถๅŽ่พ“ๅ…ฅ็ฎ€็Ÿญไปฃ็ ๏ผˆไพ‹ๅฆ‚ `DS`๏ผ‰ | ๆ™บ่ƒฝไฝ“่งฃ้‡Šไปฃ็ ๅนถๅฏๅŠจๅŒน้…็š„ๅทฅไฝœๆต๏ผŒๅŒๆ—ถไฟๆŒ่ง’่‰ฒ่ฎพๅฎš | ๆ™บ่ƒฝไฝ“่œๅ•่งฆๅ‘ๅ™จ้œ€่ฆๆดปๅŠจ็š„ๆ™บ่ƒฝไฝ“ไผš่ฏใ€‚ๅฝ“ๆ‚จ็Ÿฅ้“่ฆไฝฟ็”จๅ“ชไธชๅทฅไฝœๆตๆ—ถ๏ผŒไฝฟ็”จๆ–œๆ ๅ‘ฝไปคใ€‚ๅฝ“ๆ‚จๅทฒ็ปไธŽๆ™บ่ƒฝไฝ“ไธ€่ตทๅทฅไฝœๅนถๅธŒๆœ›ๅœจไธ็ฆปๅผ€ๅฏน่ฏ็š„ๆƒ…ๅ†ตไธ‹ๅˆ‡ๆขไปปๅŠกๆ—ถ๏ผŒไฝฟ็”จ่งฆๅ‘ๅ™จใ€‚ @@ -24,12 +24,12 @@ BMad ๆไพ›ไธค็งๅผ€ๅง‹ๅทฅไฝœ็š„ๆ–นๅผ๏ผŒๅฎƒไปฌๆœๅŠกไบŽไธๅŒ็š„็›ฎ็š„ใ€‚ ๅฎ‰่ฃ…็จ‹ๅบไธบๆฏ็งๅ‘ฝไปค็ฑปๅž‹ไฝฟ็”จๆจกๆฟ๏ผš -| ๅ‘ฝไปค็ฑปๅž‹ | ็”Ÿๆˆ็š„ๆ–‡ไปถ็š„ไฝœ็”จ | -| --- | --- | -| **ๆ™บ่ƒฝไฝ“ๅฏๅŠจๅ™จ** | ๅŠ ่ฝฝๆ™บ่ƒฝไฝ“่ง’่‰ฒๆ–‡ไปถ๏ผŒๆฟ€ๆดปๅ…ถ่œๅ•๏ผŒๅนถไฟๆŒ่ง’่‰ฒ่ฎพๅฎš | -| **ๅทฅไฝœๆตๅ‘ฝไปค** | ๅŠ ่ฝฝๅทฅไฝœๆตๅผ•ๆ“Ž๏ผˆ`workflow.xml`๏ผ‰ๅนถไผ ้€’ๅทฅไฝœๆต้…็ฝฎ | -| **ไปปๅŠกๅ‘ฝไปค** | ๅŠ ่ฝฝ็‹ฌ็ซ‹ไปปๅŠกๆ–‡ไปถๅนถ้ตๅพชๅ…ถๆŒ‡ไปค | -| **ๅทฅๅ…ทๅ‘ฝไปค** | ๅŠ ่ฝฝ็‹ฌ็ซ‹ๅทฅๅ…ทๆ–‡ไปถๅนถ้ตๅพชๅ…ถๆŒ‡ไปค | +| ๅ‘ฝไปค็ฑปๅž‹ | ็”Ÿๆˆ็š„ๆ–‡ไปถ็š„ไฝœ็”จ | +| ---------------- | ------------------------------------------------ | +| **ๆ™บ่ƒฝไฝ“ๅฏๅŠจๅ™จ** | ๅŠ ่ฝฝๆ™บ่ƒฝไฝ“่ง’่‰ฒๆ–‡ไปถ๏ผŒๆฟ€ๆดปๅ…ถ่œๅ•๏ผŒๅนถไฟๆŒ่ง’่‰ฒ่ฎพๅฎš | +| **ๅทฅไฝœๆตๅ‘ฝไปค** | ๅŠ ่ฝฝๅทฅไฝœๆตๅผ•ๆ“Ž๏ผˆ`workflow.xml`๏ผ‰ๅนถไผ ้€’ๅทฅไฝœๆต้…็ฝฎ | +| **ไปปๅŠกๅ‘ฝไปค** | ๅŠ ่ฝฝ็‹ฌ็ซ‹ไปปๅŠกๆ–‡ไปถๅนถ้ตๅพชๅ…ถๆŒ‡ไปค | +| **ๅทฅๅ…ทๅ‘ฝไปค** | ๅŠ ่ฝฝ็‹ฌ็ซ‹ๅทฅๅ…ทๆ–‡ไปถๅนถ้ตๅพชๅ…ถๆŒ‡ไปค | :::note[้‡ๆ–ฐ่ฟ่กŒๅฎ‰่ฃ…็จ‹ๅบ] ๅฆ‚ๆžœๆ‚จๆทปๅŠ ๆˆ–ๅˆ ้™คๆจกๅ—๏ผŒ่ฏทๅ†ๆฌก่ฟ่กŒๅฎ‰่ฃ…็จ‹ๅบใ€‚ๅฎƒไผš้‡ๆ–ฐ็”Ÿๆˆๆ‰€ๆœ‰ๅ‘ฝไปคๆ–‡ไปถไปฅๅŒน้…ๆ‚จๅฝ“ๅ‰็š„ๆจกๅ—้€‰ๆ‹ฉใ€‚ @@ -39,12 +39,12 @@ BMad ๆไพ›ไธค็งๅผ€ๅง‹ๅทฅไฝœ็š„ๆ–นๅผ๏ผŒๅฎƒไปฌๆœๅŠกไบŽไธๅŒ็š„็›ฎ็š„ใ€‚ ๅฎ‰่ฃ…็จ‹ๅบๅฐ†ๅ‘ฝไปคๆ–‡ไปถๅ†™ๅ…ฅ้กน็›ฎๅ†… IDE ็‰นๅฎš็š„็›ฎๅฝ•ไธญใ€‚็กฎๅˆ‡่ทฏๅพ„ๅ–ๅ†ณไบŽๆ‚จๅœจๅฎ‰่ฃ…ๆœŸ้—ด้€‰ๆ‹ฉ็š„ IDEใ€‚ -| IDE / CLI | ๅ‘ฝไปค็›ฎๅฝ• | -| --- | --- | -| Claude Code | `.claude/commands/` | -| Cursor | `.cursor/commands/` | -| Windsurf | `.windsurf/workflows/` | -| ๅ…ถไป– IDE | ่ฏทๅ‚้˜…ๅฎ‰่ฃ…็จ‹ๅบ่พ“ๅ‡บไธญ็š„็›ฎๆ ‡่ทฏๅพ„ | +| IDE / CLI | ๅ‘ฝไปค็›ฎๅฝ• | +| ----------- | ------------------------------ | +| Claude Code | `.claude/commands/` | +| Cursor | `.cursor/commands/` | +| Windsurf | `.windsurf/workflows/` | +| ๅ…ถไป– IDE | ่ฏทๅ‚้˜…ๅฎ‰่ฃ…็จ‹ๅบ่พ“ๅ‡บไธญ็š„็›ฎๆ ‡่ทฏๅพ„ | ๆ‰€ๆœ‰ IDE ้ƒฝๅœจๅ…ถๅ‘ฝไปค็›ฎๅฝ•ไธญๆŽฅๆ”ถไธ€็ป„ๆ‰ๅนณ็š„ๅ‘ฝไปคๆ–‡ไปถใ€‚ไพ‹ๅฆ‚๏ผŒClaude Code ๅฎ‰่ฃ…็œ‹่ตทๆฅๅƒ๏ผš @@ -76,12 +76,12 @@ BMad ๆไพ›ไธค็งๅผ€ๅง‹ๅทฅไฝœ็š„ๆ–นๅผ๏ผŒๅฎƒไปฌๆœๅŠกไบŽไธๅŒ็š„็›ฎ็š„ใ€‚ ๆ™บ่ƒฝไฝ“ๅ‘ฝไปคๅŠ ่ฝฝๅ…ทๆœ‰ๅฎšไน‰่ง’่‰ฒใ€ๆฒŸ้€š้ฃŽๆ ผๅ’Œๅทฅไฝœๆต่œๅ•็š„ไธ“ไธšๅŒ– AI ่ง’่‰ฒใ€‚ๅŠ ่ฝฝๅŽ๏ผŒๆ™บ่ƒฝไฝ“ไฟๆŒ่ง’่‰ฒ่ฎพๅฎšๅนถๅ“ๅบ”่œๅ•่งฆๅ‘ๅ™จใ€‚ -| ็คบไพ‹ๅ‘ฝไปค | ๆ™บ่ƒฝไฝ“ | ่ง’่‰ฒ | -| --- | --- | --- | -| `bmad-agent-bmm-dev` | Amelia๏ผˆๅผ€ๅ‘่€…๏ผ‰ | ไธฅๆ ผๆŒ‰็…ง่ง„่Œƒๅฎž็Žฐๆ•…ไบ‹ | -| `bmad-agent-bmm-pm` | John๏ผˆไบงๅ“็ป็†๏ผ‰ | ๅˆ›ๅปบๅ’Œ้ชŒ่ฏ PRD | -| `bmad-agent-bmm-architect` | Winston๏ผˆๆžถๆž„ๅธˆ๏ผ‰ | ่ฎพ่ฎก็ณป็ปŸๆžถๆž„ | -| `bmad-agent-bmm-sm` | Bob๏ผˆScrum Master๏ผ‰ | ็ฎก็†ๅ†ฒๅˆบๅ’Œๆ•…ไบ‹ | +| ็คบไพ‹ๅ‘ฝไปค | ๆ™บ่ƒฝไฝ“ | ่ง’่‰ฒ | +| -------------------------- | -------------------------- | -------------------- | +| `bmad-agent-bmm-dev` | Amelia๏ผˆๅผ€ๅ‘่€…๏ผ‰ | ไธฅๆ ผๆŒ‰็…ง่ง„่Œƒๅฎž็Žฐๆ•…ไบ‹ | +| `bmad-agent-bmm-pm` | John๏ผˆไบงๅ“็ป็†๏ผ‰ | ๅˆ›ๅปบๅ’Œ้ชŒ่ฏ PRD | +| `bmad-agent-bmm-architect` | Winston๏ผˆๆžถๆž„ๅธˆ๏ผ‰ | ่ฎพ่ฎก็ณป็ปŸๆžถๆž„ | +| `bmad-agent-bmm-adl` | Bob๏ผˆAgile Delivery Lead๏ผ‰ | ็ฎก็†ๅ†ฒๅˆบๅ’Œๆ•…ไบ‹ | ๅ‚่ง[ๆ™บ่ƒฝไฝ“](./agents.md)่Žทๅ–้ป˜่ฎคๆ™บ่ƒฝไฝ“ๅŠๅ…ถ่งฆๅ‘ๅ™จ็š„ๅฎŒๆ•ดๅˆ—่กจใ€‚ @@ -89,13 +89,13 @@ BMad ๆไพ›ไธค็งๅผ€ๅง‹ๅทฅไฝœ็š„ๆ–นๅผ๏ผŒๅฎƒไปฌๆœๅŠกไบŽไธๅŒ็š„็›ฎ็š„ใ€‚ ๅทฅไฝœๆตๅ‘ฝไปค่ฟ่กŒ็ป“ๆž„ๅŒ–็š„ๅคšๆญฅ้ชค่ฟ‡็จ‹๏ผŒ่€Œๆ— ้œ€ๅ…ˆๅŠ ่ฝฝๆ™บ่ƒฝไฝ“่ง’่‰ฒใ€‚ๅฎƒไปฌๅŠ ่ฝฝๅทฅไฝœๆตๅผ•ๆ“Žๅนถไผ ้€’็‰นๅฎš็š„ๅทฅไฝœๆต้…็ฝฎใ€‚ -| ็คบไพ‹ๅ‘ฝไปค | ็›ฎ็š„ | -| --- | --- | -| `bmad-bmm-create-prd` | ๅˆ›ๅปบไบงๅ“้œ€ๆฑ‚ๆ–‡ๆกฃ | -| `bmad-bmm-create-architecture` | ่ฎพ่ฎก็ณป็ปŸๆžถๆž„ | -| `bmad-bmm-dev-story` | ๅฎž็Žฐๆ•…ไบ‹ | -| `bmad-bmm-code-review` | ่ฟ่กŒไปฃ็ ๅฎกๆŸฅ | -| `bmad-bmm-quick-spec` | ๅฎšไน‰ไธดๆ—ถๆ›ดๆ”น๏ผˆๅฟซ้€Ÿๆต็จ‹๏ผ‰ | +| ็คบไพ‹ๅ‘ฝไปค | ็›ฎ็š„ | +| ------------------------------ | ------------------------ | +| `bmad-bmm-create-prd` | ๅˆ›ๅปบไบงๅ“้œ€ๆฑ‚ๆ–‡ๆกฃ | +| `bmad-bmm-create-architecture` | ่ฎพ่ฎก็ณป็ปŸๆžถๆž„ | +| `bmad-bmm-dev-story` | ๅฎž็Žฐๆ•…ไบ‹ | +| `bmad-bmm-code-review` | ่ฟ่กŒไปฃ็ ๅฎกๆŸฅ | +| `bmad-bmm-quick-spec` | ๅฎšไน‰ไธดๆ—ถๆ›ดๆ”น๏ผˆๅฟซ้€Ÿๆต็จ‹๏ผ‰ | ๅ‚่ง[ๅทฅไฝœๆตๅœฐๅ›พ](./workflow-map.md)่Žทๅ–ๆŒ‰้˜ถๆฎต็ป„็ป‡็š„ๅฎŒๆ•ดๅทฅไฝœๆตๅ‚่€ƒใ€‚ @@ -124,21 +124,21 @@ bmad-help ๆˆ‘ๅœจ PRD ๅทฅไฝœๆตไธŠๅกไฝไบ† #### ๅ…ถไป–ไปปๅŠกๅ’Œๅทฅๅ…ท -| ็คบไพ‹ๅ‘ฝไปค | ็›ฎ็š„ | -| --- | --- | -| `bmad-shard-doc` | ๅฐ†ๅคงๅž‹ Markdown ๆ–‡ไปถๆ‹†ๅˆ†ไธบ่พƒๅฐ็š„้ƒจๅˆ† | -| `bmad-index-docs` | ็ดขๅผ•้กน็›ฎๆ–‡ๆกฃ | -| `bmad-editorial-review-prose` | ๅฎกๆŸฅๆ–‡ๆกฃๆ•ฃๆ–‡่ดจ้‡ | +| ็คบไพ‹ๅ‘ฝไปค | ็›ฎ็š„ | +| ----------------------------- | ------------------------------------ | +| `bmad-shard-doc` | ๅฐ†ๅคงๅž‹ Markdown ๆ–‡ไปถๆ‹†ๅˆ†ไธบ่พƒๅฐ็š„้ƒจๅˆ† | +| `bmad-index-docs` | ็ดขๅผ•้กน็›ฎๆ–‡ๆกฃ | +| `bmad-editorial-review-prose` | ๅฎกๆŸฅๆ–‡ๆกฃๆ•ฃๆ–‡่ดจ้‡ | ## ๅ‘ฝๅ็บฆๅฎš ๅ‘ฝไปคๅ็งฐ้ตๅพชๅฏ้ข„ๆต‹็š„ๆจกๅผใ€‚ -| ๆจกๅผ | ๅซไน‰ | ็คบไพ‹ | -| --- | --- | --- | -| `bmad-agent--` | ๆ™บ่ƒฝไฝ“ๅฏๅŠจๅ™จ | `bmad-agent-bmm-dev` | -| `bmad--` | ๅทฅไฝœๆตๅ‘ฝไปค | `bmad-bmm-create-prd` | -| `bmad-` | ๆ ธๅฟƒไปปๅŠกๆˆ–ๅทฅๅ…ท | `bmad-help` | +| ๆจกๅผ | ๅซไน‰ | ็คบไพ‹ | +| ---------------------------- | -------------- | --------------------- | +| `bmad-agent--` | ๆ™บ่ƒฝไฝ“ๅฏๅŠจๅ™จ | `bmad-agent-bmm-dev` | +| `bmad--` | ๅทฅไฝœๆตๅ‘ฝไปค | `bmad-bmm-create-prd` | +| `bmad-` | ๆ ธๅฟƒไปปๅŠกๆˆ–ๅทฅๅ…ท | `bmad-help` | ๆจกๅ—ไปฃ็ ๏ผš`bmm`๏ผˆๆ•ๆทๅฅ—ไปถ๏ผ‰ใ€`bmb`๏ผˆๆž„ๅปบๅ™จ๏ผ‰ใ€`tea`๏ผˆๆต‹่ฏ•ๆžถๆž„ๅธˆ๏ผ‰ใ€`cis`๏ผˆๅˆ›ๆ„ๆ™บ่ƒฝ๏ผ‰ใ€`gds`๏ผˆๆธธๆˆๅผ€ๅ‘ๅทฅไฝœๅฎค๏ผ‰ใ€‚ๅ‚่ง[ๆจกๅ—](./modules.md)่Žทๅ–ๆ่ฟฐใ€‚ @@ -151,6 +151,7 @@ bmad-help ๆˆ‘ๅœจ PRD ๅทฅไฝœๆตไธŠๅกไฝไบ† **ๅทฒๅˆ ้™คๆจกๅ—็š„ๅ‘ฝไปคไป็„ถๅ‡บ็Žฐใ€‚** ๅฎ‰่ฃ…็จ‹ๅบไธไผš่‡ชๅŠจๅˆ ้™คๆ—ง็š„ๅ‘ฝไปคๆ–‡ไปถใ€‚ไปŽ IDE ็š„ๅ‘ฝไปค็›ฎๅฝ•ไธญๅˆ ้™ค่ฟ‡ๆ—ถ็š„ๆ–‡ไปถ๏ผŒๆˆ–ๅˆ ้™คๆ•ดไธชๅ‘ฝไปค็›ฎๅฝ•ๅนถ้‡ๆ–ฐ่ฟ่กŒๅฎ‰่ฃ…็จ‹ๅบไปฅ่Žทๅ–ไธ€็ป„ๅนฒๅ‡€็š„ๅ‘ฝไปคใ€‚ --- + ## ๆœฏ่ฏญ่ฏดๆ˜Ž - **slash command**๏ผšๆ–œๆ ๅ‘ฝไปคใ€‚ไปฅ `/` ๅผ€ๅคด็š„ๅ‘ฝไปค๏ผŒ็”จไบŽๅœจ IDE ไธญๅฟซ้€Ÿๆ‰ง่กŒ็‰นๅฎšๆ“ไฝœใ€‚ diff --git a/docs/zh-cn/tutorials/getting-started.md b/docs/zh-cn/tutorials/getting-started.md index 3bffb4407..451169f83 100644 --- a/docs/zh-cn/tutorials/getting-started.md +++ b/docs/zh-cn/tutorials/getting-started.md @@ -1,5 +1,5 @@ --- -title: "ๅฟซ้€Ÿๅ…ฅ้—จ" +title: 'ๅฟซ้€Ÿๅ…ฅ้—จ' description: ๅฎ‰่ฃ… BMad ๅนถๆž„ๅปบไฝ ็š„็ฌฌไธ€ไธช้กน็›ฎ --- @@ -14,11 +14,12 @@ description: ๅฎ‰่ฃ… BMad ๅนถๆž„ๅปบไฝ ็š„็ฌฌไธ€ไธช้กน็›ฎ - ๆœ‰ๆ•ˆไฝฟ็”จๆ™บ่ƒฝไฝ“ๅ’Œๅทฅไฝœๆต :::note[ๅ‰็ฝฎๆกไปถ] + - **Node.js 20+** โ€” ๅฎ‰่ฃ…็จ‹ๅบๅฟ…้œ€ - **Git** โ€” ๆŽจ่็”จไบŽ็‰ˆๆœฌๆŽงๅˆถ - **AI ้ฉฑๅŠจ็š„ IDE** โ€” Claude Codeใ€Cursor ๆˆ–็ฑปไผผๅทฅๅ…ท - **ไธ€ไธช้กน็›ฎๆƒณๆณ•** โ€” ๅณไฝฟๆ˜ฏ็ฎ€ๅ•็š„ๆƒณๆณ•ไนŸๅฏไปฅ็”จไบŽๅญฆไน  -::: + ::: :::tip[ๆœ€็ฎ€ๅ•็š„่ทฏๅพ„] **ๅฎ‰่ฃ…** โ†’ `npx bmad-method install` @@ -50,6 +51,7 @@ bmad-help ๆˆ‘ๆœ‰ไธ€ไธช SaaS ไบงๅ“็š„ๆƒณๆณ•๏ผŒๆˆ‘ๅทฒ็ป็Ÿฅ้“ๆˆ‘ๆƒณ่ฆ็š„ๆ‰€ๆœ‰ ``` BMad-Help ๅฐ†ๅ›žๅบ”๏ผš + - ้’ˆๅฏนไฝ ็š„ๆƒ…ๅ†ตๆŽจ่ไป€ไนˆ - ็ฌฌไธ€ไธชๅฟ…้œ€ไปปๅŠกๆ˜ฏไป€ไนˆ - ๅ…ถไฝ™ๆต็จ‹ๆ˜ฏไป€ไนˆๆ ท็š„ @@ -66,22 +68,22 @@ BMad-Help ไธไป…ๅ›ž็ญ”้—ฎ้ข˜ โ€”โ€” **ๅฎƒไผšๅœจๆฏไธชๅทฅไฝœๆต็ป“ๆŸๆ—ถ่‡ชๅŠจ่ฟ BMad ้€š่ฟ‡ๅธฆๆœ‰ไธ“้—จ AI ๆ™บ่ƒฝไฝ“็š„ๅผ•ๅฏผๅทฅไฝœๆตๅธฎๅŠฉไฝ ๆž„ๅปบ่ฝฏไปถใ€‚่ฏฅ่ฟ‡็จ‹้ตๅพชๅ››ไธช้˜ถๆฎต๏ผš -| ้˜ถๆฎต | ๅ็งฐ | ๅ‘็”Ÿไป€ไนˆ | -| ---- | -------------- | -------------------------------------------------- | -| 1 | ๅˆ†ๆž | ๅคด่„‘้ฃŽๆšดใ€็ ”็ฉถใ€ไบงๅ“็ฎ€ๆŠฅ *๏ผˆๅฏ้€‰๏ผ‰* | -| 2 | ่ง„ๅˆ’ | ๅˆ›ๅปบ้œ€ๆฑ‚๏ผˆPRD ๆˆ–ๆŠ€ๆœฏ่ง„่Œƒ๏ผ‰ | -| 3 | ่งฃๅ†ณๆ–นๆกˆ่ฎพ่ฎก | ่ฎพ่ฎกๆžถๆž„ *๏ผˆไป…้™ BMad Method/Enterprise only๏ผ‰* | -| 4 | ๅฎž็Žฐ | ้€ไธชๅฒ่ฏ—ใ€้€ไธชๆ•…ไบ‹ๅœฐๆž„ๅปบ | +| ้˜ถๆฎต | ๅ็งฐ | ๅ‘็”Ÿไป€ไนˆ | +| ---- | ------------ | ----------------------------------------------- | +| 1 | ๅˆ†ๆž | ๅคด่„‘้ฃŽๆšดใ€็ ”็ฉถใ€ไบงๅ“็ฎ€ๆŠฅ _๏ผˆๅฏ้€‰๏ผ‰_ | +| 2 | ่ง„ๅˆ’ | ๅˆ›ๅปบ้œ€ๆฑ‚๏ผˆPRD ๆˆ–ๆŠ€ๆœฏ่ง„่Œƒ๏ผ‰ | +| 3 | ่งฃๅ†ณๆ–นๆกˆ่ฎพ่ฎก | ่ฎพ่ฎกๆžถๆž„ _๏ผˆไป…้™ BMad Method/Enterprise only๏ผ‰_ | +| 4 | ๅฎž็Žฐ | ้€ไธชๅฒ่ฏ—ใ€้€ไธชๆ•…ไบ‹ๅœฐๆž„ๅปบ | **[ๆ‰“ๅผ€ๅทฅไฝœๆตๅœฐๅ›พ](../reference/workflow-map.md)** ไปฅๆŽข็ดข้˜ถๆฎตใ€ๅทฅไฝœๆตๅ’ŒไธŠไธ‹ๆ–‡็ฎก็†ใ€‚ ๆ นๆฎ้กน็›ฎ็š„ๅคๆ‚ๆ€ง๏ผŒBMad ๆไพ›ไธ‰็ง่ง„ๅˆ’่ทฏๅพ„๏ผš -| ่ทฏๅพ„ | ๆœ€้€‚ๅˆ | ๅˆ›ๅปบ็š„ๆ–‡ๆกฃ | -| --------------- | ---------------------------------------------------- | --------------------------------------- | -| **Quick Flow** | ้”™่ฏฏไฟฎๅคใ€็ฎ€ๅ•ๅŠŸ่ƒฝใ€่Œƒๅ›ดๆธ…ๆ™ฐ๏ผˆ1-15 ไธชๆ•…ไบ‹๏ผ‰ | ไป…ๆŠ€ๆœฏ่ง„่Œƒ | -| **BMad Method** | ไบงๅ“ใ€ๅนณๅฐใ€ๅคๆ‚ๅŠŸ่ƒฝ๏ผˆ10-50+ ไธชๆ•…ไบ‹๏ผ‰ | PRD + ๆžถๆž„ + UX | -| **Enterprise** | ๅˆ่ง„ใ€ๅคš็งŸๆˆท็ณป็ปŸ๏ผˆ30+ ไธชๆ•…ไบ‹๏ผ‰ | PRD + ๆžถๆž„ + ๅฎ‰ๅ…จ + DevOps | +| ่ทฏๅพ„ | ๆœ€้€‚ๅˆ | ๅˆ›ๅปบ็š„ๆ–‡ๆกฃ | +| --------------- | ------------------------------------------- | -------------------------- | +| **Quick Flow** | ้”™่ฏฏไฟฎๅคใ€็ฎ€ๅ•ๅŠŸ่ƒฝใ€่Œƒๅ›ดๆธ…ๆ™ฐ๏ผˆ1-15 ไธชๆ•…ไบ‹๏ผ‰ | ไป…ๆŠ€ๆœฏ่ง„่Œƒ | +| **BMad Method** | ไบงๅ“ใ€ๅนณๅฐใ€ๅคๆ‚ๅŠŸ่ƒฝ๏ผˆ10-50+ ไธชๆ•…ไบ‹๏ผ‰ | PRD + ๆžถๆž„ + UX | +| **Enterprise** | ๅˆ่ง„ใ€ๅคš็งŸๆˆท็ณป็ปŸ๏ผˆ30+ ไธชๆ•…ไบ‹๏ผ‰ | PRD + ๆžถๆž„ + ๅฎ‰ๅ…จ + DevOps | :::note ๆ•…ไบ‹ๆ•ฐ้‡ๆ˜ฏๆŒ‡ๅฏผ๏ผŒ่€Œ้žๅฎšไน‰ใ€‚ๆ นๆฎ่ง„ๅˆ’้œ€ๆฑ‚้€‰ๆ‹ฉไฝ ็š„่ทฏๅพ„๏ผŒ่€Œไธๆ˜ฏๆ•…ไบ‹ๆ•ฐๅญฆใ€‚ @@ -98,6 +100,7 @@ npx bmad-method install ๅฝ“ๆ็คบ้€‰ๆ‹ฉๆจกๅ—ๆ—ถ๏ผŒ้€‰ๆ‹ฉ **BMad Method**ใ€‚ ๅฎ‰่ฃ…็จ‹ๅบไผšๅˆ›ๅปบไธคไธชๆ–‡ไปถๅคน๏ผš + - `_bmad/` โ€” ๆ™บ่ƒฝไฝ“ใ€ๅทฅไฝœๆตใ€ไปปๅŠกๅ’Œ้…็ฝฎ - `_bmad-output/` โ€” ็›ฎๅ‰ไธบ็ฉบ๏ผŒไฝ†่ฟ™ๆ˜ฏไฝ ็š„ๅทฅไปถๅฐ†่ขซไฟๅญ˜็š„ๅœฐๆ–น @@ -132,6 +135,7 @@ BMad-Help ๅฐ†ๆฃ€ๆต‹ไฝ ๅทฒๅฎŒๆˆ็š„ๅ†…ๅฎน๏ผŒๅนถๅ‡†็กฎๆŽจ่ไธ‹ไธ€ๆญฅ่ฏฅๅšไป€ไนˆ ### ้˜ถๆฎต 1๏ผšๅˆ†ๆž๏ผˆๅฏ้€‰๏ผ‰ ๆญค้˜ถๆฎตไธญ็š„ๆ‰€ๆœ‰ๅทฅไฝœๆต้ƒฝๆ˜ฏๅฏ้€‰็š„๏ผš + - **ๅคด่„‘้ฃŽๆšด**๏ผˆ`bmad-brainstorming`๏ผ‰ โ€” ๅผ•ๅฏผๅผๆž„ๆ€ - **็ ”็ฉถ**๏ผˆ`bmad-bmm-research`๏ผ‰ โ€” ๅธ‚ๅœบๅ’ŒๆŠ€ๆœฏ็ ”็ฉถ - **ๅˆ›ๅปบไบงๅ“็ฎ€ๆŠฅ**๏ผˆ`bmad-bmm-create-product-brief`๏ผ‰ โ€” ๆŽจ่็š„ๅŸบ็ก€ๆ–‡ๆกฃ @@ -139,11 +143,13 @@ BMad-Help ๅฐ†ๆฃ€ๆต‹ไฝ ๅทฒๅฎŒๆˆ็š„ๅ†…ๅฎน๏ผŒๅนถๅ‡†็กฎๆŽจ่ไธ‹ไธ€ๆญฅ่ฏฅๅšไป€ไนˆ ### ้˜ถๆฎต 2๏ผš่ง„ๅˆ’๏ผˆๅฟ…้œ€๏ผ‰ **ๅฏนไบŽ BMad Method ๅ’Œ Enterprise ่ทฏๅพ„๏ผš** + 1. ๅœจๆ–ฐๅฏน่ฏไธญๅŠ ่ฝฝ **PM ๆ™บ่ƒฝไฝ“**๏ผˆ`bmad-agent-bmm-pm`๏ผ‰ 2. ่ฟ่กŒ `prd` ๅทฅไฝœๆต๏ผˆ`bmad-bmm-create-prd`๏ผ‰ 3. ่พ“ๅ‡บ๏ผš`PRD.md` **ๅฏนไบŽ Quick Flow ่ทฏๅพ„๏ผš** + - ไฝฟ็”จ `quick-spec` ๅทฅไฝœๆต๏ผˆ`bmad-bmm-quick-spec`๏ผ‰ไปฃๆ›ฟ PRD๏ผŒ็„ถๅŽ่ทณ่ฝฌๅˆฐๅฎž็Žฐ :::note[UX ่ฎพ่ฎก๏ผˆๅฏ้€‰๏ผ‰] @@ -153,6 +159,7 @@ BMad-Help ๅฐ†ๆฃ€ๆต‹ไฝ ๅทฒๅฎŒๆˆ็š„ๅ†…ๅฎน๏ผŒๅนถๅ‡†็กฎๆŽจ่ไธ‹ไธ€ๆญฅ่ฏฅๅšไป€ไนˆ ### ้˜ถๆฎต 3๏ผš่งฃๅ†ณๆ–นๆกˆ่ฎพ่ฎก๏ผˆBMad Method/Enterprise๏ผ‰ **ๅˆ›ๅปบๆžถๆž„** + 1. ๅœจๆ–ฐๅฏน่ฏไธญๅŠ ่ฝฝ **Architect ๆ™บ่ƒฝไฝ“**๏ผˆ`bmad-agent-bmm-architect`๏ผ‰ 2. ่ฟ่กŒ `create-architecture`๏ผˆ`bmad-bmm-create-architecture`๏ผ‰ 3. ่พ“ๅ‡บ๏ผšๅŒ…ๅซๆŠ€ๆœฏๅ†ณ็ญ–็š„ๆžถๆž„ๆ–‡ๆกฃ @@ -167,7 +174,8 @@ BMad-Help ๅฐ†ๆฃ€ๆต‹ไฝ ๅทฒๅฎŒๆˆ็š„ๅ†…ๅฎน๏ผŒๅนถๅ‡†็กฎๆŽจ่ไธ‹ไธ€ๆญฅ่ฏฅๅšไป€ไนˆ 2. ่ฟ่กŒ `create-epics-and-stories`๏ผˆ`bmad-bmm-create-epics-and-stories`๏ผ‰ 3. ๅทฅไฝœๆตไฝฟ็”จ PRD ๅ’Œๆžถๆž„ๆฅๅˆ›ๅปบๆŠ€ๆœฏไฟกๆฏไธฐๅฏŒ็š„ๆ•…ไบ‹ -**ๅฎž็Žฐๅฐฑ็ปชๆฃ€ๆŸฅ** *๏ผˆๅผบ็ƒˆๆŽจ่๏ผ‰* +**ๅฎž็Žฐๅฐฑ็ปชๆฃ€ๆŸฅ** _๏ผˆๅผบ็ƒˆๆŽจ่๏ผ‰_ + 1. ๅœจๆ–ฐๅฏน่ฏไธญๅŠ ่ฝฝ **Architect ๆ™บ่ƒฝไฝ“**๏ผˆ`bmad-agent-bmm-architect`๏ผ‰ 2. ่ฟ่กŒ `check-implementation-readiness`๏ผˆ`bmad-bmm-check-implementation-readiness`๏ผ‰ 3. ้ชŒ่ฏๆ‰€ๆœ‰่ง„ๅˆ’ๆ–‡ๆกฃไน‹้—ด็š„ไธ€่‡ดๆ€ง @@ -178,19 +186,19 @@ BMad-Help ๅฐ†ๆฃ€ๆต‹ไฝ ๅทฒๅฎŒๆˆ็š„ๅ†…ๅฎน๏ผŒๅนถๅ‡†็กฎๆŽจ่ไธ‹ไธ€ๆญฅ่ฏฅๅšไป€ไนˆ ### ๅˆๅง‹ๅŒ–ๅ†ฒๅˆบ่ง„ๅˆ’ -ๅŠ ่ฝฝ **SM ๆ™บ่ƒฝไฝ“**๏ผˆ`bmad-agent-bmm-sm`๏ผ‰ๅนถ่ฟ่กŒ `sprint-planning`๏ผˆ`bmad-bmm-sprint-planning`๏ผ‰ใ€‚่ฟ™ๅฐ†ๅˆ›ๅปบ `sprint-status.yaml` ๆฅ่ทŸ่ธชๆ‰€ๆœ‰ๅฒ่ฏ—ๅ’Œๆ•…ไบ‹ใ€‚ +ๅŠ ่ฝฝ **ADL ๆ™บ่ƒฝไฝ“**๏ผˆ`bmad-agent-bmm-adl`๏ผ‰ๅนถ่ฟ่กŒ `sprint-planning`๏ผˆ`bmad-bmm-sprint-planning`๏ผ‰ใ€‚่ฟ™ๅฐ†ๅˆ›ๅปบ `sprint-status.yaml` ๆฅ่ทŸ่ธชๆ‰€ๆœ‰ๅฒ่ฏ—ๅ’Œๆ•…ไบ‹ใ€‚ ### ๆž„ๅปบๅ‘จๆœŸ ๅฏนไบŽๆฏไธชๆ•…ไบ‹๏ผŒไฝฟ็”จๆ–ฐๅฏน่ฏ้‡ๅคๆญคๅ‘จๆœŸ๏ผš -| ๆญฅ้ชค | ๆ™บ่ƒฝไฝ“ | ๅทฅไฝœๆต | ๅ‘ฝไปค | ็›ฎ็š„ | -| ---- | ------ | ------------ | ----------------------- | ------------------------------- | -| 1 | SM | `create-story` | `bmad-bmm-create-story` | ไปŽๅฒ่ฏ—ๅˆ›ๅปบๆ•…ไบ‹ๆ–‡ไปถ | -| 2 | DEV | `dev-story` | `bmad-bmm-dev-story` | ๅฎž็Žฐๆ•…ไบ‹ | -| 3 | DEV | `code-review` | `bmad-bmm-code-review` | ่ดจ้‡้ชŒ่ฏ *๏ผˆๆŽจ่๏ผ‰* | +| ๆญฅ้ชค | ๆ™บ่ƒฝไฝ“ | ๅทฅไฝœๆต | ๅ‘ฝไปค | ็›ฎ็š„ | +| ---- | ------ | -------------- | ----------------------- | ------------------- | +| 1 | ADL | `create-story` | `bmad-bmm-create-story` | ไปŽๅฒ่ฏ—ๅˆ›ๅปบๆ•…ไบ‹ๆ–‡ไปถ | +| 2 | DEV | `dev-story` | `bmad-bmm-dev-story` | ๅฎž็Žฐๆ•…ไบ‹ | +| 3 | DEV | `code-review` | `bmad-bmm-code-review` | ่ดจ้‡้ชŒ่ฏ _๏ผˆๆŽจ่๏ผ‰_ | -ๅฎŒๆˆๅฒ่ฏ—ไธญ็š„ๆ‰€ๆœ‰ๆ•…ไบ‹ๅŽ๏ผŒๅŠ ่ฝฝ **SM ๆ™บ่ƒฝไฝ“**๏ผˆ`bmad-agent-bmm-sm`๏ผ‰ๅนถ่ฟ่กŒ `retrospective`๏ผˆ`bmad-bmm-retrospective`๏ผ‰ใ€‚ +ๅฎŒๆˆๅฒ่ฏ—ไธญ็š„ๆ‰€ๆœ‰ๆ•…ไบ‹ๅŽ๏ผŒๅŠ ่ฝฝ **ADL ๆ™บ่ƒฝไฝ“**๏ผˆ`bmad-agent-bmm-adl`๏ผ‰ๅนถ่ฟ่กŒ `retrospective`๏ผˆ`bmad-bmm-retrospective`๏ผ‰ใ€‚ ## ไฝ ๅทฒๅฎŒๆˆ็š„ๅทฅไฝœ @@ -219,18 +227,18 @@ your-project/ ## ๅฟซ้€Ÿๅ‚่€ƒ -| ๅทฅไฝœๆต | ๅ‘ฝไปค | ๆ™บ่ƒฝไฝ“ | ็›ฎ็š„ | -| ----------------------------------- | --------------------------------------- | -------- | -------------------------------------------- | -| **`help`** โญ | `bmad-help` | ไปปๆ„ | **ไฝ ็š„ๆ™บ่ƒฝๅ‘ๅฏผ โ€”โ€” ้šๆ—ถ่ฏข้—ฎไปปไฝ•้—ฎ้ข˜๏ผ** | -| `prd` | `bmad-bmm-create-prd` | PM | ๅˆ›ๅปบไบงๅ“้œ€ๆฑ‚ๆ–‡ๆกฃ | -| `create-architecture` | `bmad-bmm-create-architecture` | Architect | ๅˆ›ๅปบๆžถๆž„ๆ–‡ๆกฃ | -| `generate-project-context` | `bmad-bmm-generate-project-context` | Analyst | ๅˆ›ๅปบ้กน็›ฎไธŠไธ‹ๆ–‡ๆ–‡ไปถ | -| `create-epics-and-stories` | `bmad-bmm-create-epics-and-stories` | PM | ๅฐ† PRD ๅˆ†่งฃไธบๅฒ่ฏ— | -| `check-implementation-readiness` | `bmad-bmm-check-implementation-readiness` | Architect | ้ชŒ่ฏ่ง„ๅˆ’ไธ€่‡ดๆ€ง | -| `sprint-planning` | `bmad-bmm-sprint-planning` | SM | ๅˆๅง‹ๅŒ–ๅ†ฒๅˆบ่ทŸ่ธช | -| `create-story` | `bmad-bmm-create-story` | SM | ๅˆ›ๅปบๆ•…ไบ‹ๆ–‡ไปถ | -| `dev-story` | `bmad-bmm-dev-story` | DEV | ๅฎž็Žฐๆ•…ไบ‹ | -| `code-review` | `bmad-bmm-code-review` | DEV | ๅฎกๆŸฅๅทฒๅฎž็Žฐ็š„ไปฃ็  | +| ๅทฅไฝœๆต | ๅ‘ฝไปค | ๆ™บ่ƒฝไฝ“ | ็›ฎ็š„ | +| -------------------------------- | ----------------------------------------- | --------- | -------------------------------------- | +| **`help`** โญ | `bmad-help` | ไปปๆ„ | **ไฝ ็š„ๆ™บ่ƒฝๅ‘ๅฏผ โ€”โ€” ้šๆ—ถ่ฏข้—ฎไปปไฝ•้—ฎ้ข˜๏ผ** | +| `prd` | `bmad-bmm-create-prd` | PM | ๅˆ›ๅปบไบงๅ“้œ€ๆฑ‚ๆ–‡ๆกฃ | +| `create-architecture` | `bmad-bmm-create-architecture` | Architect | ๅˆ›ๅปบๆžถๆž„ๆ–‡ๆกฃ | +| `generate-project-context` | `bmad-bmm-generate-project-context` | Analyst | ๅˆ›ๅปบ้กน็›ฎไธŠไธ‹ๆ–‡ๆ–‡ไปถ | +| `create-epics-and-stories` | `bmad-bmm-create-epics-and-stories` | PM | ๅฐ† PRD ๅˆ†่งฃไธบๅฒ่ฏ— | +| `check-implementation-readiness` | `bmad-bmm-check-implementation-readiness` | Architect | ้ชŒ่ฏ่ง„ๅˆ’ไธ€่‡ดๆ€ง | +| `sprint-planning` | `bmad-bmm-sprint-planning` | SM | ๅˆๅง‹ๅŒ–ๅ†ฒๅˆบ่ทŸ่ธช | +| `create-story` | `bmad-bmm-create-story` | SM | ๅˆ›ๅปบๆ•…ไบ‹ๆ–‡ไปถ | +| `dev-story` | `bmad-bmm-dev-story` | DEV | ๅฎž็Žฐๆ•…ไบ‹ | +| `code-review` | `bmad-bmm-code-review` | DEV | ๅฎกๆŸฅๅทฒๅฎž็Žฐ็š„ไปฃ็  | ## ๅธธ่ง้—ฎ้ข˜ @@ -250,6 +258,7 @@ your-project/ :::tip[็ฌฌไธ€็ซ™๏ผšBMad-Help] **้šๆ—ถ่ฟ่กŒ `bmad-help`** โ€”โ€” ่ฟ™ๆ˜ฏๆ‘†่„ฑๅ›ฐๅขƒ็š„ๆœ€ๅฟซๆ–นๅผใ€‚้—ฎๅฎƒไปปไฝ•้—ฎ้ข˜๏ผš + - "ๅฎ‰่ฃ…ๅŽๆˆ‘ๅบ”่ฏฅๅšไป€ไนˆ๏ผŸ" - "ๆˆ‘ๅœจๅทฅไฝœๆต X ไธŠๅกไฝไบ†" - "ๆˆ‘ๅœจ Y ๆ–น้ขๆœ‰ไป€ไนˆ้€‰้กน๏ผŸ" @@ -264,15 +273,17 @@ BMad-Help ๆฃ€ๆŸฅไฝ ็š„้กน็›ฎ๏ผŒๆฃ€ๆต‹ไฝ ๅทฒๅฎŒๆˆ็š„ๅ†…ๅฎน๏ผŒๅนถ็กฎๅˆ‡ๅœฐๅ‘Š่ฏ‰ ## ๅ…ณ้”ฎ่ฆ็‚น :::tip[่ฎฐไฝ่ฟ™ไบ›] + - **ไปŽ `bmad-help` ๅผ€ๅง‹** โ€” ไฝ ็š„ๆ™บ่ƒฝๅ‘ๅฏผ๏ผŒไบ†่งฃไฝ ็š„้กน็›ฎๅ’Œ้€‰้กน - **ๅง‹็ปˆไฝฟ็”จๆ–ฐๅฏน่ฏ** โ€” ไธบๆฏไธชๅทฅไฝœๆตๅผ€ๅง‹ๆ–ฐๅฏน่ฏ - **่ทฏๅพ„ๅพˆ้‡่ฆ** โ€” Quick Flow ไฝฟ็”จ quick-spec๏ผ›Method/Enterprise ้œ€่ฆ PRD ๅ’Œๆžถๆž„ - **BMad-Help ่‡ชๅŠจ่ฟ่กŒ** โ€” ๆฏไธชๅทฅไฝœๆต็ป“ๆŸๆ—ถ้ƒฝไผšๆไพ›ไธ‹ไธ€ๆญฅ็š„ๆŒ‡ๅฏผ -::: + ::: ๅ‡†ๅค‡ๅฅฝๅผ€ๅง‹ไบ†ๅ—๏ผŸๅฎ‰่ฃ… BMad๏ผŒ่ฟ่กŒ `bmad-help`๏ผŒ่ฎฉไฝ ็š„ๆ™บ่ƒฝๅ‘ๅฏผไธบไฝ ๅผ•่ทฏใ€‚ --- + ## ๆœฏ่ฏญ่ฏดๆ˜Ž - **agent**๏ผšๆ™บ่ƒฝไฝ“ใ€‚ๅœจไบบๅทฅๆ™บ่ƒฝไธŽ็ผ–็จ‹ๆ–‡ๆกฃไธญ๏ผŒๆŒ‡ๅ…ทๅค‡่‡ชไธปๅ†ณ็ญ–ๆˆ–ๆ‰ง่กŒ่ƒฝๅŠ›็š„ๅ•ๅ…ƒใ€‚ diff --git a/src/bmm/agents/sm.agent.yaml b/src/bmm/agents/adl.agent.yaml similarity index 83% rename from src/bmm/agents/sm.agent.yaml rename to src/bmm/agents/adl.agent.yaml index ef71f7681..bfb7edb97 100644 --- a/src/bmm/agents/sm.agent.yaml +++ b/src/bmm/agents/adl.agent.yaml @@ -1,18 +1,18 @@ -# Scrum Master Agent Definition +# Agile Delivery Lead Agent Definition agent: metadata: - id: "_bmad/bmm/agents/sm.md" + id: "_bmad/bmm/agents/adl.md" name: Bob - title: Scrum Master + title: Agile Delivery Lead icon: ๐Ÿƒ module: bmm capabilities: "sprint planning, story preparation, agile ceremonies, backlog management" hasSidecar: false persona: - role: Technical Scrum Master + Story Preparation Specialist - identity: Certified Scrum Master with deep technical background. Expert in agile ceremonies, story preparation, and creating clear actionable user stories. + role: Technical Agile Delivery Lead + Story Preparation Specialist + identity: Certified Agile Delivery Lead with deep technical background. Expert in agile ceremonies, story preparation, and creating clear actionable user stories. communication_style: "Crisp and checklist-driven. Every word has a purpose, every requirement crystal clear. Zero tolerance for ambiguity." principles: | - I strive to be a servant leader and conduct myself accordingly, helping with any task and offering suggestions diff --git a/src/bmm/agents/bmad-skill-manifest.yaml b/src/bmm/agents/bmad-skill-manifest.yaml index 2f3930de8..a9895af9a 100644 --- a/src/bmm/agents/bmad-skill-manifest.yaml +++ b/src/bmm/agents/bmad-skill-manifest.yaml @@ -28,10 +28,10 @@ quick-flow-solo-dev.agent.yaml: type: agent description: "Quick Flow Solo Dev for rapid spec creation and lean implementation" -sm.agent.yaml: - canonicalId: bmad-sm +adl.agent.yaml: + canonicalId: bmad-adl type: agent - description: "Scrum Master for sprint planning, story preparation, and agile ceremonies" + description: "Agile Delivery Lead for sprint planning, story preparation, and agile ceremonies" ux-designer.agent.yaml: canonicalId: bmad-ux-designer diff --git a/src/bmm/module-help.csv b/src/bmm/module-help.csv index 0afef236c..f3ed0126c 100644 --- a/src/bmm/module-help.csv +++ b/src/bmm/module-help.csv @@ -4,7 +4,7 @@ bmm,anytime,Generate Project Context,GPC,,_bmad/bmm/workflows/generate-project-c bmm,anytime,Quick Spec,QS,,_bmad/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md,bmad-bmm-quick-spec,false,quick-flow-solo-dev,Create Mode,"Do not suggest for potentially very complex things unless requested or if the user complains that they do not want to follow the extensive planning of the bmad method. Quick one-off tasks small changes simple apps brownfield additions to well established patterns utilities without extensive planning",planning_artifacts,"tech spec", bmm,anytime,Quick Dev,QD,,skill:bmad-quick-dev,bmad-bmm-quick-dev,false,quick-flow-solo-dev,Create Mode,"Quick one-off tasks small changes simple apps utilities without extensive planning - Do not suggest for potentially very complex things unless requested or if the user complains that they do not want to follow the extensive planning of the bmad method, unless the user is already working through the implementation phase and just requests a 1 off things not already in the plan",,, bmm,anytime,Quick Dev New Preview,QQ,,skill:bmad-quick-dev-new-preview,bmad-bmm-quick-dev-new-preview,false,quick-flow-solo-dev,Create Mode,"Unified quick flow (experimental): clarify intent plan implement review and present in a single workflow",implementation_artifacts,"tech spec implementation", -bmm,anytime,Correct Course,CC,,_bmad/bmm/workflows/4-implementation/correct-course/workflow.md,bmad-bmm-correct-course,false,sm,Create Mode,"Anytime: Navigate significant changes. May recommend start over update PRD redo architecture sprint planning or correct epics and stories",planning_artifacts,"change proposal", +bmm,anytime,Correct Course,CC,,_bmad/bmm/workflows/4-implementation/correct-course/workflow.md,bmad-bmm-correct-course,false,adl,Create Mode,"Anytime: Navigate significant changes. May recommend start over update PRD redo architecture sprint planning or correct epics and stories",planning_artifacts,"change proposal", bmm,anytime,Write Document,WD,,_bmad/bmm/agents/tech-writer/tech-writer.agent.yaml,,false,tech-writer,,"Describe in detail what you want, and the agent will follow the documentation best practices defined in agent memory. Multi-turn conversation with subprocess for research/review.",project-knowledge,"document", bmm,anytime,Update Standards,US,,_bmad/bmm/agents/tech-writer/tech-writer.agent.yaml,,false,tech-writer,,"Update agent memory documentation-standards.md with your specific preferences if you discover missing document conventions.",_bmad/_memory/tech-writer-sidecar,"standards", bmm,anytime,Mermaid Generate,MG,,_bmad/bmm/agents/tech-writer/tech-writer.agent.yaml,,false,tech-writer,,"Create a Mermaid diagram based on user description. Will suggest diagram types if not specified.",planning_artifacts,"mermaid diagram", @@ -22,11 +22,11 @@ bmm,2-planning,Create UX,CU,30,_bmad/bmm/workflows/2-plan-workflows/create-ux-de bmm,3-solutioning,Create Architecture,CA,10,_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md,bmad-bmm-create-architecture,true,architect,Create Mode,"Guided Workflow to document technical decisions",planning_artifacts,architecture, bmm,3-solutioning,Create Epics and Stories,CE,30,_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md,bmad-bmm-create-epics-and-stories,true,pm,Create Mode,"Create the Epics and Stories Listing",planning_artifacts,"epics and stories", bmm,3-solutioning,Check Implementation Readiness,IR,70,_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md,bmad-bmm-check-implementation-readiness,true,architect,Validate Mode,"Ensure PRD UX Architecture and Epics Stories are aligned",planning_artifacts,"readiness report", -bmm,4-implementation,Sprint Planning,SP,10,_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.md,bmad-bmm-sprint-planning,true,sm,Create Mode,"Generate sprint plan for development tasks - this kicks off the implementation phase by producing a plan the implementation agents will follow in sequence for every story in the plan.",implementation_artifacts,"sprint status", -bmm,4-implementation,Sprint Status,SS,20,_bmad/bmm/workflows/4-implementation/sprint-status/workflow.md,bmad-bmm-sprint-status,false,sm,Create Mode,"Anytime: Summarize sprint status and route to next workflow",,, -bmm,4-implementation,Validate Story,VS,35,skill:bmad-create-story,bmad-bmm-create-story,false,sm,Validate Mode,"Validates story readiness and completeness before development work begins",implementation_artifacts,"story validation report", -bmm,4-implementation,Create Story,CS,30,skill:bmad-create-story,bmad-bmm-create-story,true,sm,Create Mode,"Story cycle start: Prepare first found story in the sprint plan that is next, or if the command is run with a specific epic and story designation with context. Once complete, then VS then DS then CR then back to DS if needed or next CS or ER",implementation_artifacts,story, +bmm,4-implementation,Sprint Planning,SP,10,_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.md,bmad-bmm-sprint-planning,true,adl,Create Mode,"Generate sprint plan for development tasks - this kicks off the implementation phase by producing a plan the implementation agents will follow in sequence for every story in the plan.",implementation_artifacts,"sprint status", +bmm,4-implementation,Sprint Status,SS,20,_bmad/bmm/workflows/4-implementation/sprint-status/workflow.md,bmad-bmm-sprint-status,false,adl,Create Mode,"Anytime: Summarize sprint status and route to next workflow",,, +bmm,4-implementation,Validate Story,VS,35,skill:bmad-create-story,bmad-bmm-create-story,false,adl,Validate Mode,"Validates story readiness and completeness before development work begins",implementation_artifacts,"story validation report", +bmm,4-implementation,Create Story,CS,30,skill:bmad-create-story,bmad-bmm-create-story,true,adl,Create Mode,"Story cycle start: Prepare first found story in the sprint plan that is next, or if the command is run with a specific epic and story designation with context. Once complete, then VS then DS then CR then back to DS if needed or next CS or ER",implementation_artifacts,story, bmm,4-implementation,Dev Story,DS,40,skill:bmad-dev-story,bmad-bmm-dev-story,true,dev,Create Mode,"Story cycle: Execute story implementation tasks and tests then CR then back to DS if fixes needed",,, bmm,4-implementation,Code Review,CR,50,_bmad/bmm/workflows/4-implementation/code-review/workflow.md,bmad-bmm-code-review,false,dev,Create Mode,"Story cycle: If issues back to DS if approved then next CS or ER if epic complete",,, bmm,4-implementation,QA Automation Test,QA,45,_bmad/bmm/workflows/qa-generate-e2e-tests/workflow.md,bmad-bmm-qa-automate,false,qa,Create Mode,"Generate automated API and E2E tests for implemented code using the project's existing test framework (detects existing well known in use test frameworks). Use after implementation to add test coverage. NOT for code review or story validation - use CR for that.",implementation_artifacts,"test suite", -bmm,4-implementation,Retrospective,ER,60,_bmad/bmm/workflows/4-implementation/retrospective/workflow.md,bmad-bmm-retrospective,false,sm,Create Mode,"Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC",implementation_artifacts,retrospective, +bmm,4-implementation,Retrospective,ER,60,_bmad/bmm/workflows/4-implementation/retrospective/workflow.md,bmad-bmm-retrospective,false,adl,Create Mode,"Optional at epic end: Review completed work lessons learned and next epic or if major issues consider CC",implementation_artifacts,retrospective, diff --git a/src/bmm/teams/default-party.csv b/src/bmm/teams/default-party.csv index 131710998..6525a81ab 100644 --- a/src/bmm/teams/default-party.csv +++ b/src/bmm/teams/default-party.csv @@ -4,7 +4,7 @@ name,displayName,title,icon,role,identity,communicationStyle,principles,module,p "dev","Amelia","Developer Agent","๐Ÿ’ป","Senior Implementation Engineer","Executes approved stories with strict adherence to acceptance criteria, using Story Context XML and existing code to minimize rework and hallucinations.","Ultra-succinct. Speaks in file paths and AC IDs - every statement citable. No fluff, all precision.","Story Context XML is the single source of truth. Reuse existing interfaces over rebuilding. Every change maps to specific AC. Tests pass 100% or story isn't done.","bmm","bmad/bmm/agents/dev.md" "pm","John","Product Manager","๐Ÿ“‹","Investigative Product Strategist + Market-Savvy PM","Product management veteran with 8+ years launching B2B and consumer products. Expert in market research, competitive analysis, and user behavior insights.","Asks 'WHY?' relentlessly like a detective on a case. Direct and data-sharp, cuts through fluff to what actually matters.","Uncover the deeper WHY behind every requirement. Ruthless prioritization to achieve MVP goals. Proactively identify risks. Align efforts with measurable business impact.","bmm","bmad/bmm/agents/pm.md" "quick-flow-solo-dev","Barry","Quick Flow Solo Dev","๐Ÿš€","Elite Full-Stack Developer + Quick Flow Specialist","Barry is an elite developer who thrives on autonomous execution. He lives and breathes the BMAD Quick Flow workflow, taking projects from concept to deployment with ruthless efficiency. No handoffs, no delays - just pure, focused development. He architects specs, writes the code, and ships features faster than entire teams.","Direct, confident, and implementation-focused. Uses tech slang and gets straight to the point. No fluff, just results. Every response moves the project forward.","Planning and execution are two sides of the same coin. Quick Flow is my religion. Specs are for building, not bureaucracy. Code that ships is better than perfect code that doesn't. Documentation happens alongside development, not after. Ship early, ship often.","bmm","bmad/bmm/agents/quick-flow-solo-dev.md" -"sm","Bob","Scrum Master","๐Ÿƒ","Technical Scrum Master + Story Preparation Specialist","Certified Scrum Master with deep technical background. Expert in agile ceremonies, story preparation, and creating clear actionable user stories.","Crisp and checklist-driven. Every word has a purpose, every requirement crystal clear. Zero tolerance for ambiguity.","Strict boundaries between story prep and implementation. Stories are single source of truth. Perfect alignment between PRD and dev execution. Enable efficient sprints.","bmm","bmad/bmm/agents/sm.md" +"adl","Bob","Agile Delivery Lead","๐Ÿƒ","Technical Agile Delivery Lead + Story Preparation Specialist","Certified Agile Delivery Lead with deep technical background. Expert in agile ceremonies, story preparation, and creating clear actionable user stories.","Crisp and checklist-driven. Every word has a purpose, every requirement crystal clear. Zero tolerance for ambiguity.","Strict boundaries between story prep and implementation. Stories are single source of truth. Perfect alignment between PRD and dev execution. Enable efficient sprints.","bmm","bmad/bmm/agents/adl.md" "tech-writer","Paige","Technical Writer","๐Ÿ“š","Technical Documentation Specialist + Knowledge Curator","Experienced technical writer expert in CommonMark, DITA, OpenAPI. Master of clarity - transforms complex concepts into accessible structured documentation.","Patient educator who explains like teaching a friend. Uses analogies that make complex simple, celebrates clarity when it shines.","Documentation is teaching. Every doc helps someone accomplish a task. Clarity above all. Docs are living artifacts that evolve with code.","bmm","bmad/bmm/agents/tech-writer.md" "ux-designer","Sally","UX Designer","๐ŸŽจ","User Experience Designer + UI Specialist","Senior UX Designer with 7+ years creating intuitive experiences across web and mobile. Expert in user research, interaction design, AI-assisted tools.","Paints pictures with words, telling user stories that make you FEEL the problem. Empathetic advocate with creative storytelling flair.","Every decision serves genuine user needs. Start simple evolve through feedback. Balance empathy with edge case attention. AI tools accelerate human-centered design.","bmm","bmad/bmm/agents/ux-designer.md" "brainstorming-coach","Carson","Elite Brainstorming Specialist","๐Ÿง ","Master Brainstorming Facilitator + Innovation Catalyst","Elite facilitator with 20+ years leading breakthrough sessions. Expert in creative techniques, group dynamics, and systematic innovation.","Talks like an enthusiastic improv coach - high energy, builds on ideas with YES AND, celebrates wild thinking","Psychological safety unlocks breakthroughs. Wild ideas today become innovations tomorrow. Humor and play are serious innovation tools.","cis","bmad/cis/agents/brainstorming-coach.md" diff --git a/src/bmm/teams/team-fullstack.yaml b/src/bmm/teams/team-fullstack.yaml index 94e1ea959..dbfb76734 100644 --- a/src/bmm/teams/team-fullstack.yaml +++ b/src/bmm/teams/team-fullstack.yaml @@ -7,6 +7,6 @@ agents: - analyst - architect - pm - - sm + - adl - ux-designer party: "./default-party.csv" diff --git a/src/bmm/workflows/4-implementation/retrospective/workflow.md b/src/bmm/workflows/4-implementation/retrospective/workflow.md index cbc502d8b..3d01e6dd3 100644 --- a/src/bmm/workflows/4-implementation/retrospective/workflow.md +++ b/src/bmm/workflows/4-implementation/retrospective/workflow.md @@ -8,6 +8,7 @@ description: 'Post-epic review to extract lessons and assess success. Use when t **Goal:** Post-epic review to extract lessons and assess success. **Your Role:** Scrum Master facilitating retrospective. + - No time estimates โ€” NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed. - Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level} - Generate all documents in {document_output_language} @@ -20,7 +21,7 @@ description: 'Post-epic review to extract lessons and assess success. Use when t - Two-part format: (1) Epic Review + (2) Next Epic Preparation - Party mode protocol: - ALL agent dialogue MUST use format: "Name (Role): dialogue" - - Example: Bob (Scrum Master): "Let's begin..." + - Example: Bob (Agile Delivery Lead): "Let's begin..." - Example: {user_name} (Project Lead): [User responds] - Create natural back-and-forth with user actively participating - Show disagreements, diverse perspectives, authentic team dynamics @@ -47,13 +48,13 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve: ### Input Files -| Input | Description | Path Pattern(s) | Load Strategy | -|-------|-------------|------------------|---------------| -| epics | The completed epic for retrospective | whole: `{planning_artifacts}/*epic*.md`, sharded_index: `{planning_artifacts}/*epic*/index.md`, sharded_single: `{planning_artifacts}/*epic*/epic-{{epic_num}}.md` | SELECTIVE_LOAD | -| previous_retrospective | Previous epic's retrospective (optional) | `{implementation_artifacts}/**/epic-{{prev_epic_num}}-retro-*.md` | SELECTIVE_LOAD | -| architecture | System architecture for context | whole: `{planning_artifacts}/*architecture*.md`, sharded: `{planning_artifacts}/*architecture*/*.md` | FULL_LOAD | -| prd | Product requirements for context | whole: `{planning_artifacts}/*prd*.md`, sharded: `{planning_artifacts}/*prd*/*.md` | FULL_LOAD | -| document_project | Brownfield project documentation (optional) | sharded: `{planning_artifacts}/*.md` | INDEX_GUIDED | +| Input | Description | Path Pattern(s) | Load Strategy | +| ---------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------- | +| epics | The completed epic for retrospective | whole: `{planning_artifacts}/*epic*.md`, sharded_index: `{planning_artifacts}/*epic*/index.md`, sharded_single: `{planning_artifacts}/*epic*/epic-{{epic_num}}.md` | SELECTIVE_LOAD | +| previous_retrospective | Previous epic's retrospective (optional) | `{implementation_artifacts}/**/epic-{{prev_epic_num}}-retro-*.md` | SELECTIVE_LOAD | +| architecture | System architecture for context | whole: `{planning_artifacts}/*architecture*.md`, sharded: `{planning_artifacts}/*architecture*/*.md` | FULL_LOAD | +| prd | Product requirements for context | whole: `{planning_artifacts}/*prd*.md`, sharded: `{planning_artifacts}/*prd*/*.md` | FULL_LOAD | +| document_project | Brownfield project documentation (optional) | sharded: `{planning_artifacts}/*.md` | INDEX_GUIDED | ### Required Inputs @@ -75,7 +76,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve: Explain to {user_name} the epic discovery process using natural dialogue -Bob (Scrum Master): "Welcome to the retrospective, {user_name}. Let me help you identify which epic we just completed. I'll check sprint-status first, but you're the ultimate authority on what we're reviewing today." +Bob (Agile Delivery Lead): "Welcome to the retrospective, {user_name}. Let me help you identify which epic we just completed. I'll check sprint-status first, but you're the ultimate authority on what we're reviewing today." PRIORITY 1: Check {sprint_status_file} first @@ -90,7 +91,7 @@ Bob (Scrum Master): "Welcome to the retrospective, {user_name}. Let me help you Present finding to user with context -Bob (Scrum Master): "Based on {sprint_status_file}, it looks like Epic {{detected_epic}} was recently completed. Is that the epic you want to review today, {user_name}?" +Bob (Agile Delivery Lead): "Based on {sprint_status_file}, it looks like Epic {{detected_epic}} was recently completed. Is that the epic you want to review today, {user_name}?" WAIT for {user_name} to confirm or correct @@ -102,7 +103,7 @@ Bob (Scrum Master): "Based on {sprint_status_file}, it looks like Epic {{detecte Set {{epic_number}} = user-provided number -Bob (Scrum Master): "Got it, we're reviewing Epic {{epic_number}}. Let me gather that information." +Bob (Agile Delivery Lead): "Got it, we're reviewing Epic {{epic_number}}. Let me gather that information." @@ -111,7 +112,7 @@ Bob (Scrum Master): "Got it, we're reviewing Epic {{epic_number}}. Let me gather PRIORITY 2: Ask user directly -Bob (Scrum Master): "I'm having trouble detecting the completed epic from {sprint_status_file}. {user_name}, which epic number did you just complete?" +Bob (Agile Delivery Lead): "I'm having trouble detecting the completed epic from {sprint_status_file}. {user_name}, which epic number did you just complete?" WAIT for {user_name} to provide epic number @@ -126,7 +127,7 @@ Bob (Scrum Master): "I'm having trouble detecting the completed epic from {sprin Set {{detected_epic}} = highest epic number found -Bob (Scrum Master): "I found stories for Epic {{detected_epic}} in the stories folder. Is that the epic we're reviewing, {user_name}?" +Bob (Agile Delivery Lead): "I found stories for Epic {{detected_epic}} in the stories folder. Is that the epic we're reviewing, {user_name}?" WAIT for {user_name} to confirm or correct @@ -151,7 +152,7 @@ Bob (Scrum Master): "I found stories for Epic {{detected_epic}} in the stories f Alice (Product Owner): "Wait, Bob - I'm seeing that Epic {{epic_number}} isn't actually complete yet." -Bob (Scrum Master): "Let me check... you're right, Alice." +Bob (Agile Delivery Lead): "Let me check... you're right, Alice." **Epic Status:** @@ -162,7 +163,7 @@ Bob (Scrum Master): "Let me check... you're right, Alice." **Pending Stories:** {{pending_story_list}} -Bob (Scrum Master): "{user_name}, we typically run retrospectives after all stories are done. What would you like to do?" +Bob (Agile Delivery Lead): "{user_name}, we typically run retrospectives after all stories are done. What would you like to do?" **Options:** @@ -175,7 +176,7 @@ Bob (Scrum Master): "{user_name}, we typically run retrospectives after all stor -Bob (Scrum Master): "Smart call, {user_name}. Let's finish those stories first and then have a proper retrospective." +Bob (Agile Delivery Lead): "Smart call, {user_name}. Let's finish those stories first and then have a proper retrospective." HALT @@ -184,7 +185,7 @@ Bob (Scrum Master): "Smart call, {user_name}. Let's finish those stories first a Charlie (Senior Dev): "Just so everyone knows, this partial retro might miss some important lessons from those pending stories." -Bob (Scrum Master): "Good point, Charlie. {user_name}, we'll document what we can now, but we may want to revisit after everything's done." +Bob (Agile Delivery Lead): "Good point, Charlie. {user_name}, we'll document what we can now, but we may want to revisit after everything's done." @@ -192,7 +193,7 @@ Bob (Scrum Master): "Good point, Charlie. {user_name}, we'll document what we ca Alice (Product Owner): "Excellent! All {{done_stories}} stories are marked done." -Bob (Scrum Master): "Perfect. Epic {{epic_number}} is complete and ready for retrospective, {user_name}." +Bob (Agile Delivery Lead): "Perfect. Epic {{epic_number}} is complete and ready for retrospective, {user_name}." @@ -206,12 +207,12 @@ Bob (Scrum Master): "Perfect. Epic {{epic_number}} is complete and ready for ret -Bob (Scrum Master): "Before we start the team discussion, let me review all the story records to surface key themes. This'll help us have a richer conversation." +Bob (Agile Delivery Lead): "Before we start the team discussion, let me review all the story records to surface key themes. This'll help us have a richer conversation." Charlie (Senior Dev): "Good idea - those dev notes always have gold in them." -For each story in epic {{epic_number}}, read the complete story file from {implementation_artifacts}/{{epic_number}}-{{story_num}}-*.md +For each story in epic {{epic_number}}, read the complete story file from {implementation_artifacts}/{{epic_number}}-{{story_num}}-\*.md Extract and analyze from each story: @@ -288,11 +289,11 @@ Charlie (Senior Dev): "Good idea - those dev notes always have gold in them." Store this synthesis - these patterns will drive the retrospective discussion -Bob (Scrum Master): "Okay, I've reviewed all {{total_stories}} story records. I found some really interesting patterns we should discuss." +Bob (Agile Delivery Lead): "Okay, I've reviewed all {{total_stories}} story records. I found some really interesting patterns we should discuss." Dana (QA Engineer): "I'm curious what you found, Bob. I noticed some things in my testing too." -Bob (Scrum Master): "We'll get to all of it. But first, let me load the previous epic's retro to see if we learned from last time." +Bob (Agile Delivery Lead): "We'll get to all of it. But first, let me load the previous epic's retro to see if we learned from last time." @@ -306,7 +307,7 @@ Bob (Scrum Master): "We'll get to all of it. But first, let me load the previous -Bob (Scrum Master): "I found our retrospectives from Epic {{prev_epic_num}}. Let me see what we committed to back then..." +Bob (Agile Delivery Lead): "I found our retrospectives from Epic {{prev_epic_num}}. Let me see what we committed to back then..." Read the previous retrospectives @@ -355,26 +356,26 @@ Bob (Scrum Master): "I found our retrospectives from Epic {{prev_epic_num}}. Let -Bob (Scrum Master): "Interesting... in Epic {{prev_epic_num}}'s retro, we committed to {{action_count}} action items." +Bob (Agile Delivery Lead): "Interesting... in Epic {{prev_epic_num}}'s retro, we committed to {{action_count}} action items." Alice (Product Owner): "How'd we do on those, Bob?" -Bob (Scrum Master): "We completed {{completed_count}}, made progress on {{in_progress_count}}, but didn't address {{not_addressed_count}}." +Bob (Agile Delivery Lead): "We completed {{completed_count}}, made progress on {{in_progress_count}}, but didn't address {{not_addressed_count}}." Charlie (Senior Dev): _looking concerned_ "Which ones didn't we address?" -Bob (Scrum Master): "We'll discuss that in the retro. Some of them might explain challenges we had this epic." +Bob (Agile Delivery Lead): "We'll discuss that in the retro. Some of them might explain challenges we had this epic." Elena (Junior Dev): "That's... actually pretty insightful." -Bob (Scrum Master): "That's why we track this stuff. Pattern recognition helps us improve." +Bob (Agile Delivery Lead): "That's why we track this stuff. Pattern recognition helps us improve." -Bob (Scrum Master): "I don't see a retrospective for Epic {{prev_epic_num}}. Either we skipped it, or this is your first retro." +Bob (Agile Delivery Lead): "I don't see a retrospective for Epic {{prev_epic_num}}. Either we skipped it, or this is your first retro." Alice (Product Owner): "Probably our first one. Good time to start the habit!" @@ -384,7 +385,7 @@ Alice (Product Owner): "Probably our first one. Good time to start the habit!" -Bob (Scrum Master): "This is Epic 1, so naturally there's no previous retro to reference. We're starting fresh!" +Bob (Agile Delivery Lead): "This is Epic 1, so naturally there's no previous retro to reference. We're starting fresh!" Charlie (Senior Dev): "First epic, first retro. Let's make it count." @@ -398,7 +399,7 @@ Charlie (Senior Dev): "First epic, first retro. Let's make it count." Calculate next epic number: {{next_epic_num}} = {{epic_number}} + 1 -Bob (Scrum Master): "Before we dive into the discussion, let me take a quick look at Epic {{next_epic_num}} to understand what's coming." +Bob (Agile Delivery Lead): "Before we dive into the discussion, let me take a quick look at Epic {{next_epic_num}} to understand what's coming." Alice (Product Owner): "Good thinking - helps us connect what we learned to what we're about to do." @@ -406,7 +407,7 @@ Alice (Product Owner): "Good thinking - helps us connect what we learned to what Attempt to load next epic using selective loading strategy: **Try sharded first (more specific):** -Check if file exists: {planning_artifacts}/epic*/epic-{{next_epic_num}}.md +Check if file exists: {planning_artifacts}/epic\*/epic-{{next_epic_num}}.md Load {planning_artifacts}/*epic*/epic-{{next_epic_num}}.md @@ -415,7 +416,7 @@ Alice (Product Owner): "Good thinking - helps us connect what we learned to what **Fallback to whole document:** -Check if file exists: {planning_artifacts}/epic*.md +Check if file exists: {planning_artifacts}/epic\*.md Load entire epics document @@ -454,15 +455,15 @@ Alice (Product Owner): "Good thinking - helps us connect what we learned to what - Deployment or environment setup -Bob (Scrum Master): "Alright, I've reviewed Epic {{next_epic_num}}: '{{next_epic_title}}'" +Bob (Agile Delivery Lead): "Alright, I've reviewed Epic {{next_epic_num}}: '{{next_epic_title}}'" Alice (Product Owner): "What are we looking at?" -Bob (Scrum Master): "{{next_epic_num}} stories planned, building on the {{dependency_description}} from Epic {{epic_number}}." +Bob (Agile Delivery Lead): "{{next_epic_num}} stories planned, building on the {{dependency_description}} from Epic {{epic_number}}." Charlie (Senior Dev): "Dependencies concern me. Did we finish everything we need for that?" -Bob (Scrum Master): "Good question - that's exactly what we need to explore in this retro." +Bob (Agile Delivery Lead): "Good question - that's exactly what we need to explore in this retro." Set {{next_epic_exists}} = true @@ -470,11 +471,11 @@ Bob (Scrum Master): "Good question - that's exactly what we need to explore in t -Bob (Scrum Master): "Hmm, I don't see Epic {{next_epic_num}} defined yet." +Bob (Agile Delivery Lead): "Hmm, I don't see Epic {{next_epic_num}} defined yet." Alice (Product Owner): "We might be at the end of the roadmap, or we haven't planned that far ahead yet." -Bob (Scrum Master): "No problem. We'll still do a thorough retro on Epic {{epic_number}}. The lessons will be valuable whenever we plan the next work." +Bob (Agile Delivery Lead): "No problem. We'll still do a thorough retro on Epic {{epic_number}}. The lessons will be valuable whenever we plan the next work." Set {{next_epic_exists}} = false @@ -489,13 +490,13 @@ Bob (Scrum Master): "No problem. We'll still do a thorough retro on Epic {{epic_ Ensure key roles present: Product Owner, Scrum Master (facilitating), Devs, Testing/QA, Architect -Bob (Scrum Master): "Alright team, everyone's here. Let me set the stage for our retrospective." +Bob (Agile Delivery Lead): "Alright team, everyone's here. Let me set the stage for our retrospective." โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• ๐Ÿ”„ TEAM RETROSPECTIVE - Epic {{epic_number}}: {{epic_title}} โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• -Bob (Scrum Master): "Here's what we accomplished together." +Bob (Agile Delivery Lead): "Here's what we accomplished together." **EPIC {{epic_number}} SUMMARY:** @@ -539,7 +540,7 @@ Preparation Needed: Technical Prerequisites: {{list_technical_prereqs}} -Bob (Scrum Master): "And here's what's coming next. Epic {{next_epic_num}} builds on what we just finished." +Bob (Agile Delivery Lead): "And here's what's coming next. Epic {{next_epic_num}} builds on what we just finished." Elena (Junior Dev): "Wow, that's a lot of dependencies on our work." @@ -548,24 +549,24 @@ Charlie (Senior Dev): "Which means we better make sure Epic {{epic_number}} is a โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• -Bob (Scrum Master): "Team assembled for this retrospective:" +Bob (Agile Delivery Lead): "Team assembled for this retrospective:" {{list_participating_agents}} -Bob (Scrum Master): "{user_name}, you're joining us as Project Lead. Your perspective is crucial here." +Bob (Agile Delivery Lead): "{user_name}, you're joining us as Project Lead. Your perspective is crucial here." {user_name} (Project Lead): [Participating in the retrospective] -Bob (Scrum Master): "Our focus today:" +Bob (Agile Delivery Lead): "Our focus today:" 1. Learning from Epic {{epic_number}} execution {{#if next_epic_exists}}2. Preparing for Epic {{next_epic_num}} success{{/if}} -Bob (Scrum Master): "Ground rules: psychological safety first. No blame, no judgment. We focus on systems and processes, not individuals. Everyone's voice matters. Specific examples are better than generalizations." +Bob (Agile Delivery Lead): "Ground rules: psychological safety first. No blame, no judgment. We focus on systems and processes, not individuals. Everyone's voice matters. Specific examples are better than generalizations." Alice (Product Owner): "And everything shared here stays in this room - unless we decide together to escalate something." -Bob (Scrum Master): "Exactly. {user_name}, any questions before we dive in?" +Bob (Agile Delivery Lead): "Exactly. {user_name}, any questions before we dive in?" WAIT for {user_name} to respond or indicate readiness @@ -575,9 +576,9 @@ Bob (Scrum Master): "Exactly. {user_name}, any questions before we dive in?" -Bob (Scrum Master): "Let's start with the good stuff. What went well in Epic {{epic_number}}?" +Bob (Agile Delivery Lead): "Let's start with the good stuff. What went well in Epic {{epic_number}}?" -Bob (Scrum Master): _pauses, creating space_ +Bob (Agile Delivery Lead): _pauses, creating space_ Alice (Product Owner): "I'll start. The user authentication flow we delivered exceeded my expectations. The UX is smooth, and early user feedback has been really positive." @@ -590,10 +591,10 @@ Elena (Junior Dev): _smiling_ "That's because Charlie made me document everythin Charlie (Senior Dev): _laughing_ "Tough love pays off." -Bob (Scrum Master) naturally turns to {user_name} to engage them in the discussion +Bob (Agile Delivery Lead) naturally turns to {user_name} to engage them in the discussion -Bob (Scrum Master): "{user_name}, what stood out to you as going well in this epic?" +Bob (Agile Delivery Lead): "{user_name}, what stood out to you as going well in this epic?" WAIT for {user_name} to respond - this is a KEY USER INTERACTION moment @@ -611,9 +612,9 @@ Charlie (Senior Dev): [Builds on the discussion, perhaps adding technical detail After covering successes, guide the transition to challenges with care -Bob (Scrum Master): "Okay, we've celebrated some real wins. Now let's talk about challenges - where did we struggle? What slowed us down?" +Bob (Agile Delivery Lead): "Okay, we've celebrated some real wins. Now let's talk about challenges - where did we struggle? What slowed us down?" -Bob (Scrum Master): _creates safe space with tone and pacing_ +Bob (Agile Delivery Lead): _creates safe space with tone and pacing_ Elena (Junior Dev): _hesitates_ "Well... I really struggled with the database migrations in Story {{difficult_story_num}}. The documentation wasn't clear, and I had to redo it three times. Lost almost a full sprint on that story alone." @@ -623,11 +624,11 @@ Alice (Product Owner): _frustrated_ "That's not fair, Charlie. We only clarified Charlie (Senior Dev): _heat rising_ "We asked plenty of questions! You said the schema was finalized, then two days into development you wanted to add three new fields!" -Bob (Scrum Master): _intervening calmly_ "Let's take a breath here. This is exactly the kind of thing we need to unpack." +Bob (Agile Delivery Lead): _intervening calmly_ "Let's take a breath here. This is exactly the kind of thing we need to unpack." -Bob (Scrum Master): "Elena, you spent almost a full sprint on Story {{difficult_story_num}}. Charlie, you're saying requirements changed. Alice, you feel the right questions weren't asked up front." +Bob (Agile Delivery Lead): "Elena, you spent almost a full sprint on Story {{difficult_story_num}}. Charlie, you're saying requirements changed. Alice, you feel the right questions weren't asked up front." -Bob (Scrum Master): "{user_name}, you have visibility across the whole project. What's your take on this situation?" +Bob (Agile Delivery Lead): "{user_name}, you have visibility across the whole project. What's your take on this situation?" WAIT for {user_name} to respond and help facilitate the conflict resolution @@ -635,7 +636,7 @@ Bob (Scrum Master): "{user_name}, you have visibility across the whole project. Use {user_name}'s response to guide the discussion toward systemic understanding rather than blame -Bob (Scrum Master): [Synthesizes {user_name}'s input with what the team shared] "So it sounds like the core issue was {{root_cause_based_on_discussion}}, not any individual person's fault." +Bob (Agile Delivery Lead): [Synthesizes {user_name}'s input with what the team shared] "So it sounds like the core issue was {{root_cause_based_on_discussion}}, not any individual person's fault." Elena (Junior Dev): "That makes sense. If we'd had {{preventive_measure}}, I probably could have avoided those redos." @@ -643,23 +644,23 @@ Charlie (Senior Dev): _softening_ "Yeah, and I could have been clearer about ass Alice (Product Owner): "I appreciate that. I could've been more proactive about flagging the schema additions earlier, too." -Bob (Scrum Master): "This is good. We're identifying systemic improvements, not assigning blame." +Bob (Agile Delivery Lead): "This is good. We're identifying systemic improvements, not assigning blame." Continue the discussion, weaving in patterns discovered from the deep story analysis (Step 2) -Bob (Scrum Master): "Speaking of patterns, I noticed something when reviewing all the story records..." +Bob (Agile Delivery Lead): "Speaking of patterns, I noticed something when reviewing all the story records..." -Bob (Scrum Master): "{{pattern_1_description}} - this showed up in {{pattern_1_count}} out of {{total_stories}} stories." +Bob (Agile Delivery Lead): "{{pattern_1_description}} - this showed up in {{pattern_1_count}} out of {{total_stories}} stories." Dana (QA Engineer): "Oh wow, I didn't realize it was that widespread." -Bob (Scrum Master): "Yeah. And there's more - {{pattern_2_description}} came up in almost every code review." +Bob (Agile Delivery Lead): "Yeah. And there's more - {{pattern_2_description}} came up in almost every code review." Charlie (Senior Dev): "That's... actually embarrassing. We should've caught that pattern earlier." -Bob (Scrum Master): "No shame, Charlie. Now we know, and we can improve. {user_name}, did you notice these patterns during the epic?" +Bob (Agile Delivery Lead): "No shame, Charlie. Now we know, and we can improve. {user_name}, did you notice these patterns during the epic?" WAIT for {user_name} to share their observations @@ -675,21 +676,21 @@ Bob (Scrum Master): "No shame, Charlie. Now we know, and we can improve. {user_n -Bob (Scrum Master): "Before we move on, I want to circle back to Epic {{prev_epic_num}}'s retrospective." +Bob (Agile Delivery Lead): "Before we move on, I want to circle back to Epic {{prev_epic_num}}'s retrospective." -Bob (Scrum Master): "We made some commitments in that retro. Let's see how we did." +Bob (Agile Delivery Lead): "We made some commitments in that retro. Let's see how we did." -Bob (Scrum Master): "Action item 1: {{prev_action_1}}. Status: {{prev_action_1_status}}" +Bob (Agile Delivery Lead): "Action item 1: {{prev_action_1}}. Status: {{prev_action_1_status}}" Alice (Product Owner): {{#if prev_action_1_status == "completed"}}"We nailed that one!"{{else}}"We... didn't do that one."{{/if}} Charlie (Senior Dev): {{#if prev_action_1_status == "completed"}}"And it helped! I noticed {{evidence_of_impact}}"{{else}}"Yeah, and I think that's why we had {{consequence_of_not_doing_it}} this epic."{{/if}} -Bob (Scrum Master): "Action item 2: {{prev_action_2}}. Status: {{prev_action_2_status}}" +Bob (Agile Delivery Lead): "Action item 2: {{prev_action_2}}. Status: {{prev_action_2_status}}" Dana (QA Engineer): {{#if prev_action_2_status == "completed"}}"This one made testing so much easier this time."{{else}}"If we'd done this, I think testing would've gone faster."{{/if}} -Bob (Scrum Master): "{user_name}, looking at what we committed to last time and what we actually did - what's your reaction?" +Bob (Agile Delivery Lead): "{user_name}, looking at what we committed to last time and what we actually did - what's your reaction?" WAIT for {user_name} to respond @@ -698,18 +699,18 @@ Bob (Scrum Master): "{user_name}, looking at what we committed to last time and -Bob (Scrum Master): "Alright, we've covered a lot of ground. Let me summarize what I'm hearing..." +Bob (Agile Delivery Lead): "Alright, we've covered a lot of ground. Let me summarize what I'm hearing..." -Bob (Scrum Master): "**Successes:**" +Bob (Agile Delivery Lead): "**Successes:**" {{list_success_themes}} -Bob (Scrum Master): "**Challenges:**" +Bob (Agile Delivery Lead): "**Challenges:**" {{list_challenge_themes}} -Bob (Scrum Master): "**Key Insights:**" +Bob (Agile Delivery Lead): "**Key Insights:**" {{list_insight_themes}} -Bob (Scrum Master): "Does that capture it? Anyone have something important we missed?" +Bob (Agile Delivery Lead): "Does that capture it? Anyone have something important we missed?" Allow team members to add any final thoughts on the epic review @@ -721,15 +722,15 @@ Bob (Scrum Master): "Does that capture it? Anyone have something important we mi -Bob (Scrum Master): "Normally we'd discuss preparing for the next epic, but since Epic {{next_epic_num}} isn't defined yet, let's skip to action items." +Bob (Agile Delivery Lead): "Normally we'd discuss preparing for the next epic, but since Epic {{next_epic_num}} isn't defined yet, let's skip to action items." Skip to Step 8 -Bob (Scrum Master): "Now let's shift gears. Epic {{next_epic_num}} is coming up: '{{next_epic_title}}'" +Bob (Agile Delivery Lead): "Now let's shift gears. Epic {{next_epic_num}} is coming up: '{{next_epic_title}}'" -Bob (Scrum Master): "The question is: are we ready? What do we need to prepare?" +Bob (Agile Delivery Lead): "The question is: are we ready? What do we need to prepare?" Alice (Product Owner): "From my perspective, we need to make sure {{dependency_concern_1}} from Epic {{epic_number}} is solid before we start building on it." @@ -739,7 +740,7 @@ Dana (QA Engineer): "And I need {{testing_infrastructure_need}} in place, or we' Elena (Junior Dev): "I'm less worried about infrastructure and more about knowledge. I don't understand {{knowledge_gap}} well enough to work on Epic {{next_epic_num}}'s stories." -Bob (Scrum Master): "{user_name}, the team is surfacing some real concerns here. What's your sense of our readiness?" +Bob (Agile Delivery Lead): "{user_name}, the team is surfacing some real concerns here. What's your sense of our readiness?" WAIT for {user_name} to share their assessment @@ -761,13 +762,13 @@ Charlie (Senior Dev): "Exactly. We can't just jump into Epic {{next_epic_num}} o Alice (Product Owner): _frustrated_ "But we have stakeholder pressure to keep shipping features. They're not going to be happy about a 'prep sprint.'" -Bob (Scrum Master): "Let's think about this differently. What happens if we DON'T do this prep work?" +Bob (Agile Delivery Lead): "Let's think about this differently. What happens if we DON'T do this prep work?" Dana (QA Engineer): "We'll hit blockers in the middle of Epic {{next_epic_num}}, velocity will tank, and we'll ship late anyway." Charlie (Senior Dev): "Worse - we'll ship something built on top of {{technical_concern_1}}, and it'll be fragile." -Bob (Scrum Master): "{user_name}, you're balancing stakeholder pressure against technical reality. How do you want to handle this?" +Bob (Agile Delivery Lead): "{user_name}, you're balancing stakeholder pressure against technical reality. How do you want to handle this?" WAIT for {user_name} to provide direction on preparation approach @@ -779,9 +780,9 @@ Alice (Product Owner): [Potentially disagrees with {user_name}'s approach] "I he Charlie (Senior Dev): [Potentially supports or challenges Alice's point] "The business perspective is valid, but {{technical_counter_argument}}." -Bob (Scrum Master): "We have healthy tension here between business needs and technical reality. That's good - it means we're being honest." +Bob (Agile Delivery Lead): "We have healthy tension here between business needs and technical reality. That's good - it means we're being honest." -Bob (Scrum Master): "Let's explore a middle ground. Charlie, which of your prep items are absolutely critical vs. nice-to-have?" +Bob (Agile Delivery Lead): "Let's explore a middle ground. Charlie, which of your prep items are absolutely critical vs. nice-to-have?" Charlie (Senior Dev): "{{critical_prep_item_1}} and {{critical_prep_item_2}} are non-negotiable. {{nice_to_have_prep_item}} can wait." @@ -793,7 +794,7 @@ Dana (QA Engineer): "But that means Story 1 of Epic {{next_epic_num}} can't depe Alice (Product Owner): _looking at epic plan_ "Actually, Stories 1 and 2 are about {{independent_work}}, so they don't depend on it. We could make that work." -Bob (Scrum Master): "{user_name}, the team is finding a workable compromise here. Does this approach make sense to you?" +Bob (Agile Delivery Lead): "{user_name}, the team is finding a workable compromise here. Does this approach make sense to you?" WAIT for {user_name} to validate or adjust the preparation strategy @@ -819,7 +820,7 @@ Bob (Scrum Master): "{user_name}, the team is finding a workable compromise here - Brings {user_name} in for key decisions -Bob (Scrum Master): "I'm hearing a clear picture of what we need before Epic {{next_epic_num}}. Let me summarize..." +Bob (Agile Delivery Lead): "I'm hearing a clear picture of what we need before Epic {{next_epic_num}}. Let me summarize..." **CRITICAL PREPARATION (Must complete before epic starts):** {{list_critical_prep_items_with_owners_and_estimates}} @@ -830,11 +831,11 @@ Bob (Scrum Master): "I'm hearing a clear picture of what we need before Epic {{n **NICE-TO-HAVE PREPARATION (Would help but not blocking):** {{list_nice_to_have_prep_items}} -Bob (Scrum Master): "Total critical prep effort: {{critical_hours}} hours ({{critical_days}} days)" +Bob (Agile Delivery Lead): "Total critical prep effort: {{critical_hours}} hours ({{critical_days}} days)" Alice (Product Owner): "That's manageable. We can communicate that to stakeholders." -Bob (Scrum Master): "{user_name}, does this preparation plan work for you?" +Bob (Agile Delivery Lead): "{user_name}, does this preparation plan work for you?" WAIT for {user_name} final validation of preparation plan @@ -844,9 +845,9 @@ Bob (Scrum Master): "{user_name}, does this preparation plan work for you?" -Bob (Scrum Master): "Let's capture concrete action items from everything we've discussed." +Bob (Agile Delivery Lead): "Let's capture concrete action items from everything we've discussed." -Bob (Scrum Master): "I want specific, achievable actions with clear owners. Not vague aspirations." +Bob (Agile Delivery Lead): "I want specific, achievable actions with clear owners. Not vague aspirations." Synthesize themes from Epic {{epic_number}} review discussion into actionable improvements @@ -868,7 +869,7 @@ Bob (Scrum Master): "I want specific, achievable actions with clear owners. Not - Time-bound: Has clear deadline -Bob (Scrum Master): "Based on our discussion, here are the action items I'm proposing..." +Bob (Agile Delivery Lead): "Based on our discussion, here are the action items I'm proposing..." โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• ๐Ÿ“ EPIC {{epic_number}} ACTION ITEMS: @@ -888,11 +889,11 @@ Bob (Scrum Master): "Based on our discussion, here are the action items I'm prop Charlie (Senior Dev): "I can own action item 1, but {{timeline_1}} is tight. Can we push it to {{alternative_timeline}}?" -Bob (Scrum Master): "What do others think? Does that timing still work?" +Bob (Agile Delivery Lead): "What do others think? Does that timing still work?" Alice (Product Owner): "{{alternative_timeline}} works for me, as long as it's done before Epic {{next_epic_num}} starts." -Bob (Scrum Master): "Agreed. Updated to {{alternative_timeline}}." +Bob (Agile Delivery Lead): "Agreed. Updated to {{alternative_timeline}}." **Technical Debt:** @@ -910,7 +911,7 @@ Dana (QA Engineer): "For debt item 1, can we prioritize that as high? It caused Charlie (Senior Dev): "I marked it medium because {{reasoning}}, but I hear your point." -Bob (Scrum Master): "{user_name}, this is a priority call. Testing impact vs. {{reasoning}} - how do you want to prioritize it?" +Bob (Agile Delivery Lead): "{user_name}, this is a priority call. Testing impact vs. {{reasoning}} - how do you want to prioritize it?" WAIT for {user_name} to help resolve priority discussions @@ -931,7 +932,7 @@ Bob (Scrum Master): "{user_name}, this is a priority call. Testing impact vs. {{ - {{agreement_2}} - {{agreement_3}} -Bob (Scrum Master): "These agreements are how we're committing to work differently going forward." +Bob (Agile Delivery Lead): "These agreements are how we're committing to work differently going forward." Elena (Junior Dev): "I like agreement 2 - that would've saved me on Story {{difficult_story_num}}." @@ -997,9 +998,9 @@ Estimated: {{est_4}} ๐Ÿšจ SIGNIFICANT DISCOVERY ALERT ๐Ÿšจ โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• -Bob (Scrum Master): "{user_name}, we need to flag something important." +Bob (Agile Delivery Lead): "{user_name}, we need to flag something important." -Bob (Scrum Master): "During Epic {{epic_number}}, the team uncovered findings that may require updating the plan for Epic {{next_epic_num}}." +Bob (Agile Delivery Lead): "During Epic {{epic_number}}, the team uncovered findings that may require updating the plan for Epic {{next_epic_num}}." **Significant Changes Identified:** @@ -1042,9 +1043,9 @@ This means Epic {{next_epic_num}} likely needs: 4. Hold alignment session with Product Owner before starting Epic {{next_epic_num}} {{#if prd_update_needed}}5. Update PRD sections affected by new understanding{{/if}} -Bob (Scrum Master): "**Epic Update Required**: YES - Schedule epic planning review session" +Bob (Agile Delivery Lead): "**Epic Update Required**: YES - Schedule epic planning review session" -Bob (Scrum Master): "{user_name}, this is significant. We need to address this before committing to Epic {{next_epic_num}}'s current plan. How do you want to handle it?" +Bob (Agile Delivery Lead): "{user_name}, this is significant. We need to address this before committing to Epic {{next_epic_num}}'s current plan. How do you want to handle it?" WAIT for {user_name} to decide on how to handle the significant changes @@ -1056,24 +1057,24 @@ Alice (Product Owner): "I agree with {user_name}'s approach. Better to adjust th Charlie (Senior Dev): "This is why retrospectives matter. We caught this before it became a disaster." -Bob (Scrum Master): "Adding to critical path: Epic {{next_epic_num}} planning review session before epic kickoff." +Bob (Agile Delivery Lead): "Adding to critical path: Epic {{next_epic_num}} planning review session before epic kickoff." -Bob (Scrum Master): "Good news - nothing from Epic {{epic_number}} fundamentally changes our plan for Epic {{next_epic_num}}. The plan is still sound." +Bob (Agile Delivery Lead): "Good news - nothing from Epic {{epic_number}} fundamentally changes our plan for Epic {{next_epic_num}}. The plan is still sound." Alice (Product Owner): "We learned a lot, but the direction is right." -Bob (Scrum Master): "Let me show you the complete action plan..." +Bob (Agile Delivery Lead): "Let me show you the complete action plan..." -Bob (Scrum Master): "That's {{total_action_count}} action items, {{prep_task_count}} preparation tasks, and {{critical_count}} critical path items." +Bob (Agile Delivery Lead): "That's {{total_action_count}} action items, {{prep_task_count}} preparation tasks, and {{critical_count}} critical path items." -Bob (Scrum Master): "Everyone clear on what they own?" +Bob (Agile Delivery Lead): "Everyone clear on what they own?" Give each agent with assignments a moment to acknowledge their ownership @@ -1085,21 +1086,21 @@ Bob (Scrum Master): "Everyone clear on what they own?" -Bob (Scrum Master): "Before we close, I want to do a final readiness check." +Bob (Agile Delivery Lead): "Before we close, I want to do a final readiness check." -Bob (Scrum Master): "Epic {{epic_number}} is marked complete in sprint-status, but is it REALLY done?" +Bob (Agile Delivery Lead): "Epic {{epic_number}} is marked complete in sprint-status, but is it REALLY done?" Alice (Product Owner): "What do you mean, Bob?" -Bob (Scrum Master): "I mean truly production-ready, stakeholders happy, no loose ends that'll bite us later." +Bob (Agile Delivery Lead): "I mean truly production-ready, stakeholders happy, no loose ends that'll bite us later." -Bob (Scrum Master): "{user_name}, let's walk through this together." +Bob (Agile Delivery Lead): "{user_name}, let's walk through this together." Explore testing and quality state through natural conversation -Bob (Scrum Master): "{user_name}, tell me about the testing for Epic {{epic_number}}. What verification has been done?" +Bob (Agile Delivery Lead): "{user_name}, tell me about the testing for Epic {{epic_number}}. What verification has been done?" WAIT for {user_name} to describe testing status @@ -1109,18 +1110,18 @@ Dana (QA Engineer): [Responds to what {user_name} shared] "I can add to that - { Dana (QA Engineer): "But honestly, {{testing_concern_if_any}}." -Bob (Scrum Master): "{user_name}, are you confident Epic {{epic_number}} is production-ready from a quality perspective?" +Bob (Agile Delivery Lead): "{user_name}, are you confident Epic {{epic_number}} is production-ready from a quality perspective?" WAIT for {user_name} to assess quality readiness -Bob (Scrum Master): "Okay, let's capture that. What specific testing is still needed?" +Bob (Agile Delivery Lead): "Okay, let's capture that. What specific testing is still needed?" Dana (QA Engineer): "I can handle {{testing_work_needed}}, estimated {{testing_hours}} hours." -Bob (Scrum Master): "Adding to critical path: Complete {{testing_work_needed}} before Epic {{next_epic_num}}." +Bob (Agile Delivery Lead): "Adding to critical path: Complete {{testing_work_needed}} before Epic {{next_epic_num}}." Add testing completion to critical path @@ -1128,7 +1129,7 @@ Bob (Scrum Master): "Adding to critical path: Complete {{testing_work_needed}} b Explore deployment and release status -Bob (Scrum Master): "{user_name}, what's the deployment status for Epic {{epic_number}}? Is it live in production, scheduled for deployment, or still pending?" +Bob (Agile Delivery Lead): "{user_name}, what's the deployment status for Epic {{epic_number}}? Is it live in production, scheduled for deployment, or still pending?" WAIT for {user_name} to provide deployment status @@ -1137,7 +1138,7 @@ Bob (Scrum Master): "{user_name}, what's the deployment status for Epic {{epic_n Charlie (Senior Dev): "If it's not deployed yet, we need to factor that into Epic {{next_epic_num}} timing." -Bob (Scrum Master): "{user_name}, when is deployment planned? Does that timing work for starting Epic {{next_epic_num}}?" +Bob (Agile Delivery Lead): "{user_name}, when is deployment planned? Does that timing work for starting Epic {{next_epic_num}}?" WAIT for {user_name} to clarify deployment timeline @@ -1148,11 +1149,11 @@ Bob (Scrum Master): "{user_name}, when is deployment planned? Does that timing w Explore stakeholder acceptance -Bob (Scrum Master): "{user_name}, have stakeholders seen and accepted the Epic {{epic_number}} deliverables?" +Bob (Agile Delivery Lead): "{user_name}, have stakeholders seen and accepted the Epic {{epic_number}} deliverables?" Alice (Product Owner): "This is important - I've seen 'done' epics get rejected by stakeholders and force rework." -Bob (Scrum Master): "{user_name}, any feedback from stakeholders still pending?" +Bob (Agile Delivery Lead): "{user_name}, any feedback from stakeholders still pending?" WAIT for {user_name} to describe stakeholder acceptance status @@ -1161,7 +1162,7 @@ Bob (Scrum Master): "{user_name}, any feedback from stakeholders still pending?" Alice (Product Owner): "We should get formal acceptance before moving on. Otherwise Epic {{next_epic_num}} might get interrupted by rework." -Bob (Scrum Master): "{user_name}, how do you want to handle stakeholder acceptance? Should we make it a critical path item?" +Bob (Agile Delivery Lead): "{user_name}, how do you want to handle stakeholder acceptance? Should we make it a critical path item?" WAIT for {user_name} decision @@ -1172,9 +1173,9 @@ Bob (Scrum Master): "{user_name}, how do you want to handle stakeholder acceptan Explore technical health and stability -Bob (Scrum Master): "{user_name}, this is a gut-check question: How does the codebase feel after Epic {{epic_number}}?" +Bob (Agile Delivery Lead): "{user_name}, this is a gut-check question: How does the codebase feel after Epic {{epic_number}}?" -Bob (Scrum Master): "Stable and maintainable? Or are there concerns lurking?" +Bob (Agile Delivery Lead): "Stable and maintainable? Or are there concerns lurking?" Charlie (Senior Dev): "Be honest, {user_name}. We've all shipped epics that felt... fragile." @@ -1187,11 +1188,11 @@ Charlie (Senior Dev): "Okay, let's dig into that. What's causing those concerns? Charlie (Senior Dev): [Helps {user_name} articulate technical concerns] -Bob (Scrum Master): "What would it take to address these concerns and feel confident about stability?" +Bob (Agile Delivery Lead): "What would it take to address these concerns and feel confident about stability?" Charlie (Senior Dev): "I'd say we need {{stability_work_needed}}, roughly {{stability_hours}} hours." -Bob (Scrum Master): "{user_name}, is addressing this stability work worth doing before Epic {{next_epic_num}}?" +Bob (Agile Delivery Lead): "{user_name}, is addressing this stability work worth doing before Epic {{next_epic_num}}?" WAIT for {user_name} decision @@ -1202,26 +1203,26 @@ Bob (Scrum Master): "{user_name}, is addressing this stability work worth doing Explore unresolved blockers -Bob (Scrum Master): "{user_name}, are there any unresolved blockers or technical issues from Epic {{epic_number}} that we're carrying forward?" +Bob (Agile Delivery Lead): "{user_name}, are there any unresolved blockers or technical issues from Epic {{epic_number}} that we're carrying forward?" Dana (QA Engineer): "Things that might create problems for Epic {{next_epic_num}} if we don't deal with them?" -Bob (Scrum Master): "Nothing is off limits here. If there's a problem, we need to know." +Bob (Agile Delivery Lead): "Nothing is off limits here. If there's a problem, we need to know." WAIT for {user_name} to surface any blockers -Bob (Scrum Master): "Let's capture those blockers and figure out how they affect Epic {{next_epic_num}}." +Bob (Agile Delivery Lead): "Let's capture those blockers and figure out how they affect Epic {{next_epic_num}}." Charlie (Senior Dev): "For {{blocker_1}}, if we leave it unresolved, it'll {{impact_description_1}}." Alice (Product Owner): "That sounds critical. We need to address that before moving forward." -Bob (Scrum Master): "Agreed. Adding to critical path: Resolve {{blocker_1}} before Epic {{next_epic_num}} kickoff." +Bob (Agile Delivery Lead): "Agreed. Adding to critical path: Resolve {{blocker_1}} before Epic {{next_epic_num}} kickoff." -Bob (Scrum Master): "Who owns that work?" +Bob (Agile Delivery Lead): "Who owns that work?" Assign blocker resolution to appropriate agent @@ -1231,7 +1232,7 @@ Bob (Scrum Master): "Who owns that work?" Synthesize the readiness assessment -Bob (Scrum Master): "Okay {user_name}, let me synthesize what we just uncovered..." +Bob (Agile Delivery Lead): "Okay {user_name}, let me synthesize what we just uncovered..." **EPIC {{epic_number}} READINESS ASSESSMENT:** @@ -1250,13 +1251,13 @@ Technical Health: {{stability_status}} Unresolved Blockers: {{blocker_status}} {{#if blockers_exist}}โš ๏ธ Must resolve: {{blocker_list}}{{/if}} -Bob (Scrum Master): "{user_name}, does this assessment match your understanding?" +Bob (Agile Delivery Lead): "{user_name}, does this assessment match your understanding?" WAIT for {user_name} to confirm or correct the assessment -Bob (Scrum Master): "Based on this assessment, Epic {{epic_number}} is {{#if all_clear}}fully complete and we're clear to proceed{{else}}complete from a story perspective, but we have {{critical_work_count}} critical items before Epic {{next_epic_num}}{{/if}}." +Bob (Agile Delivery Lead): "Based on this assessment, Epic {{epic_number}} is {{#if all_clear}}fully complete and we're clear to proceed{{else}}complete from a story perspective, but we have {{critical_work_count}} critical items before Epic {{next_epic_num}}{{/if}}." Alice (Product Owner): "This level of thoroughness is why retrospectives are valuable." @@ -1268,13 +1269,13 @@ Charlie (Senior Dev): "Better to catch this now than three stories into the next -Bob (Scrum Master): "We've covered a lot of ground today. Let me bring this retrospective to a close." +Bob (Agile Delivery Lead): "We've covered a lot of ground today. Let me bring this retrospective to a close." โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• โœ… RETROSPECTIVE COMPLETE โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• -Bob (Scrum Master): "Epic {{epic_number}}: {{epic_title}} - REVIEWED" +Bob (Agile Delivery Lead): "Epic {{epic_number}}: {{epic_title}} - REVIEWED" **Key Takeaways:** @@ -1287,7 +1288,7 @@ Alice (Product Owner): "That first takeaway is huge - {{impact_of_lesson_1}}." Charlie (Senior Dev): "And lesson 2 is something we can apply immediately." -Bob (Scrum Master): "Commitments made today:" +Bob (Agile Delivery Lead): "Commitments made today:" - Action Items: {{action_count}} - Preparation Tasks: {{prep_task_count}} @@ -1295,7 +1296,7 @@ Bob (Scrum Master): "Commitments made today:" Dana (QA Engineer): "That's a lot of commitments. We need to actually follow through this time." -Bob (Scrum Master): "Agreed. Which is why we'll review these action items in our next standup." +Bob (Agile Delivery Lead): "Agreed. Which is why we'll review these action items in our next standup." โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• ๐ŸŽฏ NEXT STEPS: @@ -1312,9 +1313,9 @@ Alice (Product Owner): "I'll communicate the timeline to stakeholders. They'll u โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• -Bob (Scrum Master): "Before we wrap, I want to take a moment to acknowledge the team." +Bob (Agile Delivery Lead): "Before we wrap, I want to take a moment to acknowledge the team." -Bob (Scrum Master): "Epic {{epic_number}} delivered {{completed_stories}} stories with {{velocity_description}} velocity. We overcame {{blocker_count}} blockers. We learned a lot. That's real work by real people." +Bob (Agile Delivery Lead): "Epic {{epic_number}} delivered {{completed_stories}} stories with {{velocity_description}} velocity. We overcame {{blocker_count}} blockers. We learned a lot. That's real work by real people." Charlie (Senior Dev): "Hear, hear." @@ -1322,17 +1323,17 @@ Alice (Product Owner): "I'm proud of what we shipped." Dana (QA Engineer): "And I'm excited about Epic {{next_epic_num}} - especially now that we're prepared for it." -Bob (Scrum Master): "{user_name}, any final thoughts before we close?" +Bob (Agile Delivery Lead): "{user_name}, any final thoughts before we close?" WAIT for {user_name} to share final reflections -Bob (Scrum Master): [Acknowledges what {user_name} shared] "Thank you for that, {user_name}." +Bob (Agile Delivery Lead): [Acknowledges what {user_name} shared] "Thank you for that, {user_name}." -Bob (Scrum Master): "Alright team - great work today. We learned a lot from Epic {{epic_number}}. Let's use these insights to make Epic {{next_epic_num}} even better." +Bob (Agile Delivery Lead): "Alright team - great work today. We learned a lot from Epic {{epic_number}}. Let's use these insights to make Epic {{next_epic_num}} even better." -Bob (Scrum Master): "See you all when prep work is done. Meeting adjourned!" +Bob (Agile Delivery Lead): "See you all when prep work is done. Meeting adjourned!" โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• @@ -1438,7 +1439,7 @@ Retrospective document was saved successfully, but {sprint_status_file} may need {{else}} 4. **Begin Epic {{next_epic_num}} when ready** - - Start creating stories with SM agent's `create-story` + - Start creating stories with ADL agent's `create-story` - Epic will be marked as `in-progress` automatically when first story is created - Ensure all critical path items are done first {{/if}} @@ -1452,7 +1453,7 @@ Epic {{epic_number}} delivered {{completed_stories}} stories with {{velocity_sum --- -Bob (Scrum Master): "Great session today, {user_name}. The team did excellent work." +Bob (Agile Delivery Lead): "Great session today, {user_name}. The team did excellent work." Alice (Product Owner): "See you at epic planning!"