bmad-method 6.0.0-alpha.0 → 6.0.0-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/bmad/bmb/agents/bmad-builder.md +70 -0
- package/.claude/commands/bmad/bmb/workflows/README.md +67 -0
- package/.claude/commands/bmad/bmb/workflows/audit-workflow.md +15 -0
- package/.claude/commands/bmad/bmb/workflows/convert-legacy.md +15 -0
- package/.claude/commands/bmad/bmb/workflows/create-agent.md +15 -0
- package/.claude/commands/bmad/bmb/workflows/create-module.md +15 -0
- package/.claude/commands/bmad/bmb/workflows/create-workflow.md +15 -0
- package/.claude/commands/bmad/bmb/workflows/edit-agent.md +15 -0
- package/.claude/commands/bmad/bmb/workflows/edit-module.md +15 -0
- package/.claude/commands/bmad/bmb/workflows/edit-workflow.md +15 -0
- package/.claude/commands/bmad/bmb/workflows/module-brief.md +15 -0
- package/.claude/commands/bmad/bmb/workflows/redoc.md +15 -0
- package/.claude/commands/bmad/bmd/agents/cli-chief.md +108 -0
- package/.claude/commands/bmad/bmd/agents/doc-keeper.md +115 -0
- package/.claude/commands/bmad/bmd/agents/release-chief.md +109 -0
- package/.claude/commands/bmad/core/agents/bmad-master.md +71 -0
- package/.claude/commands/bmad/core/tasks/index-docs.md +9 -0
- package/.claude/commands/bmad/core/tools/shard-doc.md +9 -0
- package/.claude/commands/bmad/core/workflows/README.md +27 -0
- package/.claude/commands/bmad/core/workflows/brainstorming.md +15 -0
- package/.claude/commands/bmad/core/workflows/party-mode.md +15 -0
- package/.claude/hooks/bmad-tts-injector.sh +415 -0
- package/.claude/hooks/bmad-voice-manager.sh +511 -0
- package/.claude/hooks/check-output-style.sh +112 -0
- package/.claude/hooks/download-extra-voices.sh +244 -0
- package/.claude/hooks/github-star-reminder.sh +154 -0
- package/.claude/hooks/language-manager.sh +392 -0
- package/.claude/hooks/learn-manager.sh +475 -0
- package/.claude/hooks/personality-manager.sh +438 -0
- package/.claude/hooks/piper-download-voices.sh +165 -0
- package/.claude/hooks/piper-installer.sh +178 -0
- package/.claude/hooks/piper-multispeaker-registry.sh +165 -0
- package/.claude/hooks/piper-voice-manager.sh +293 -0
- package/.claude/hooks/play-tts-elevenlabs.sh +404 -0
- package/.claude/hooks/play-tts-piper.sh +338 -0
- package/.claude/hooks/play-tts.sh +100 -0
- package/.claude/hooks/provider-commands.sh +540 -0
- package/.claude/hooks/provider-manager.sh +298 -0
- package/.claude/hooks/replay-target-audio.sh +95 -0
- package/.claude/hooks/sentiment-manager.sh +201 -0
- package/.claude/hooks/speed-manager.sh +291 -0
- package/.claude/hooks/voice-manager.sh +594 -0
- package/.claude/hooks/voices-config.sh +70 -0
- package/.claude/settings.local.json +41 -0
- package/.github/ISSUE_TEMPLATE/config.yaml +4 -0
- package/.github/ISSUE_TEMPLATE/idea_submission.md +2 -2
- package/.github/workflows/{format-check.yaml → lint.yaml} +19 -1
- package/.prettierignore +2 -0
- package/CHANGELOG.md +8 -2
- package/CONTRIBUTING.md +1 -0
- package/README.md +261 -0
- package/bmad/_cfg/agent-manifest.csv +7 -0
- package/bmad/_cfg/agents/bmb-bmad-builder.customize.yaml +42 -0
- package/bmad/_cfg/agents/bmd-cli-chief.customize.yaml +32 -0
- package/bmad/_cfg/agents/bmd-doc-keeper.customize.yaml +42 -0
- package/bmad/_cfg/agents/bmd-release-chief.customize.yaml +42 -0
- package/bmad/_cfg/agents/core-bmad-master.customize.yaml +42 -0
- package/bmad/_cfg/files-manifest.csv +83 -0
- package/bmad/_cfg/manifest.yaml +12 -0
- package/bmad/_cfg/task-manifest.csv +5 -0
- package/bmad/_cfg/tool-manifest.csv +2 -0
- package/bmad/_cfg/workflow-manifest.csv +15 -0
- package/bmad/bmb/README.md +132 -0
- package/bmad/bmb/agents/bmad-builder.md +70 -0
- package/bmad/bmb/config.yaml +14 -0
- package/bmad/bmb/workflows/audit-workflow/checklist.md +143 -0
- package/bmad/bmb/workflows/audit-workflow/instructions.md +341 -0
- package/bmad/bmb/workflows/audit-workflow/template.md +118 -0
- package/bmad/bmb/workflows/audit-workflow/workflow.yaml +23 -0
- package/bmad/bmb/workflows/audit-workflow/workflow.yaml.bak +21 -0
- package/bmad/bmb/workflows/convert-legacy/README.md +262 -0
- package/bmad/bmb/workflows/convert-legacy/checklist.md +205 -0
- package/bmad/bmb/workflows/convert-legacy/instructions.md +377 -0
- package/bmad/bmb/workflows/convert-legacy/workflow.yaml +32 -0
- package/bmad/bmb/workflows/create-agent/README.md +320 -0
- package/bmad/bmb/workflows/create-agent/agent-architecture.md +419 -0
- package/bmad/bmb/workflows/create-agent/agent-architecture.md.bak +412 -0
- package/bmad/bmb/workflows/create-agent/agent-command-patterns.md +759 -0
- package/bmad/bmb/workflows/create-agent/agent-command-patterns.md.bak +759 -0
- package/bmad/bmb/workflows/create-agent/agent-types.md +292 -0
- package/bmad/bmb/workflows/create-agent/brainstorm-context.md +174 -0
- package/bmad/bmb/workflows/create-agent/checklist.md +62 -0
- package/bmad/bmb/workflows/create-agent/communication-styles.md +202 -0
- package/bmad/bmb/workflows/create-agent/instructions.md +430 -0
- package/bmad/bmb/workflows/create-agent/workflow.yaml +37 -0
- package/bmad/bmb/workflows/create-module/README.md +220 -0
- package/bmad/bmb/workflows/create-module/README.md.bak +218 -0
- package/bmad/bmb/workflows/create-module/brainstorm-context.md +137 -0
- package/bmad/bmb/workflows/create-module/checklist.md +244 -0
- package/bmad/bmb/workflows/create-module/checklist.md.bak +245 -0
- package/bmad/bmb/workflows/create-module/installer-templates/install-config.yaml +92 -0
- package/bmad/bmb/workflows/create-module/installer-templates/installer.js +231 -0
- package/bmad/bmb/workflows/create-module/installer-templates/installer.js.bak +231 -0
- package/bmad/bmb/workflows/create-module/instructions.md +581 -0
- package/bmad/bmb/workflows/create-module/instructions.md.bak +521 -0
- package/bmad/bmb/workflows/create-module/module-structure.md +366 -0
- package/bmad/bmb/workflows/create-module/module-structure.md.bak +310 -0
- package/bmad/bmb/workflows/create-module/workflow.yaml +42 -0
- package/bmad/bmb/workflows/create-module/workflow.yaml.bak +40 -0
- package/bmad/bmb/workflows/create-workflow/README.md +277 -0
- package/bmad/bmb/workflows/create-workflow/brainstorm-context.md +197 -0
- package/bmad/bmb/workflows/create-workflow/checklist.md +94 -0
- package/bmad/bmb/workflows/create-workflow/instructions.md +716 -0
- package/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md +1150 -0
- package/bmad/bmb/workflows/create-workflow/workflow-template/checklist.md +24 -0
- package/bmad/bmb/workflows/create-workflow/workflow-template/instructions.md +13 -0
- package/bmad/bmb/workflows/create-workflow/workflow-template/template.md +9 -0
- package/bmad/bmb/workflows/create-workflow/workflow-template/workflow.yaml +39 -0
- package/bmad/bmb/workflows/create-workflow/workflow-template/workflow.yaml.bak +39 -0
- package/bmad/bmb/workflows/create-workflow/workflow.yaml +40 -0
- package/bmad/bmb/workflows/create-workflow/workflow.yaml.bak +38 -0
- package/bmad/bmb/workflows/edit-agent/README.md +112 -0
- package/bmad/bmb/workflows/edit-agent/checklist.md +112 -0
- package/bmad/bmb/workflows/edit-agent/instructions.md +290 -0
- package/bmad/bmb/workflows/edit-agent/workflow.yaml +33 -0
- package/bmad/bmb/workflows/edit-module/README.md +187 -0
- package/bmad/bmb/workflows/edit-module/checklist.md +165 -0
- package/bmad/bmb/workflows/edit-module/instructions.md +339 -0
- package/bmad/bmb/workflows/edit-module/workflow.yaml +34 -0
- package/bmad/bmb/workflows/edit-workflow/README.md +119 -0
- package/bmad/bmb/workflows/edit-workflow/checklist.md +70 -0
- package/bmad/bmb/workflows/edit-workflow/instructions.md +342 -0
- package/bmad/bmb/workflows/edit-workflow/workflow.yaml +27 -0
- package/bmad/bmb/workflows/edit-workflow/workflow.yaml.bak +25 -0
- package/bmad/bmb/workflows/module-brief/README.md +264 -0
- package/bmad/bmb/workflows/module-brief/checklist.md +116 -0
- package/bmad/bmb/workflows/module-brief/instructions.md +267 -0
- package/bmad/bmb/workflows/module-brief/template.md +275 -0
- package/bmad/bmb/workflows/module-brief/workflow.yaml +29 -0
- package/bmad/bmb/workflows/module-brief/workflow.yaml.bak +27 -0
- package/bmad/bmb/workflows/redoc/README.md +87 -0
- package/bmad/bmb/workflows/redoc/checklist.md +99 -0
- package/bmad/bmb/workflows/redoc/instructions.md +265 -0
- package/bmad/bmb/workflows/redoc/workflow.yaml +32 -0
- package/bmad/bmb/workflows/redoc/workflow.yaml.bak +31 -0
- package/bmad/bmd/README.md +193 -0
- package/bmad/bmd/README.md.bak +193 -0
- package/bmad/bmd/agents/cli-chief-sidecar/instructions.md +102 -0
- package/bmad/bmd/agents/cli-chief-sidecar/instructions.md.bak +102 -0
- package/bmad/bmd/agents/cli-chief-sidecar/knowledge/README.md +68 -0
- package/bmad/bmd/agents/cli-chief-sidecar/knowledge/README.md.bak +68 -0
- package/bmad/bmd/agents/cli-chief-sidecar/knowledge/cli-reference.md +123 -0
- package/bmad/bmd/agents/cli-chief-sidecar/knowledge/cli-reference.md.bak +123 -0
- package/bmad/bmd/agents/cli-chief-sidecar/memories.md +53 -0
- package/bmad/bmd/agents/cli-chief-sidecar/memories.md.bak +53 -0
- package/bmad/bmd/agents/cli-chief.md +108 -0
- package/bmad/bmd/agents/cli-chief.md.bak +108 -0
- package/bmad/bmd/agents/doc-keeper-sidecar/instructions.md +177 -0
- package/bmad/bmd/agents/doc-keeper-sidecar/instructions.md.bak +177 -0
- package/bmad/bmd/agents/doc-keeper-sidecar/knowledge/README.md +81 -0
- package/bmad/bmd/agents/doc-keeper-sidecar/knowledge/README.md.bak +81 -0
- package/bmad/bmd/agents/doc-keeper-sidecar/memories.md +88 -0
- package/bmad/bmd/agents/doc-keeper-sidecar/memories.md.bak +88 -0
- package/bmad/bmd/agents/doc-keeper.md +115 -0
- package/bmad/bmd/agents/doc-keeper.md.bak +115 -0
- package/bmad/bmd/agents/release-chief-sidecar/instructions.md +164 -0
- package/bmad/bmd/agents/release-chief-sidecar/instructions.md.bak +164 -0
- package/bmad/bmd/agents/release-chief-sidecar/knowledge/README.md +82 -0
- package/bmad/bmd/agents/release-chief-sidecar/knowledge/README.md.bak +82 -0
- package/bmad/bmd/agents/release-chief-sidecar/memories.md +73 -0
- package/bmad/bmd/agents/release-chief-sidecar/memories.md.bak +73 -0
- package/bmad/bmd/agents/release-chief.md +109 -0
- package/bmad/bmd/agents/release-chief.md.bak +109 -0
- package/bmad/bmd/config.yaml +10 -0
- package/bmad/core/agents/bmad-master.md +71 -0
- package/bmad/core/agents/bmad-web-orchestrator.agent.xml +122 -0
- package/bmad/core/config.yaml +9 -0
- package/bmad/core/tasks/adv-elicit-methods.csv +39 -0
- package/{src/core/tasks/adv-elicit.md → bmad/core/tasks/adv-elicit.xml} +6 -11
- package/{src/core/tasks/index-docs.md → bmad/core/tasks/index-docs.xml} +6 -10
- package/{src/core/tasks/validate-workflow.md → bmad/core/tasks/validate-workflow.xml} +4 -7
- package/bmad/core/tasks/workflow.xml +174 -0
- package/bmad/core/tools/shard-doc.xml +100 -0
- package/{src/modules/cis → bmad/core}/workflows/brainstorming/README.md +2 -2
- package/{src/modules/cis → bmad/core}/workflows/brainstorming/instructions.md +26 -22
- package/{src/modules/cis → bmad/core}/workflows/brainstorming/template.md +2 -2
- package/{src/modules/cis → bmad/core}/workflows/brainstorming/workflow.yaml +16 -3
- package/bmad/core/workflows/party-mode/instructions.md +188 -0
- package/bmad/core/workflows/party-mode/workflow.yaml +23 -0
- package/bmad/docs/claude-code-instructions.md +25 -0
- package/bmad/docs/codex-instructions.md +21 -0
- package/bmd/README.md +193 -0
- package/bmd/agents/cli-chief-sidecar/instructions.md +102 -0
- package/bmd/agents/cli-chief-sidecar/knowledge/README.md +68 -0
- package/bmd/agents/cli-chief-sidecar/knowledge/cli-reference.md +123 -0
- package/bmd/agents/cli-chief-sidecar/memories.md +53 -0
- package/bmd/agents/cli-chief.agent.yaml +126 -0
- package/bmd/agents/doc-keeper-sidecar/instructions.md +177 -0
- package/bmd/agents/doc-keeper-sidecar/knowledge/README.md +81 -0
- package/bmd/agents/doc-keeper-sidecar/memories.md +88 -0
- package/bmd/agents/doc-keeper.agent.yaml +137 -0
- package/bmd/agents/release-chief-sidecar/instructions.md +164 -0
- package/bmd/agents/release-chief-sidecar/knowledge/README.md +82 -0
- package/bmd/agents/release-chief-sidecar/memories.md +73 -0
- package/bmd/agents/release-chief.agent.yaml +127 -0
- package/bmd/bmad-custom-module-installer-plan.md +1176 -0
- package/bmd/config.yaml +12 -0
- package/docs/bmad-brownfield-guide.md +1260 -0
- package/docs/conversion-report-shard-doc-2025-10-26.md +188 -0
- package/docs/ide-info/auggie.md +2 -2
- package/docs/ide-info/claude-code.md +4 -4
- package/docs/ide-info/codex.md +9 -20
- package/docs/ide-info/opencode.md +24 -0
- package/docs/installers-bundlers/ide-injections.md +0 -10
- package/docs/installers-bundlers/installers-modules-platforms-reference.md +22 -50
- package/docs/v4-to-v6-upgrade.md +225 -0
- package/eslint.config.mjs +4 -2
- package/package.json +11 -6
- package/src/core/_module-installer/{install-menu-config.yaml → install-config.yaml} +8 -4
- package/src/core/_module-installer/installer.js +1 -1
- package/src/core/agents/bmad-master.agent.yaml +39 -0
- package/src/core/agents/bmad-web-orchestrator.agent.xml +122 -0
- package/src/core/tasks/adv-elicit.xml +104 -0
- package/src/core/tasks/index-docs.xml +65 -0
- package/src/core/tasks/validate-workflow.xml +89 -0
- package/src/core/tasks/{workflow.md → workflow.xml} +42 -17
- package/src/core/tools/shard-doc.xml +100 -0
- package/src/core/workflows/brainstorming/README.md +271 -0
- package/src/core/workflows/brainstorming/brain-methods.csv +36 -0
- package/src/core/workflows/brainstorming/instructions.md +314 -0
- package/src/core/workflows/brainstorming/template.md +102 -0
- package/src/core/workflows/brainstorming/workflow.yaml +43 -0
- package/src/core/workflows/party-mode/instructions.md +30 -23
- package/src/core/workflows/party-mode/workflow.yaml +7 -8
- package/src/modules/bmb/README.md +132 -0
- package/src/modules/bmb/_module-installer/install-config.yaml +26 -0
- package/src/modules/bmb/agents/bmad-builder.agent.yaml +58 -0
- package/src/modules/bmb/workflows/audit-workflow/checklist.md +143 -0
- package/src/modules/bmb/workflows/audit-workflow/instructions.md +341 -0
- package/src/modules/bmb/workflows/audit-workflow/template.md +118 -0
- package/src/modules/bmb/workflows/audit-workflow/workflow.yaml +25 -0
- package/src/modules/bmb/workflows/convert-legacy/README.md +32 -32
- package/src/modules/bmb/workflows/convert-legacy/checklist.md +21 -20
- package/src/modules/bmb/workflows/convert-legacy/instructions.md +130 -81
- package/src/modules/bmb/workflows/convert-legacy/workflow.yaml +7 -8
- package/src/modules/bmb/workflows/create-agent/README.md +96 -44
- package/src/modules/bmb/workflows/create-agent/agent-architecture.md +58 -51
- package/src/modules/bmb/workflows/create-agent/agent-command-patterns.md +153 -151
- package/src/modules/bmb/workflows/create-agent/agent-types.md +137 -22
- package/src/modules/bmb/workflows/create-agent/brainstorm-context.md +4 -4
- package/src/modules/bmb/workflows/create-agent/checklist.md +30 -102
- package/src/modules/bmb/workflows/create-agent/communication-styles.md +22 -60
- package/src/modules/bmb/workflows/create-agent/instructions.md +309 -219
- package/src/modules/bmb/workflows/create-agent/workflow.yaml +24 -14
- package/src/modules/bmb/workflows/create-module/README.md +23 -21
- package/src/modules/bmb/workflows/create-module/brainstorm-context.md +1 -1
- package/src/modules/bmb/workflows/create-module/checklist.md +20 -21
- package/src/modules/bmb/workflows/create-module/installer-templates/install-config.yaml +92 -0
- package/src/modules/bmb/workflows/create-module/installer-templates/installer.js +1 -1
- package/src/modules/bmb/workflows/create-module/instructions.md +309 -237
- package/src/modules/bmb/workflows/create-module/module-structure.md +104 -48
- package/src/modules/bmb/workflows/create-module/workflow.yaml +14 -17
- package/src/modules/bmb/workflows/create-workflow/README.md +68 -7
- package/src/modules/bmb/workflows/create-workflow/brainstorm-context.md +4 -4
- package/src/modules/bmb/workflows/create-workflow/checklist.md +22 -0
- package/src/modules/bmb/workflows/create-workflow/instructions.md +496 -47
- package/src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md +753 -59
- package/src/modules/bmb/workflows/create-workflow/workflow-template/instructions.md +4 -3
- package/src/modules/bmb/workflows/create-workflow/workflow-template/workflow.yaml +30 -0
- package/src/modules/bmb/workflows/create-workflow/workflow.yaml +11 -11
- package/src/modules/bmb/workflows/edit-agent/README.md +112 -0
- package/src/modules/bmb/workflows/edit-agent/checklist.md +112 -0
- package/src/modules/bmb/workflows/edit-agent/instructions.md +290 -0
- package/src/modules/bmb/workflows/edit-agent/workflow.yaml +35 -0
- package/src/modules/bmb/workflows/edit-module/README.md +187 -0
- package/src/modules/bmb/workflows/edit-module/checklist.md +165 -0
- package/src/modules/bmb/workflows/edit-module/instructions.md +339 -0
- package/src/modules/bmb/workflows/edit-module/workflow.yaml +36 -0
- package/src/modules/bmb/workflows/edit-workflow/README.md +58 -2
- package/src/modules/bmb/workflows/edit-workflow/instructions.md +289 -117
- package/src/modules/bmb/workflows/edit-workflow/workflow.yaml +5 -10
- package/src/modules/bmb/workflows/module-brief/README.md +16 -16
- package/src/modules/bmb/workflows/module-brief/checklist.md +4 -4
- package/src/modules/bmb/workflows/module-brief/instructions.md +9 -7
- package/src/modules/bmb/workflows/module-brief/template.md +9 -9
- package/src/modules/bmb/workflows/module-brief/workflow.yaml +5 -4
- package/src/modules/bmb/workflows/redoc/checklist.md +2 -2
- package/src/modules/bmb/workflows/redoc/instructions.md +20 -10
- package/src/modules/bmb/workflows/redoc/workflow.yaml +5 -4
- package/src/modules/bmm/README.md +141 -0
- package/src/modules/bmm/_module-installer/install-config.yaml +74 -0
- package/src/modules/bmm/_module-installer/installer.js +1 -1
- package/src/modules/bmm/_module-installer/platform-specifics/claude-code.js +1 -1
- package/src/modules/bmm/_module-installer/platform-specifics/windsurf.js +1 -1
- package/src/modules/bmm/agents/analyst.agent.yaml +43 -0
- package/src/modules/bmm/agents/architect.agent.yaml +41 -0
- package/src/modules/bmm/agents/dev.agent.yaml +43 -0
- package/src/modules/bmm/agents/game-architect.agent.yaml +35 -0
- package/src/modules/bmm/agents/game-designer.agent.yaml +47 -0
- package/src/modules/bmm/agents/game-dev.agent.yaml +39 -0
- package/src/modules/bmm/agents/pm.agent.yaml +50 -0
- package/src/modules/bmm/agents/sm.agent.yaml +67 -0
- package/src/modules/bmm/agents/tea.agent.yaml +59 -0
- package/src/modules/bmm/agents/ux-designer.agent.yaml +33 -0
- package/src/modules/bmm/sub-modules/claude-code/injections.yaml +1 -1
- package/src/modules/bmm/sub-modules/claude-code/readme.md +1 -1
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{api-documenter.md → bmad-analysis/api-documenter.md} +17 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{codebase-analyzer.md → bmad-analysis/codebase-analyzer.md} +19 -1
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{data-analyst.md → bmad-analysis/data-analyst.md} +17 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{pattern-detector.md → bmad-analysis/pattern-detector.md} +17 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{dependency-mapper.md → bmad-planning/dependency-mapper.md} +16 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{epic-optimizer.md → bmad-planning/epic-optimizer.md} +15 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{technical-decisions-curator.md → bmad-planning/technical-decisions-curator.md} +24 -2
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{trend-spotter.md → bmad-planning/trend-spotter.md} +16 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{user-journey-mapper.md → bmad-planning/user-journey-mapper.md} +22 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{user-researcher.md → bmad-planning/user-researcher.md} +16 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{market-researcher.md → bmad-research/market-researcher.md} +17 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{tech-debt-auditor.md → bmad-research/tech-debt-auditor.md} +17 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{document-reviewer.md → bmad-review/document-reviewer.md} +17 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{technical-evaluator.md → bmad-review/technical-evaluator.md} +17 -0
- package/src/modules/bmm/sub-modules/claude-code/sub-agents/{test-coverage-analyzer.md → bmad-review/test-coverage-analyzer.md} +17 -0
- package/src/modules/bmm/tasks/{daily-standup.md → daily-standup.xml} +21 -27
- package/src/modules/bmm/tasks/{retrospective.md → retrospective.xml} +22 -28
- package/src/modules/bmm/teams/team-fullstack.yaml +11 -0
- package/src/modules/bmm/teams/team-gamedev.yaml +5 -0
- package/src/modules/bmm/testarch/README.md +311 -0
- package/src/modules/bmm/testarch/knowledge/ci-burn-in.md +675 -0
- package/src/modules/bmm/testarch/knowledge/component-tdd.md +486 -0
- package/src/modules/bmm/testarch/knowledge/contract-testing.md +957 -0
- package/src/modules/bmm/testarch/knowledge/data-factories.md +500 -0
- package/src/modules/bmm/testarch/knowledge/email-auth.md +721 -0
- package/src/modules/bmm/testarch/knowledge/error-handling.md +725 -0
- package/src/modules/bmm/testarch/knowledge/feature-flags.md +750 -0
- package/src/modules/bmm/testarch/knowledge/fixture-architecture.md +401 -0
- package/src/modules/bmm/testarch/knowledge/network-first.md +486 -0
- package/src/modules/bmm/testarch/knowledge/nfr-criteria.md +670 -0
- package/src/modules/bmm/testarch/knowledge/playwright-config.md +730 -0
- package/src/modules/bmm/testarch/knowledge/probability-impact.md +601 -0
- package/src/modules/bmm/testarch/knowledge/risk-governance.md +615 -0
- package/src/modules/bmm/testarch/knowledge/selective-testing.md +732 -0
- package/src/modules/bmm/testarch/knowledge/selector-resilience.md +527 -0
- package/src/modules/bmm/testarch/knowledge/test-healing-patterns.md +644 -0
- package/src/modules/bmm/testarch/knowledge/test-levels-framework.md +473 -0
- package/src/modules/bmm/testarch/knowledge/test-priorities-matrix.md +373 -0
- package/src/modules/bmm/testarch/knowledge/test-quality.md +664 -0
- package/src/modules/bmm/testarch/knowledge/timing-debugging.md +372 -0
- package/src/modules/bmm/testarch/knowledge/visual-debugging.md +524 -0
- package/src/modules/bmm/testarch/tea-index.csv +22 -0
- package/src/modules/bmm/workflows/1-analysis/brainstorm-game/README.md +38 -0
- package/src/modules/bmm/workflows/1-analysis/brainstorm-game/game-context.md +3 -3
- package/src/modules/bmm/workflows/1-analysis/brainstorm-game/instructions.md +74 -12
- package/src/modules/bmm/workflows/1-analysis/brainstorm-game/workflow.yaml +22 -3
- package/src/modules/bmm/workflows/1-analysis/brainstorm-project/README.md +29 -0
- package/src/modules/bmm/workflows/1-analysis/brainstorm-project/instructions.md +61 -8
- package/src/modules/bmm/workflows/1-analysis/brainstorm-project/project-context.md +4 -4
- package/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml +21 -3
- package/src/modules/bmm/workflows/1-analysis/game-brief/README.md +5 -5
- package/src/modules/bmm/workflows/1-analysis/game-brief/checklist.md +2 -2
- package/src/modules/bmm/workflows/1-analysis/game-brief/instructions.md +151 -311
- package/src/modules/bmm/workflows/1-analysis/game-brief/template.md +2 -2
- package/src/modules/bmm/workflows/1-analysis/game-brief/workflow.yaml +16 -6
- package/src/modules/bmm/workflows/1-analysis/product-brief/README.md +4 -4
- package/src/modules/bmm/workflows/1-analysis/product-brief/checklist.md +2 -2
- package/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md +147 -179
- package/src/modules/bmm/workflows/1-analysis/product-brief/template.md +4 -4
- package/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml +16 -6
- package/src/modules/bmm/workflows/1-analysis/research/README.md +3 -3
- package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-competitor-analyzer.md +1 -1
- package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-market-researcher.md +2 -2
- package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-trend-spotter.md +2 -2
- package/src/modules/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +80 -17
- package/src/modules/bmm/workflows/1-analysis/research/instructions-market.md +71 -11
- package/src/modules/bmm/workflows/1-analysis/research/instructions-router.md +72 -38
- package/src/modules/bmm/workflows/1-analysis/research/instructions-technical.md +73 -14
- package/src/modules/bmm/workflows/1-analysis/research/template-deep-prompt.md +1 -1
- package/src/modules/bmm/workflows/1-analysis/research/template-market.md +1 -1
- package/src/modules/bmm/workflows/1-analysis/research/workflow.yaml +21 -121
- package/src/modules/bmm/workflows/2-plan-workflows/README.md +258 -0
- package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/checklist.md +310 -0
- package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +1283 -0
- package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +145 -0
- package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +42 -0
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/README.md +16 -16
- package/src/modules/bmm/workflows/2-plan-workflows/gdd/checklist.md +148 -0
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/action-platformer.md +1 -1
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/adventure.md +1 -1
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/card-game.md +2 -2
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/fighting.md +1 -1
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/horror.md +2 -2
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/idle-incremental.md +1 -1
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/moba.md +4 -4
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/party-game.md +1 -1
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/racing.md +3 -3
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/rhythm.md +1 -1
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/roguelike.md +2 -2
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/rpg.md +3 -3
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/sandbox.md +4 -4
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/shooter.md +3 -3
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/simulation.md +3 -3
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/sports.md +3 -3
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/strategy.md +3 -3
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/survival.md +2 -2
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/text-based.md +3 -3
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/tower-defense.md +5 -5
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/turn-based-tactics.md +4 -4
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/visual-novel.md +1 -1
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/gdd-template.md +6 -12
- package/src/modules/bmm/workflows/2-plan-workflows/gdd/instructions-gdd.md +475 -0
- package/src/modules/bmm/workflows/2-plan-workflows/gdd/workflow.yaml +67 -0
- package/src/modules/bmm/workflows/2-plan-workflows/narrative/checklist.md +139 -0
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/narrative/instructions-narrative.md +52 -12
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/narrative/narrative-template.md +8 -8
- package/src/modules/bmm/workflows/2-plan-workflows/narrative/workflow.yaml +38 -0
- package/src/modules/bmm/workflows/2-plan-workflows/prd/checklist.md +117 -0
- package/src/modules/bmm/workflows/2-plan-workflows/prd/epics-template.md +63 -0
- package/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md +449 -0
- package/src/modules/bmm/workflows/2-plan-workflows/prd/prd-template.md +62 -0
- package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml +46 -0
- package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +107 -0
- package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +11 -0
- package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level0-story.md +167 -0
- package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level1-stories.md +278 -0
- package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +269 -0
- package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/tech-spec/tech-spec-template.md +0 -4
- package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +56 -0
- package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +52 -0
- package/src/modules/bmm/workflows/3-solutioning/README.md +1 -565
- package/src/modules/bmm/workflows/3-solutioning/architecture/architecture-patterns.yaml +347 -0
- package/src/modules/bmm/workflows/3-solutioning/architecture/architecture-template.md +103 -0
- package/src/modules/bmm/workflows/3-solutioning/architecture/checklist.md +244 -0
- package/src/modules/bmm/workflows/3-solutioning/architecture/decision-catalog.yaml +222 -0
- package/src/modules/bmm/workflows/3-solutioning/architecture/instructions.md +703 -0
- package/src/modules/bmm/workflows/3-solutioning/architecture/pattern-categories.csv +13 -0
- package/src/modules/bmm/workflows/3-solutioning/architecture/readme.md +318 -0
- package/src/modules/bmm/workflows/3-solutioning/architecture/workflow.yaml +54 -0
- package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/README.md +177 -0
- package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/checklist.md +175 -0
- package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +273 -0
- package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/template.md +146 -0
- package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/validation-criteria.yaml +189 -0
- package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +40 -0
- package/src/modules/bmm/workflows/4-implementation/README.md +221 -0
- package/src/modules/bmm/workflows/4-implementation/{review-story → code-review}/README.md +4 -7
- package/src/modules/bmm/workflows/4-implementation/code-review/instructions.md +391 -0
- package/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml +56 -0
- package/src/modules/bmm/workflows/4-implementation/correct-course/README.md +73 -0
- package/src/modules/bmm/workflows/4-implementation/correct-course/checklist.md +5 -5
- package/src/modules/bmm/workflows/4-implementation/correct-course/instructions.md +64 -53
- package/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml +10 -0
- package/src/modules/bmm/workflows/4-implementation/create-story/README.md +117 -30
- package/src/modules/bmm/workflows/4-implementation/create-story/checklist.md +240 -39
- package/src/modules/bmm/workflows/4-implementation/create-story/instructions.md +193 -22
- package/src/modules/bmm/workflows/4-implementation/create-story/template.md +2 -8
- package/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml +11 -34
- package/src/modules/bmm/workflows/4-implementation/dev-story/AUDIT-REPORT.md +367 -0
- package/src/modules/bmm/workflows/4-implementation/dev-story/README.md +189 -67
- package/src/modules/bmm/workflows/4-implementation/dev-story/checklist.md +1 -1
- package/src/modules/bmm/workflows/4-implementation/dev-story/instructions.md +215 -40
- package/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml +12 -37
- package/src/modules/bmm/workflows/{3-solutioning/tech-spec → 4-implementation/epic-tech-context}/README.md +6 -6
- package/src/modules/bmm/workflows/{3-solutioning/tech-spec → 4-implementation/epic-tech-context}/checklist.md +1 -1
- package/src/modules/bmm/workflows/4-implementation/epic-tech-context/instructions.md +160 -0
- package/src/modules/bmm/workflows/{3-solutioning/tech-spec → 4-implementation/epic-tech-context}/template.md +1 -1
- package/src/modules/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +34 -0
- package/src/modules/bmm/workflows/4-implementation/retrospective/README.md +77 -0
- package/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +236 -148
- package/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml +8 -4
- package/src/modules/bmm/workflows/4-implementation/sprint-planning/README.md +156 -0
- package/src/modules/bmm/workflows/4-implementation/sprint-planning/checklist.md +33 -0
- package/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md +221 -0
- package/src/modules/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -0
- package/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +41 -0
- package/src/modules/bmm/workflows/4-implementation/story-context/README.md +1 -1
- package/src/modules/bmm/workflows/4-implementation/story-context/instructions.md +146 -21
- package/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml +8 -32
- package/src/modules/bmm/workflows/4-implementation/story-done/instructions.md +111 -0
- package/src/modules/bmm/workflows/4-implementation/story-done/workflow.yaml +27 -0
- package/src/modules/bmm/workflows/4-implementation/story-ready/instructions.md +117 -0
- package/src/modules/bmm/workflows/4-implementation/story-ready/workflow.yaml +27 -0
- package/src/modules/bmm/workflows/README.md +577 -0
- package/src/modules/bmm/workflows/document-project/README.md +444 -0
- package/src/modules/bmm/workflows/document-project/checklist.md +245 -0
- package/src/modules/bmm/workflows/document-project/documentation-requirements.csv +12 -0
- package/src/modules/bmm/workflows/document-project/instructions.md +222 -0
- package/src/modules/bmm/workflows/document-project/templates/README.md +38 -0
- package/src/modules/bmm/workflows/document-project/templates/deep-dive-template.md +345 -0
- package/src/modules/bmm/workflows/document-project/templates/index-template.md +169 -0
- package/src/modules/bmm/workflows/document-project/templates/project-overview-template.md +103 -0
- package/src/modules/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -0
- package/src/modules/bmm/workflows/document-project/templates/source-tree-template.md +135 -0
- package/src/modules/bmm/workflows/document-project/workflow.yaml +36 -0
- package/src/modules/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -0
- package/src/modules/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -0
- package/src/modules/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -0
- package/src/modules/bmm/workflows/document-project/workflows/full-scan.yaml +31 -0
- package/src/modules/bmm/workflows/testarch/README.md +26 -0
- package/src/modules/bmm/workflows/testarch/atdd/README.md +672 -0
- package/src/modules/bmm/workflows/testarch/atdd/atdd-checklist-template.md +363 -0
- package/src/modules/bmm/workflows/testarch/atdd/checklist.md +373 -0
- package/src/modules/bmm/workflows/testarch/atdd/instructions.md +785 -0
- package/src/modules/bmm/workflows/testarch/atdd/workflow.yaml +54 -0
- package/src/modules/bmm/workflows/testarch/automate/README.md +869 -0
- package/src/modules/bmm/workflows/testarch/automate/checklist.md +580 -0
- package/src/modules/bmm/workflows/testarch/automate/instructions.md +1303 -0
- package/src/modules/bmm/workflows/testarch/automate/workflow.yaml +63 -0
- package/src/modules/bmm/workflows/testarch/ci/README.md +493 -0
- package/src/modules/bmm/workflows/testarch/ci/checklist.md +246 -0
- package/src/modules/bmm/workflows/testarch/ci/github-actions-template.yaml +165 -0
- package/src/modules/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +128 -0
- package/src/modules/bmm/workflows/testarch/ci/instructions.md +517 -0
- package/src/modules/bmm/workflows/testarch/ci/workflow.yaml +55 -0
- package/src/modules/bmm/workflows/testarch/framework/README.md +340 -0
- package/src/modules/bmm/workflows/testarch/framework/checklist.md +321 -0
- package/src/modules/bmm/workflows/testarch/framework/instructions.md +455 -0
- package/src/modules/bmm/workflows/testarch/framework/workflow.yaml +55 -0
- package/src/modules/bmm/workflows/testarch/nfr-assess/README.md +469 -0
- package/src/modules/bmm/workflows/testarch/nfr-assess/checklist.md +405 -0
- package/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md +722 -0
- package/src/modules/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +443 -0
- package/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml +58 -0
- package/src/modules/bmm/workflows/testarch/test-design/README.md +493 -0
- package/src/modules/bmm/workflows/testarch/test-design/checklist.md +234 -0
- package/src/modules/bmm/workflows/testarch/test-design/instructions.md +621 -0
- package/src/modules/bmm/workflows/testarch/test-design/test-design-template.md +285 -0
- package/src/modules/bmm/workflows/testarch/test-design/workflow.yaml +54 -0
- package/src/modules/bmm/workflows/testarch/test-review/README.md +775 -0
- package/src/modules/bmm/workflows/testarch/test-review/checklist.md +470 -0
- package/src/modules/bmm/workflows/testarch/test-review/instructions.md +608 -0
- package/src/modules/bmm/workflows/testarch/test-review/test-review-template.md +388 -0
- package/src/modules/bmm/workflows/testarch/test-review/workflow.yaml +55 -0
- package/src/modules/bmm/workflows/testarch/trace/README.md +802 -0
- package/src/modules/bmm/workflows/testarch/trace/checklist.md +654 -0
- package/src/modules/bmm/workflows/testarch/trace/instructions.md +1045 -0
- package/src/modules/bmm/workflows/testarch/trace/trace-template.md +673 -0
- package/src/modules/bmm/workflows/testarch/trace/workflow.yaml +68 -0
- package/src/modules/bmm/workflows/workflow-status/README.md +241 -0
- package/src/modules/bmm/workflows/workflow-status/init/instructions.md +297 -0
- package/src/modules/bmm/workflows/workflow-status/init/workflow.yaml +28 -0
- package/src/modules/bmm/workflows/workflow-status/instructions.md +324 -0
- package/src/modules/bmm/workflows/workflow-status/paths/brownfield-level-0.yaml +54 -0
- package/src/modules/bmm/workflows/workflow-status/paths/brownfield-level-1.yaml +58 -0
- package/src/modules/bmm/workflows/workflow-status/paths/brownfield-level-2.yaml +76 -0
- package/src/modules/bmm/workflows/workflow-status/paths/brownfield-level-3.yaml +95 -0
- package/src/modules/bmm/workflows/workflow-status/paths/brownfield-level-4.yaml +88 -0
- package/src/modules/bmm/workflows/workflow-status/paths/game-design.yaml +75 -0
- package/src/modules/bmm/workflows/workflow-status/paths/greenfield-level-0.yaml +45 -0
- package/src/modules/bmm/workflows/workflow-status/paths/greenfield-level-1.yaml +49 -0
- package/src/modules/bmm/workflows/workflow-status/paths/greenfield-level-2.yaml +78 -0
- package/src/modules/bmm/workflows/workflow-status/paths/greenfield-level-3.yaml +73 -0
- package/src/modules/bmm/workflows/workflow-status/paths/greenfield-level-4.yaml +75 -0
- package/src/modules/bmm/workflows/workflow-status/project-levels.yaml +59 -0
- package/src/modules/bmm/workflows/workflow-status/workflow-status-template.md +30 -0
- package/src/modules/bmm/workflows/workflow-status/workflow.yaml +30 -0
- package/src/modules/cis/_module-installer/installer.js +1 -1
- package/src/modules/cis/agents/brainstorming-coach.agent.yaml +23 -0
- package/src/modules/cis/agents/creative-problem-solver.agent.yaml +23 -0
- package/src/modules/cis/agents/design-thinking-coach.agent.yaml +23 -0
- package/src/modules/cis/agents/innovation-strategist.agent.yaml +23 -0
- package/src/modules/cis/agents/storyteller.agent.yaml +23 -0
- package/src/modules/cis/workflows/design-thinking/design-methods.csv +1 -1
- package/src/modules/cis/workflows/design-thinking/instructions.md +1 -1
- package/src/modules/cis/workflows/design-thinking/workflow.yaml +14 -0
- package/src/modules/cis/workflows/innovation-strategy/innovation-frameworks.csv +2 -2
- package/src/modules/cis/workflows/innovation-strategy/instructions.md +1 -1
- package/src/modules/cis/workflows/innovation-strategy/template.md +4 -4
- package/src/modules/cis/workflows/innovation-strategy/workflow.yaml +14 -0
- package/src/modules/cis/workflows/problem-solving/instructions.md +1 -1
- package/src/modules/cis/workflows/problem-solving/solving-methods.csv +6 -6
- package/src/modules/cis/workflows/problem-solving/template.md +3 -3
- package/src/modules/cis/workflows/problem-solving/workflow.yaml +14 -0
- package/src/modules/cis/workflows/storytelling/instructions.md +35 -27
- package/src/modules/cis/workflows/storytelling/template.md +2 -2
- package/src/modules/cis/workflows/storytelling/workflow.yaml +14 -0
- package/src/utility/models/agent-activation-ide.xml +3 -3
- package/src/utility/models/agent-activation-web.xml +60 -0
- package/src/utility/models/agent-in-team-activation.xml +3 -0
- package/src/utility/models/fragments/activation-rules.xml +8 -0
- package/src/utility/models/fragments/activation-steps.xml +15 -0
- package/src/utility/models/fragments/handler-action.xml +4 -0
- package/src/utility/models/fragments/handler-data.xml +5 -0
- package/src/utility/models/fragments/handler-exec.xml +5 -0
- package/src/utility/models/fragments/handler-tmpl.xml +5 -0
- package/src/utility/models/fragments/handler-validate-workflow.xml +7 -0
- package/src/utility/models/fragments/handler-workflow.xml +9 -0
- package/src/utility/models/fragments/menu-handlers.xml +6 -0
- package/src/utility/models/fragments/web-bundle-activation-steps.xml +32 -0
- package/src/utility/templates/agent.customize.template.yaml +42 -0
- package/test/README.md +295 -0
- package/test/fixtures/agent-schema/invalid/critical-actions/actions-as-string.agent.yaml +26 -0
- package/test/fixtures/agent-schema/invalid/critical-actions/empty-string-in-actions.agent.yaml +29 -0
- package/test/fixtures/agent-schema/invalid/menu/empty-menu.agent.yaml +21 -0
- package/test/fixtures/agent-schema/invalid/menu/missing-menu.agent.yaml +19 -0
- package/test/fixtures/agent-schema/invalid/menu-commands/empty-command-target.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/menu-commands/no-command-target.agent.yaml +23 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/camel-case.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/duplicate-triggers.agent.yaml +30 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/empty-trigger.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/leading-asterisk.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/snake-case.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/trigger-with-spaces.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/metadata/core-agent-with-module.agent.yaml +26 -0
- package/test/fixtures/agent-schema/invalid/metadata/empty-module-string.agent.yaml +26 -0
- package/test/fixtures/agent-schema/invalid/metadata/empty-name.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/metadata/extra-metadata-fields.agent.yaml +26 -0
- package/test/fixtures/agent-schema/invalid/metadata/missing-id.agent.yaml +23 -0
- package/test/fixtures/agent-schema/invalid/metadata/module-agent-missing-module.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/metadata/wrong-module-value.agent.yaml +26 -0
- package/test/fixtures/agent-schema/invalid/persona/empty-principles-array.agent.yaml +23 -0
- package/test/fixtures/agent-schema/invalid/persona/empty-string-in-principles.agent.yaml +26 -0
- package/test/fixtures/agent-schema/invalid/persona/extra-persona-fields.agent.yaml +26 -0
- package/test/fixtures/agent-schema/invalid/persona/missing-role.agent.yaml +23 -0
- package/test/fixtures/agent-schema/invalid/persona/principles-as-string.agent.yaml +23 -0
- package/test/fixtures/agent-schema/invalid/prompts/empty-content.agent.yaml +28 -0
- package/test/fixtures/agent-schema/invalid/prompts/extra-prompt-fields.agent.yaml +30 -0
- package/test/fixtures/agent-schema/invalid/prompts/missing-content.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/prompts/missing-id.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/top-level/empty-file.agent.yaml +5 -0
- package/test/fixtures/agent-schema/invalid/top-level/extra-top-level-keys.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/top-level/missing-agent-key.agent.yaml +11 -0
- package/test/fixtures/agent-schema/invalid/yaml-errors/invalid-indentation.agent.yaml +19 -0
- package/test/fixtures/agent-schema/invalid/yaml-errors/malformed-yaml.agent.yaml +18 -0
- package/test/fixtures/agent-schema/valid/critical-actions/empty-critical-actions.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/critical-actions/no-critical-actions.agent.yaml +21 -0
- package/test/fixtures/agent-schema/valid/critical-actions/valid-critical-actions.agent.yaml +26 -0
- package/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml +30 -0
- package/test/fixtures/agent-schema/valid/menu/single-menu-item.agent.yaml +21 -0
- package/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml +39 -0
- package/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/menu-triggers/kebab-case-triggers.agent.yaml +33 -0
- package/test/fixtures/agent-schema/valid/metadata/empty-module-name-in-path.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/metadata/malformed-path-treated-as-core.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/metadata/module-agent-correct.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/persona/complete-persona.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/prompts/empty-prompts.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/prompts/no-prompts.agent.yaml +21 -0
- package/test/fixtures/agent-schema/valid/prompts/valid-prompts-minimal.agent.yaml +27 -0
- package/test/fixtures/agent-schema/valid/prompts/valid-prompts-with-description.agent.yaml +29 -0
- package/test/fixtures/agent-schema/valid/top-level/minimal-core-agent.agent.yaml +23 -0
- package/test/test-agent-schema.js +387 -0
- package/test/test-cli-integration.sh +159 -0
- package/test/unit-test-schema.js +133 -0
- package/tools/bmad-npx-wrapper.js +126 -0
- package/tools/cli/README.md +590 -0
- package/tools/cli/bmad-cli.js +0 -2
- package/tools/cli/bundlers/bundle-web.js +24 -2
- package/tools/cli/bundlers/test-bundler.js +1 -1
- package/tools/cli/bundlers/web-bundler.js +639 -40
- package/tools/cli/commands/build.js +458 -0
- package/tools/cli/commands/install.js +49 -8
- package/tools/cli/installers/lib/core/config-collector.js +222 -15
- package/tools/cli/installers/lib/core/dependency-resolver.js +5 -1
- package/tools/cli/installers/lib/core/detector.js +80 -14
- package/tools/cli/installers/lib/core/ide-config-manager.js +152 -0
- package/tools/cli/installers/lib/core/installer.js +1175 -150
- package/tools/cli/installers/lib/core/manifest-generator.js +454 -63
- package/tools/cli/installers/lib/core/manifest.js +95 -43
- package/tools/cli/installers/lib/ide/_base-ide.js +311 -20
- package/tools/cli/installers/lib/ide/auggie.js +92 -27
- package/tools/cli/installers/lib/ide/claude-code.js +132 -308
- package/tools/cli/installers/lib/ide/cline.js +149 -227
- package/tools/cli/installers/lib/ide/codex.js +141 -174
- package/tools/cli/installers/lib/ide/crush.js +109 -37
- package/tools/cli/installers/lib/ide/cursor.js +81 -13
- package/tools/cli/installers/lib/ide/gemini.js +24 -28
- package/tools/cli/installers/lib/ide/github-copilot.js +15 -14
- package/tools/cli/installers/lib/ide/manager.js +26 -35
- package/tools/cli/installers/lib/ide/opencode.js +213 -0
- package/tools/cli/installers/lib/ide/qwen.js +172 -70
- package/tools/cli/installers/lib/ide/shared/bmad-artifacts.js +143 -0
- package/tools/cli/installers/lib/ide/shared/module-injections.js +133 -0
- package/tools/cli/installers/lib/ide/task-tool-command-generator.js +119 -0
- package/tools/cli/installers/lib/ide/trae.js +120 -24
- package/tools/cli/installers/lib/ide/windsurf.js +88 -36
- package/tools/cli/installers/lib/ide/workflow-command-generator.js +119 -46
- package/tools/cli/installers/lib/ide/workflow-command-template.md +7 -3
- package/tools/cli/installers/lib/modules/manager.js +123 -7
- package/tools/cli/lib/activation-builder.js +168 -0
- package/tools/cli/lib/agent-analyzer.js +81 -0
- package/tools/cli/lib/agent-party-generator.js +3 -3
- package/tools/cli/lib/ui.js +78 -3
- package/tools/cli/lib/xml-handler.js +46 -1
- package/tools/cli/lib/yaml-xml-builder.js +439 -0
- package/tools/cli/regenerate-manifests.js +1 -1
- package/tools/cli/test-yaml-builder.js +43 -0
- package/tools/format-workflow-md.js +263 -0
- package/tools/platform-codes.yaml +6 -0
- package/tools/schema/agent.js +231 -0
- package/tools/validate-agent-schema.js +110 -0
- package/v6-open-items.md +23 -0
- package/docs/codebase-flattener.md +0 -19
- package/readme.md +0 -216
- package/src/core/agents/bmad-master.md +0 -27
- package/src/core/agents/bmad-web-orchestrator.md +0 -71
- package/src/core/tasks/shard-doc.md +0 -57
- package/src/core/workflows/bmad-init/instructions.md +0 -79
- package/src/core/workflows/bmad-init/workflow.yaml +0 -24
- package/src/modules/bmb/_module-installer/install-menu-config.yaml +0 -16
- package/src/modules/bmb/agents/bmad-builder.md +0 -30
- package/src/modules/bmb/workflows/create-module/installer-templates/install-module-config.yaml +0 -132
- package/src/modules/bmm/_module-installer/install-menu-config.yaml +0 -49
- package/src/modules/bmm/agents/analyst.md +0 -26
- package/src/modules/bmm/agents/architect.md +0 -29
- package/src/modules/bmm/agents/dev.md +0 -61
- package/src/modules/bmm/agents/game-architect.md +0 -26
- package/src/modules/bmm/agents/game-designer.md +0 -27
- package/src/modules/bmm/agents/game-dev.md +0 -28
- package/src/modules/bmm/agents/pm.md +0 -26
- package/src/modules/bmm/agents/po.md +0 -25
- package/src/modules/bmm/agents/sm.md +0 -29
- package/src/modules/bmm/agents/tea.md +0 -32
- package/src/modules/bmm/agents/ux-expert.md +0 -24
- package/src/modules/bmm/teams/team-all.yaml +0 -7
- package/src/modules/bmm/teams/team-dev.yaml +0 -14
- package/src/modules/bmm/testarch/atdd.md +0 -40
- package/src/modules/bmm/testarch/automate.md +0 -38
- package/src/modules/bmm/testarch/ci.md +0 -39
- package/src/modules/bmm/testarch/framework.md +0 -41
- package/src/modules/bmm/testarch/nfr-assess.md +0 -38
- package/src/modules/bmm/testarch/risk-profile.md +0 -38
- package/src/modules/bmm/testarch/tea-commands.csv +0 -11
- package/src/modules/bmm/testarch/tea-gate.md +0 -38
- package/src/modules/bmm/testarch/tea-knowledge.md +0 -275
- package/src/modules/bmm/testarch/test-design.md +0 -39
- package/src/modules/bmm/testarch/test-levels-framework.md +0 -148
- package/src/modules/bmm/testarch/test-priorities-matrix.md +0 -174
- package/src/modules/bmm/testarch/trace-requirements.md +0 -38
- package/src/modules/bmm/workflows/2-plan/README.md +0 -203
- package/src/modules/bmm/workflows/2-plan/checklist.md +0 -369
- package/src/modules/bmm/workflows/2-plan/gdd/instructions-gdd.md +0 -480
- package/src/modules/bmm/workflows/2-plan/instructions-router.md +0 -222
- package/src/modules/bmm/workflows/2-plan/prd/analysis-template.md +0 -53
- package/src/modules/bmm/workflows/2-plan/prd/epics-template.md +0 -18
- package/src/modules/bmm/workflows/2-plan/prd/instructions-lg.md +0 -267
- package/src/modules/bmm/workflows/2-plan/prd/instructions-med.md +0 -251
- package/src/modules/bmm/workflows/2-plan/prd/prd-template.md +0 -73
- package/src/modules/bmm/workflows/2-plan/tech-spec/instructions-sm.md +0 -137
- package/src/modules/bmm/workflows/2-plan/ux/instructions-ux.md +0 -360
- package/src/modules/bmm/workflows/2-plan/ux/ux-spec-template.md +0 -162
- package/src/modules/bmm/workflows/2-plan/workflow.yaml +0 -60
- package/src/modules/bmm/workflows/3-solutioning/ADR-template.md +0 -74
- package/src/modules/bmm/workflows/3-solutioning/checklist.md +0 -170
- package/src/modules/bmm/workflows/3-solutioning/instructions.md +0 -661
- package/src/modules/bmm/workflows/3-solutioning/project-types/backend-questions.md +0 -490
- package/src/modules/bmm/workflows/3-solutioning/project-types/cli-questions.md +0 -337
- package/src/modules/bmm/workflows/3-solutioning/project-types/data-questions.md +0 -472
- package/src/modules/bmm/workflows/3-solutioning/project-types/desktop-questions.md +0 -299
- package/src/modules/bmm/workflows/3-solutioning/project-types/embedded-questions.md +0 -118
- package/src/modules/bmm/workflows/3-solutioning/project-types/extension-questions.md +0 -374
- package/src/modules/bmm/workflows/3-solutioning/project-types/game-questions.md +0 -133
- package/src/modules/bmm/workflows/3-solutioning/project-types/infra-questions.md +0 -484
- package/src/modules/bmm/workflows/3-solutioning/project-types/library-questions.md +0 -146
- package/src/modules/bmm/workflows/3-solutioning/project-types/mobile-questions.md +0 -110
- package/src/modules/bmm/workflows/3-solutioning/project-types/project-types.csv +0 -12
- package/src/modules/bmm/workflows/3-solutioning/project-types/web-questions.md +0 -136
- package/src/modules/bmm/workflows/3-solutioning/tech-spec/instructions.md +0 -73
- package/src/modules/bmm/workflows/3-solutioning/tech-spec/workflow.yaml +0 -51
- package/src/modules/bmm/workflows/3-solutioning/templates/backend-service-architecture.md +0 -66
- package/src/modules/bmm/workflows/3-solutioning/templates/cli-tool-architecture.md +0 -66
- package/src/modules/bmm/workflows/3-solutioning/templates/data-pipeline-architecture.md +0 -66
- package/src/modules/bmm/workflows/3-solutioning/templates/desktop-app-architecture.md +0 -66
- package/src/modules/bmm/workflows/3-solutioning/templates/embedded-firmware-architecture.md +0 -66
- package/src/modules/bmm/workflows/3-solutioning/templates/game-engine-architecture.md +0 -244
- package/src/modules/bmm/workflows/3-solutioning/templates/game-engine-godot-guide.md +0 -428
- package/src/modules/bmm/workflows/3-solutioning/templates/game-engine-unity-guide.md +0 -333
- package/src/modules/bmm/workflows/3-solutioning/templates/game-engine-web-guide.md +0 -528
- package/src/modules/bmm/workflows/3-solutioning/templates/infrastructure-architecture.md +0 -66
- package/src/modules/bmm/workflows/3-solutioning/templates/library-package-architecture.md +0 -66
- package/src/modules/bmm/workflows/3-solutioning/templates/mobile-app-architecture.md +0 -66
- package/src/modules/bmm/workflows/3-solutioning/templates/registry.csv +0 -172
- package/src/modules/bmm/workflows/3-solutioning/templates/web-api-architecture.md +0 -66
- package/src/modules/bmm/workflows/3-solutioning/templates/web-fullstack-architecture.md +0 -277
- package/src/modules/bmm/workflows/3-solutioning/workflow.yaml +0 -65
- package/src/modules/bmm/workflows/4-implementation/review-story/instructions.md +0 -176
- package/src/modules/bmm/workflows/4-implementation/review-story/workflow.yaml +0 -99
- package/src/modules/cis/agents/brainstorming-coach.md +0 -24
- package/src/modules/cis/agents/creative-problem-solver.md +0 -24
- package/src/modules/cis/agents/design-thinking-coach.md +0 -24
- package/src/modules/cis/agents/innovation-strategist.md +0 -24
- package/src/modules/cis/agents/storyteller.md +0 -24
- package/tools/test-agents/captain-kirk-commander.md +0 -110
- package/tools/test-agents/data-operations-android.md +0 -123
- package/tools/test-agents/geordi-chief-engineer.md +0 -135
- package/tools/test-agents/isabella-martinez-ethicist.md +0 -109
- package/tools/test-agents/marcus-thompson-security.md +0 -109
- package/tools/test-agents/maya-patel-pragmatist.md +0 -82
- package/tools/test-agents/picard-diplomat-captain.md +0 -134
- package/tools/test-agents/spock-science-officer.md +0 -124
- package/tools/test-agents/william-smithers-technocrat.md +0 -71
- package/tools/test-agents/zara-chen-designer.md +0 -94
- /package/{src/modules/cis → bmad/core}/workflows/brainstorming/brain-methods.csv +0 -0
- /package/src/modules/bmm/_module-installer/assets/{technical-decisions-template.md → technical-decisions.md} +0 -0
- /package/src/modules/bmm/sub-modules/claude-code/sub-agents/{requirements-analyst.md → bmad-planning/requirements-analyst.md} +0 -0
- /package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/metroidvania.md +0 -0
- /package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types/puzzle.md +0 -0
- /package/src/modules/bmm/workflows/{2-plan → 2-plan-workflows}/gdd/game-types.csv +0 -0
- /package/src/modules/bmm/workflows/4-implementation/{review-story → code-review}/backlog_template.md +0 -0
- /package/src/modules/bmm/workflows/4-implementation/{review-story → code-review}/checklist.md +0 -0
- /package/src/modules/cis/_module-installer/{install-menu-config.yaml → install-config.yaml} +0 -0
|
@@ -0,0 +1,732 @@
|
|
|
1
|
+
# Selective and Targeted Test Execution
|
|
2
|
+
|
|
3
|
+
## Principle
|
|
4
|
+
|
|
5
|
+
Run only the tests you need, when you need them. Use tags/grep to slice suites by risk priority (not directory structure), filter by spec patterns or git diff to focus on impacted areas, and combine priority metadata (P0-P3) with change detection to optimize pre-commit vs. CI execution. Document the selection strategy clearly so teams understand when full regression is mandatory.
|
|
6
|
+
|
|
7
|
+
## Rationale
|
|
8
|
+
|
|
9
|
+
Running the entire test suite on every commit wastes time and resources. Smart test selection provides fast feedback (smoke tests in minutes, full regression in hours) while maintaining confidence. The "32+ ways of selective testing" philosophy balances speed with coverage: quick loops for developers, comprehensive validation before deployment. Poorly documented selection leads to confusion about when tests run and why.
|
|
10
|
+
|
|
11
|
+
## Pattern Examples
|
|
12
|
+
|
|
13
|
+
### Example 1: Tag-Based Execution with Priority Levels
|
|
14
|
+
|
|
15
|
+
**Context**: Organize tests by risk priority and execution stage using grep/tag patterns.
|
|
16
|
+
|
|
17
|
+
**Implementation**:
|
|
18
|
+
|
|
19
|
+
```typescript
|
|
20
|
+
// tests/e2e/checkout.spec.ts
|
|
21
|
+
import { test, expect } from '@playwright/test';
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Tag-based test organization
|
|
25
|
+
* - @smoke: Critical path tests (run on every commit, < 5 min)
|
|
26
|
+
* - @regression: Full test suite (run pre-merge, < 30 min)
|
|
27
|
+
* - @p0: Critical business functions (payment, auth, data integrity)
|
|
28
|
+
* - @p1: Core features (primary user journeys)
|
|
29
|
+
* - @p2: Secondary features (supporting functionality)
|
|
30
|
+
* - @p3: Nice-to-have (cosmetic, non-critical)
|
|
31
|
+
*/
|
|
32
|
+
|
|
33
|
+
test.describe('Checkout Flow', () => {
|
|
34
|
+
// P0 + Smoke: Must run on every commit
|
|
35
|
+
test('@smoke @p0 should complete purchase with valid payment', async ({ page }) => {
|
|
36
|
+
await page.goto('/checkout');
|
|
37
|
+
await page.getByTestId('card-number').fill('4242424242424242');
|
|
38
|
+
await page.getByTestId('submit-payment').click();
|
|
39
|
+
|
|
40
|
+
await expect(page.getByTestId('order-confirmation')).toBeVisible();
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
// P0 but not smoke: Run pre-merge
|
|
44
|
+
test('@regression @p0 should handle payment decline gracefully', async ({ page }) => {
|
|
45
|
+
await page.goto('/checkout');
|
|
46
|
+
await page.getByTestId('card-number').fill('4000000000000002'); // Decline card
|
|
47
|
+
await page.getByTestId('submit-payment').click();
|
|
48
|
+
|
|
49
|
+
await expect(page.getByTestId('payment-error')).toBeVisible();
|
|
50
|
+
await expect(page.getByTestId('payment-error')).toContainText('declined');
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
// P1 + Smoke: Important but not critical
|
|
54
|
+
test('@smoke @p1 should apply discount code', async ({ page }) => {
|
|
55
|
+
await page.goto('/checkout');
|
|
56
|
+
await page.getByTestId('promo-code').fill('SAVE10');
|
|
57
|
+
await page.getByTestId('apply-promo').click();
|
|
58
|
+
|
|
59
|
+
await expect(page.getByTestId('discount-applied')).toBeVisible();
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
// P2: Run in full regression only
|
|
63
|
+
test('@regression @p2 should remember saved payment methods', async ({ page }) => {
|
|
64
|
+
await page.goto('/checkout');
|
|
65
|
+
await expect(page.getByTestId('saved-cards')).toBeVisible();
|
|
66
|
+
});
|
|
67
|
+
|
|
68
|
+
// P3: Low priority, run nightly or weekly
|
|
69
|
+
test('@nightly @p3 should display checkout page analytics', async ({ page }) => {
|
|
70
|
+
await page.goto('/checkout');
|
|
71
|
+
const analyticsEvents = await page.evaluate(() => (window as any).__ANALYTICS__);
|
|
72
|
+
expect(analyticsEvents).toBeDefined();
|
|
73
|
+
});
|
|
74
|
+
});
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
**package.json scripts**:
|
|
78
|
+
|
|
79
|
+
```json
|
|
80
|
+
{
|
|
81
|
+
"scripts": {
|
|
82
|
+
"test": "playwright test",
|
|
83
|
+
"test:smoke": "playwright test --grep '@smoke'",
|
|
84
|
+
"test:p0": "playwright test --grep '@p0'",
|
|
85
|
+
"test:p0-p1": "playwright test --grep '@p0|@p1'",
|
|
86
|
+
"test:regression": "playwright test --grep '@regression'",
|
|
87
|
+
"test:nightly": "playwright test --grep '@nightly'",
|
|
88
|
+
"test:not-slow": "playwright test --grep-invert '@slow'",
|
|
89
|
+
"test:critical-smoke": "playwright test --grep '@smoke.*@p0'"
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
**Cypress equivalent**:
|
|
95
|
+
|
|
96
|
+
```javascript
|
|
97
|
+
// cypress/e2e/checkout.cy.ts
|
|
98
|
+
describe('Checkout Flow', { tags: ['@checkout'] }, () => {
|
|
99
|
+
it('should complete purchase', { tags: ['@smoke', '@p0'] }, () => {
|
|
100
|
+
cy.visit('/checkout');
|
|
101
|
+
cy.get('[data-cy="card-number"]').type('4242424242424242');
|
|
102
|
+
cy.get('[data-cy="submit-payment"]').click();
|
|
103
|
+
cy.get('[data-cy="order-confirmation"]').should('be.visible');
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
it('should handle decline', { tags: ['@regression', '@p0'] }, () => {
|
|
107
|
+
cy.visit('/checkout');
|
|
108
|
+
cy.get('[data-cy="card-number"]').type('4000000000000002');
|
|
109
|
+
cy.get('[data-cy="submit-payment"]').click();
|
|
110
|
+
cy.get('[data-cy="payment-error"]').should('be.visible');
|
|
111
|
+
});
|
|
112
|
+
});
|
|
113
|
+
|
|
114
|
+
// cypress.config.ts
|
|
115
|
+
export default defineConfig({
|
|
116
|
+
e2e: {
|
|
117
|
+
env: {
|
|
118
|
+
grepTags: process.env.GREP_TAGS || '',
|
|
119
|
+
grepFilterSpecs: true,
|
|
120
|
+
},
|
|
121
|
+
setupNodeEvents(on, config) {
|
|
122
|
+
require('@cypress/grep/src/plugin')(config);
|
|
123
|
+
return config;
|
|
124
|
+
},
|
|
125
|
+
},
|
|
126
|
+
});
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
**Usage**:
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
# Playwright
|
|
133
|
+
npm run test:smoke # Run all @smoke tests
|
|
134
|
+
npm run test:p0 # Run all P0 tests
|
|
135
|
+
npm run test -- --grep "@smoke.*@p0" # Run tests with BOTH tags
|
|
136
|
+
|
|
137
|
+
# Cypress (with @cypress/grep plugin)
|
|
138
|
+
npx cypress run --env grepTags="@smoke"
|
|
139
|
+
npx cypress run --env grepTags="@p0+@smoke" # AND logic
|
|
140
|
+
npx cypress run --env grepTags="@p0 @p1" # OR logic
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
**Key Points**:
|
|
144
|
+
|
|
145
|
+
- **Multiple tags per test**: Combine priority (@p0) with stage (@smoke)
|
|
146
|
+
- **AND/OR logic**: Grep supports complex filtering
|
|
147
|
+
- **Clear naming**: Tags document test importance
|
|
148
|
+
- **Fast feedback**: @smoke runs < 5 min, full suite < 30 min
|
|
149
|
+
- **CI integration**: Different jobs run different tag combinations
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
### Example 2: Spec Filter Pattern (File-Based Selection)
|
|
154
|
+
|
|
155
|
+
**Context**: Run tests by file path pattern or directory for targeted execution.
|
|
156
|
+
|
|
157
|
+
**Implementation**:
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
#!/bin/bash
|
|
161
|
+
# scripts/selective-spec-runner.sh
|
|
162
|
+
# Run tests based on spec file patterns
|
|
163
|
+
|
|
164
|
+
set -e
|
|
165
|
+
|
|
166
|
+
PATTERN=${1:-"**/*.spec.ts"}
|
|
167
|
+
TEST_ENV=${TEST_ENV:-local}
|
|
168
|
+
|
|
169
|
+
echo "🎯 Selective Spec Runner"
|
|
170
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
171
|
+
echo "Pattern: $PATTERN"
|
|
172
|
+
echo "Environment: $TEST_ENV"
|
|
173
|
+
echo ""
|
|
174
|
+
|
|
175
|
+
# Pattern examples and their use cases
|
|
176
|
+
case "$PATTERN" in
|
|
177
|
+
"**/checkout*")
|
|
178
|
+
echo "📦 Running checkout-related tests"
|
|
179
|
+
npx playwright test --grep-files="**/checkout*"
|
|
180
|
+
;;
|
|
181
|
+
"**/auth*"|"**/login*"|"**/signup*")
|
|
182
|
+
echo "🔐 Running authentication tests"
|
|
183
|
+
npx playwright test --grep-files="**/auth*|**/login*|**/signup*"
|
|
184
|
+
;;
|
|
185
|
+
"tests/e2e/**")
|
|
186
|
+
echo "🌐 Running all E2E tests"
|
|
187
|
+
npx playwright test tests/e2e/
|
|
188
|
+
;;
|
|
189
|
+
"tests/integration/**")
|
|
190
|
+
echo "🔌 Running all integration tests"
|
|
191
|
+
npx playwright test tests/integration/
|
|
192
|
+
;;
|
|
193
|
+
"tests/component/**")
|
|
194
|
+
echo "🧩 Running all component tests"
|
|
195
|
+
npx playwright test tests/component/
|
|
196
|
+
;;
|
|
197
|
+
*)
|
|
198
|
+
echo "🔍 Running tests matching pattern: $PATTERN"
|
|
199
|
+
npx playwright test "$PATTERN"
|
|
200
|
+
;;
|
|
201
|
+
esac
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
**Playwright config for file filtering**:
|
|
205
|
+
|
|
206
|
+
```typescript
|
|
207
|
+
// playwright.config.ts
|
|
208
|
+
import { defineConfig, devices } from '@playwright/test';
|
|
209
|
+
|
|
210
|
+
export default defineConfig({
|
|
211
|
+
// ... other config
|
|
212
|
+
|
|
213
|
+
// Project-based organization
|
|
214
|
+
projects: [
|
|
215
|
+
{
|
|
216
|
+
name: 'smoke',
|
|
217
|
+
testMatch: /.*smoke.*\.spec\.ts/,
|
|
218
|
+
retries: 0,
|
|
219
|
+
},
|
|
220
|
+
{
|
|
221
|
+
name: 'e2e',
|
|
222
|
+
testMatch: /tests\/e2e\/.*\.spec\.ts/,
|
|
223
|
+
retries: 2,
|
|
224
|
+
},
|
|
225
|
+
{
|
|
226
|
+
name: 'integration',
|
|
227
|
+
testMatch: /tests\/integration\/.*\.spec\.ts/,
|
|
228
|
+
retries: 1,
|
|
229
|
+
},
|
|
230
|
+
{
|
|
231
|
+
name: 'component',
|
|
232
|
+
testMatch: /tests\/component\/.*\.spec\.ts/,
|
|
233
|
+
use: { ...devices['Desktop Chrome'] },
|
|
234
|
+
},
|
|
235
|
+
],
|
|
236
|
+
});
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
**Advanced pattern matching**:
|
|
240
|
+
|
|
241
|
+
```typescript
|
|
242
|
+
// scripts/run-by-component.ts
|
|
243
|
+
/**
|
|
244
|
+
* Run tests related to specific component(s)
|
|
245
|
+
* Usage: npm run test:component UserProfile,Settings
|
|
246
|
+
*/
|
|
247
|
+
|
|
248
|
+
import { execSync } from 'child_process';
|
|
249
|
+
|
|
250
|
+
const components = process.argv[2]?.split(',') || [];
|
|
251
|
+
|
|
252
|
+
if (components.length === 0) {
|
|
253
|
+
console.error('❌ No components specified');
|
|
254
|
+
console.log('Usage: npm run test:component UserProfile,Settings');
|
|
255
|
+
process.exit(1);
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
// Convert component names to glob patterns
|
|
259
|
+
const patterns = components.map((comp) => `**/*${comp}*.spec.ts`).join(' ');
|
|
260
|
+
|
|
261
|
+
console.log(`🧩 Running tests for components: ${components.join(', ')}`);
|
|
262
|
+
console.log(`Patterns: ${patterns}`);
|
|
263
|
+
|
|
264
|
+
try {
|
|
265
|
+
execSync(`npx playwright test ${patterns}`, {
|
|
266
|
+
stdio: 'inherit',
|
|
267
|
+
env: { ...process.env, CI: 'false' },
|
|
268
|
+
});
|
|
269
|
+
} catch (error) {
|
|
270
|
+
process.exit(1);
|
|
271
|
+
}
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
**package.json scripts**:
|
|
275
|
+
|
|
276
|
+
```json
|
|
277
|
+
{
|
|
278
|
+
"scripts": {
|
|
279
|
+
"test:checkout": "playwright test **/checkout*.spec.ts",
|
|
280
|
+
"test:auth": "playwright test **/auth*.spec.ts **/login*.spec.ts",
|
|
281
|
+
"test:e2e": "playwright test tests/e2e/",
|
|
282
|
+
"test:integration": "playwright test tests/integration/",
|
|
283
|
+
"test:component": "ts-node scripts/run-by-component.ts",
|
|
284
|
+
"test:project": "playwright test --project",
|
|
285
|
+
"test:smoke-project": "playwright test --project smoke"
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
**Key Points**:
|
|
291
|
+
|
|
292
|
+
- **Glob patterns**: Wildcards match file paths flexibly
|
|
293
|
+
- **Project isolation**: Separate projects have different configs
|
|
294
|
+
- **Component targeting**: Run tests for specific features
|
|
295
|
+
- **Directory-based**: Organize tests by type (e2e, integration, component)
|
|
296
|
+
- **CI optimization**: Run subsets in parallel CI jobs
|
|
297
|
+
|
|
298
|
+
---
|
|
299
|
+
|
|
300
|
+
### Example 3: Diff-Based Test Selection (Changed Files Only)
|
|
301
|
+
|
|
302
|
+
**Context**: Run only tests affected by code changes for maximum speed.
|
|
303
|
+
|
|
304
|
+
**Implementation**:
|
|
305
|
+
|
|
306
|
+
```bash
|
|
307
|
+
#!/bin/bash
|
|
308
|
+
# scripts/test-changed-files.sh
|
|
309
|
+
# Intelligent test selection based on git diff
|
|
310
|
+
|
|
311
|
+
set -e
|
|
312
|
+
|
|
313
|
+
BASE_BRANCH=${BASE_BRANCH:-main}
|
|
314
|
+
TEST_ENV=${TEST_ENV:-local}
|
|
315
|
+
|
|
316
|
+
echo "🔍 Changed File Test Selector"
|
|
317
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
318
|
+
echo "Base branch: $BASE_BRANCH"
|
|
319
|
+
echo "Environment: $TEST_ENV"
|
|
320
|
+
echo ""
|
|
321
|
+
|
|
322
|
+
# Get changed files
|
|
323
|
+
CHANGED_FILES=$(git diff --name-only $BASE_BRANCH...HEAD)
|
|
324
|
+
|
|
325
|
+
if [ -z "$CHANGED_FILES" ]; then
|
|
326
|
+
echo "✅ No files changed. Skipping tests."
|
|
327
|
+
exit 0
|
|
328
|
+
fi
|
|
329
|
+
|
|
330
|
+
echo "Changed files:"
|
|
331
|
+
echo "$CHANGED_FILES" | sed 's/^/ - /'
|
|
332
|
+
echo ""
|
|
333
|
+
|
|
334
|
+
# Arrays to collect test specs
|
|
335
|
+
DIRECT_TEST_FILES=()
|
|
336
|
+
RELATED_TEST_FILES=()
|
|
337
|
+
RUN_ALL_TESTS=false
|
|
338
|
+
|
|
339
|
+
# Process each changed file
|
|
340
|
+
while IFS= read -r file; do
|
|
341
|
+
case "$file" in
|
|
342
|
+
# Changed test files: run them directly
|
|
343
|
+
*.spec.ts|*.spec.js|*.test.ts|*.test.js|*.cy.ts|*.cy.js)
|
|
344
|
+
DIRECT_TEST_FILES+=("$file")
|
|
345
|
+
;;
|
|
346
|
+
|
|
347
|
+
# Critical config changes: run ALL tests
|
|
348
|
+
package.json|package-lock.json|playwright.config.ts|cypress.config.ts|tsconfig.json|.github/workflows/*)
|
|
349
|
+
echo "⚠️ Critical file changed: $file"
|
|
350
|
+
RUN_ALL_TESTS=true
|
|
351
|
+
break
|
|
352
|
+
;;
|
|
353
|
+
|
|
354
|
+
# Component changes: find related tests
|
|
355
|
+
src/components/*.tsx|src/components/*.jsx)
|
|
356
|
+
COMPONENT_NAME=$(basename "$file" | sed 's/\.[^.]*$//')
|
|
357
|
+
echo "🧩 Component changed: $COMPONENT_NAME"
|
|
358
|
+
|
|
359
|
+
# Find tests matching component name
|
|
360
|
+
FOUND_TESTS=$(find tests -name "*${COMPONENT_NAME}*.spec.ts" -o -name "*${COMPONENT_NAME}*.cy.ts" 2>/dev/null || true)
|
|
361
|
+
if [ -n "$FOUND_TESTS" ]; then
|
|
362
|
+
while IFS= read -r test_file; do
|
|
363
|
+
RELATED_TEST_FILES+=("$test_file")
|
|
364
|
+
done <<< "$FOUND_TESTS"
|
|
365
|
+
fi
|
|
366
|
+
;;
|
|
367
|
+
|
|
368
|
+
# Utility/lib changes: run integration + unit tests
|
|
369
|
+
src/utils/*|src/lib/*|src/helpers/*)
|
|
370
|
+
echo "⚙️ Utility file changed: $file"
|
|
371
|
+
RELATED_TEST_FILES+=($(find tests/unit tests/integration -name "*.spec.ts" 2>/dev/null || true))
|
|
372
|
+
;;
|
|
373
|
+
|
|
374
|
+
# API changes: run integration + e2e tests
|
|
375
|
+
src/api/*|src/services/*|src/controllers/*)
|
|
376
|
+
echo "🔌 API file changed: $file"
|
|
377
|
+
RELATED_TEST_FILES+=($(find tests/integration tests/e2e -name "*.spec.ts" 2>/dev/null || true))
|
|
378
|
+
;;
|
|
379
|
+
|
|
380
|
+
# Type changes: run all TypeScript tests
|
|
381
|
+
*.d.ts|src/types/*)
|
|
382
|
+
echo "📝 Type definition changed: $file"
|
|
383
|
+
RUN_ALL_TESTS=true
|
|
384
|
+
break
|
|
385
|
+
;;
|
|
386
|
+
|
|
387
|
+
# Documentation only: skip tests
|
|
388
|
+
*.md|docs/*|README*)
|
|
389
|
+
echo "📄 Documentation changed: $file (no tests needed)"
|
|
390
|
+
;;
|
|
391
|
+
|
|
392
|
+
*)
|
|
393
|
+
echo "❓ Unclassified change: $file (running smoke tests)"
|
|
394
|
+
RELATED_TEST_FILES+=($(find tests -name "*smoke*.spec.ts" 2>/dev/null || true))
|
|
395
|
+
;;
|
|
396
|
+
esac
|
|
397
|
+
done <<< "$CHANGED_FILES"
|
|
398
|
+
|
|
399
|
+
# Execute tests based on analysis
|
|
400
|
+
if [ "$RUN_ALL_TESTS" = true ]; then
|
|
401
|
+
echo ""
|
|
402
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
403
|
+
echo "🚨 Running FULL test suite (critical changes detected)"
|
|
404
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
405
|
+
npm run test
|
|
406
|
+
exit $?
|
|
407
|
+
fi
|
|
408
|
+
|
|
409
|
+
# Combine and deduplicate test files
|
|
410
|
+
ALL_TEST_FILES=(${DIRECT_TEST_FILES[@]} ${RELATED_TEST_FILES[@]})
|
|
411
|
+
UNIQUE_TEST_FILES=($(echo "${ALL_TEST_FILES[@]}" | tr ' ' '\n' | sort -u))
|
|
412
|
+
|
|
413
|
+
if [ ${#UNIQUE_TEST_FILES[@]} -eq 0 ]; then
|
|
414
|
+
echo ""
|
|
415
|
+
echo "✅ No tests found for changed files. Running smoke tests."
|
|
416
|
+
npm run test:smoke
|
|
417
|
+
exit $?
|
|
418
|
+
fi
|
|
419
|
+
|
|
420
|
+
echo ""
|
|
421
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
422
|
+
echo "🎯 Running ${#UNIQUE_TEST_FILES[@]} test file(s)"
|
|
423
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
424
|
+
|
|
425
|
+
for test_file in "${UNIQUE_TEST_FILES[@]}"; do
|
|
426
|
+
echo " - $test_file"
|
|
427
|
+
done
|
|
428
|
+
|
|
429
|
+
echo ""
|
|
430
|
+
npm run test -- "${UNIQUE_TEST_FILES[@]}"
|
|
431
|
+
```
|
|
432
|
+
|
|
433
|
+
**GitHub Actions integration**:
|
|
434
|
+
|
|
435
|
+
```yaml
|
|
436
|
+
# .github/workflows/test-changed.yml
|
|
437
|
+
name: Test Changed Files
|
|
438
|
+
on:
|
|
439
|
+
pull_request:
|
|
440
|
+
types: [opened, synchronize, reopened]
|
|
441
|
+
|
|
442
|
+
jobs:
|
|
443
|
+
detect-and-test:
|
|
444
|
+
runs-on: ubuntu-latest
|
|
445
|
+
steps:
|
|
446
|
+
- uses: actions/checkout@v4
|
|
447
|
+
with:
|
|
448
|
+
fetch-depth: 0 # Full history for accurate diff
|
|
449
|
+
|
|
450
|
+
- name: Get changed files
|
|
451
|
+
id: changed-files
|
|
452
|
+
uses: tj-actions/changed-files@v40
|
|
453
|
+
with:
|
|
454
|
+
files: |
|
|
455
|
+
src/**
|
|
456
|
+
tests/**
|
|
457
|
+
*.config.ts
|
|
458
|
+
files_ignore: |
|
|
459
|
+
**/*.md
|
|
460
|
+
docs/**
|
|
461
|
+
|
|
462
|
+
- name: Run tests for changed files
|
|
463
|
+
if: steps.changed-files.outputs.any_changed == 'true'
|
|
464
|
+
run: |
|
|
465
|
+
echo "Changed files: ${{ steps.changed-files.outputs.all_changed_files }}"
|
|
466
|
+
bash scripts/test-changed-files.sh
|
|
467
|
+
env:
|
|
468
|
+
BASE_BRANCH: ${{ github.base_ref }}
|
|
469
|
+
TEST_ENV: staging
|
|
470
|
+
```
|
|
471
|
+
|
|
472
|
+
**Key Points**:
|
|
473
|
+
|
|
474
|
+
- **Intelligent mapping**: Code changes → related tests
|
|
475
|
+
- **Critical file detection**: Config changes = full suite
|
|
476
|
+
- **Component mapping**: UI changes → component + E2E tests
|
|
477
|
+
- **Fast feedback**: Run only what's needed (< 2 min typical)
|
|
478
|
+
- **Safety net**: Unrecognized changes run smoke tests
|
|
479
|
+
|
|
480
|
+
---
|
|
481
|
+
|
|
482
|
+
### Example 4: Promotion Rules (Pre-Commit → CI → Staging → Production)
|
|
483
|
+
|
|
484
|
+
**Context**: Progressive test execution strategy across deployment stages.
|
|
485
|
+
|
|
486
|
+
**Implementation**:
|
|
487
|
+
|
|
488
|
+
```typescript
|
|
489
|
+
// scripts/test-promotion-strategy.ts
|
|
490
|
+
/**
|
|
491
|
+
* Test Promotion Strategy
|
|
492
|
+
* Defines which tests run at each stage of the development lifecycle
|
|
493
|
+
*/
|
|
494
|
+
|
|
495
|
+
export type TestStage = 'pre-commit' | 'ci-pr' | 'ci-merge' | 'staging' | 'production';
|
|
496
|
+
|
|
497
|
+
export type TestPromotion = {
|
|
498
|
+
stage: TestStage;
|
|
499
|
+
description: string;
|
|
500
|
+
testCommand: string;
|
|
501
|
+
timebudget: string; // minutes
|
|
502
|
+
required: boolean;
|
|
503
|
+
failureAction: 'block' | 'warn' | 'alert';
|
|
504
|
+
};
|
|
505
|
+
|
|
506
|
+
export const TEST_PROMOTION_RULES: Record<TestStage, TestPromotion> = {
|
|
507
|
+
'pre-commit': {
|
|
508
|
+
stage: 'pre-commit',
|
|
509
|
+
description: 'Local developer checks before git commit',
|
|
510
|
+
testCommand: 'npm run test:smoke',
|
|
511
|
+
timebudget: '2',
|
|
512
|
+
required: true,
|
|
513
|
+
failureAction: 'block',
|
|
514
|
+
},
|
|
515
|
+
'ci-pr': {
|
|
516
|
+
stage: 'ci-pr',
|
|
517
|
+
description: 'CI checks on pull request creation/update',
|
|
518
|
+
testCommand: 'npm run test:changed && npm run test:p0-p1',
|
|
519
|
+
timebudget: '10',
|
|
520
|
+
required: true,
|
|
521
|
+
failureAction: 'block',
|
|
522
|
+
},
|
|
523
|
+
'ci-merge': {
|
|
524
|
+
stage: 'ci-merge',
|
|
525
|
+
description: 'Full regression before merge to main',
|
|
526
|
+
testCommand: 'npm run test:regression',
|
|
527
|
+
timebudget: '30',
|
|
528
|
+
required: true,
|
|
529
|
+
failureAction: 'block',
|
|
530
|
+
},
|
|
531
|
+
staging: {
|
|
532
|
+
stage: 'staging',
|
|
533
|
+
description: 'Post-deployment validation in staging environment',
|
|
534
|
+
testCommand: 'npm run test:e2e -- --grep "@smoke"',
|
|
535
|
+
timebudget: '15',
|
|
536
|
+
required: true,
|
|
537
|
+
failureAction: 'block',
|
|
538
|
+
},
|
|
539
|
+
production: {
|
|
540
|
+
stage: 'production',
|
|
541
|
+
description: 'Production smoke tests post-deployment',
|
|
542
|
+
testCommand: 'npm run test:e2e:prod -- --grep "@smoke.*@p0"',
|
|
543
|
+
timebudget: '5',
|
|
544
|
+
required: false,
|
|
545
|
+
failureAction: 'alert',
|
|
546
|
+
},
|
|
547
|
+
};
|
|
548
|
+
|
|
549
|
+
/**
|
|
550
|
+
* Get tests to run for a specific stage
|
|
551
|
+
*/
|
|
552
|
+
export function getTestsForStage(stage: TestStage): TestPromotion {
|
|
553
|
+
return TEST_PROMOTION_RULES[stage];
|
|
554
|
+
}
|
|
555
|
+
|
|
556
|
+
/**
|
|
557
|
+
* Validate if tests can be promoted to next stage
|
|
558
|
+
*/
|
|
559
|
+
export function canPromote(currentStage: TestStage, testsPassed: boolean): boolean {
|
|
560
|
+
const promotion = TEST_PROMOTION_RULES[currentStage];
|
|
561
|
+
|
|
562
|
+
if (!promotion.required) {
|
|
563
|
+
return true; // Non-required tests don't block promotion
|
|
564
|
+
}
|
|
565
|
+
|
|
566
|
+
return testsPassed;
|
|
567
|
+
}
|
|
568
|
+
```
|
|
569
|
+
|
|
570
|
+
**Husky pre-commit hook**:
|
|
571
|
+
|
|
572
|
+
```bash
|
|
573
|
+
#!/bin/bash
|
|
574
|
+
# .husky/pre-commit
|
|
575
|
+
# Run smoke tests before allowing commit
|
|
576
|
+
|
|
577
|
+
echo "🔍 Running pre-commit tests..."
|
|
578
|
+
|
|
579
|
+
npm run test:smoke
|
|
580
|
+
|
|
581
|
+
if [ $? -ne 0 ]; then
|
|
582
|
+
echo ""
|
|
583
|
+
echo "❌ Pre-commit tests failed!"
|
|
584
|
+
echo "Please fix failures before committing."
|
|
585
|
+
echo ""
|
|
586
|
+
echo "To skip (NOT recommended): git commit --no-verify"
|
|
587
|
+
exit 1
|
|
588
|
+
fi
|
|
589
|
+
|
|
590
|
+
echo "✅ Pre-commit tests passed"
|
|
591
|
+
```
|
|
592
|
+
|
|
593
|
+
**GitHub Actions workflow**:
|
|
594
|
+
|
|
595
|
+
```yaml
|
|
596
|
+
# .github/workflows/test-promotion.yml
|
|
597
|
+
name: Test Promotion Strategy
|
|
598
|
+
on:
|
|
599
|
+
pull_request:
|
|
600
|
+
push:
|
|
601
|
+
branches: [main]
|
|
602
|
+
workflow_dispatch:
|
|
603
|
+
|
|
604
|
+
jobs:
|
|
605
|
+
# Stage 1: PR tests (changed + P0-P1)
|
|
606
|
+
pr-tests:
|
|
607
|
+
if: github.event_name == 'pull_request'
|
|
608
|
+
runs-on: ubuntu-latest
|
|
609
|
+
timeout-minutes: 10
|
|
610
|
+
steps:
|
|
611
|
+
- uses: actions/checkout@v4
|
|
612
|
+
- name: Run PR-level tests
|
|
613
|
+
run: |
|
|
614
|
+
npm run test:changed
|
|
615
|
+
npm run test:p0-p1
|
|
616
|
+
|
|
617
|
+
# Stage 2: Full regression (pre-merge)
|
|
618
|
+
regression-tests:
|
|
619
|
+
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
|
|
620
|
+
runs-on: ubuntu-latest
|
|
621
|
+
timeout-minutes: 30
|
|
622
|
+
steps:
|
|
623
|
+
- uses: actions/checkout@v4
|
|
624
|
+
- name: Run full regression
|
|
625
|
+
run: npm run test:regression
|
|
626
|
+
|
|
627
|
+
# Stage 3: Staging validation (post-deploy)
|
|
628
|
+
staging-smoke:
|
|
629
|
+
if: github.event_name == 'workflow_dispatch'
|
|
630
|
+
runs-on: ubuntu-latest
|
|
631
|
+
timeout-minutes: 15
|
|
632
|
+
steps:
|
|
633
|
+
- uses: actions/checkout@v4
|
|
634
|
+
- name: Run staging smoke tests
|
|
635
|
+
run: npm run test:e2e -- --grep "@smoke"
|
|
636
|
+
env:
|
|
637
|
+
TEST_ENV: staging
|
|
638
|
+
|
|
639
|
+
# Stage 4: Production smoke (post-deploy, non-blocking)
|
|
640
|
+
production-smoke:
|
|
641
|
+
if: github.event_name == 'workflow_dispatch'
|
|
642
|
+
runs-on: ubuntu-latest
|
|
643
|
+
timeout-minutes: 5
|
|
644
|
+
continue-on-error: true # Don't fail deployment if smoke tests fail
|
|
645
|
+
steps:
|
|
646
|
+
- uses: actions/checkout@v4
|
|
647
|
+
- name: Run production smoke tests
|
|
648
|
+
run: npm run test:e2e:prod -- --grep "@smoke.*@p0"
|
|
649
|
+
env:
|
|
650
|
+
TEST_ENV: production
|
|
651
|
+
|
|
652
|
+
- name: Alert on failure
|
|
653
|
+
if: failure()
|
|
654
|
+
uses: 8398a7/action-slack@v3
|
|
655
|
+
with:
|
|
656
|
+
status: ${{ job.status }}
|
|
657
|
+
text: '🚨 Production smoke tests failed!'
|
|
658
|
+
webhook_url: ${{ secrets.SLACK_WEBHOOK }}
|
|
659
|
+
```
|
|
660
|
+
|
|
661
|
+
**Selection strategy documentation**:
|
|
662
|
+
|
|
663
|
+
````markdown
|
|
664
|
+
# Test Selection Strategy
|
|
665
|
+
|
|
666
|
+
## Test Promotion Stages
|
|
667
|
+
|
|
668
|
+
| Stage | Tests Run | Time Budget | Blocks Deploy | Failure Action |
|
|
669
|
+
| ---------- | ------------------- | ----------- | ------------- | -------------- |
|
|
670
|
+
| Pre-Commit | Smoke (@smoke) | 2 min | ✅ Yes | Block commit |
|
|
671
|
+
| CI PR | Changed + P0-P1 | 10 min | ✅ Yes | Block merge |
|
|
672
|
+
| CI Merge | Full regression | 30 min | ✅ Yes | Block deploy |
|
|
673
|
+
| Staging | E2E smoke | 15 min | ✅ Yes | Rollback |
|
|
674
|
+
| Production | Critical smoke only | 5 min | ❌ No | Alert team |
|
|
675
|
+
|
|
676
|
+
## When Full Regression Runs
|
|
677
|
+
|
|
678
|
+
Full regression suite (`npm run test:regression`) runs in these scenarios:
|
|
679
|
+
|
|
680
|
+
- ✅ Before merging to `main` (CI Merge stage)
|
|
681
|
+
- ✅ Nightly builds (scheduled workflow)
|
|
682
|
+
- ✅ Manual trigger (workflow_dispatch)
|
|
683
|
+
- ✅ Release candidate testing
|
|
684
|
+
|
|
685
|
+
Full regression does NOT run on:
|
|
686
|
+
|
|
687
|
+
- ❌ Every PR commit (too slow)
|
|
688
|
+
- ❌ Pre-commit hooks (too slow)
|
|
689
|
+
- ❌ Production deployments (deploy-blocking)
|
|
690
|
+
|
|
691
|
+
## Override Scenarios
|
|
692
|
+
|
|
693
|
+
Skip tests (emergency only):
|
|
694
|
+
|
|
695
|
+
```bash
|
|
696
|
+
git commit --no-verify # Skip pre-commit hook
|
|
697
|
+
gh pr merge --admin # Force merge (requires admin)
|
|
698
|
+
```
|
|
699
|
+
````
|
|
700
|
+
|
|
701
|
+
```
|
|
702
|
+
|
|
703
|
+
**Key Points**:
|
|
704
|
+
- **Progressive validation**: More tests at each stage
|
|
705
|
+
- **Time budgets**: Clear expectations per stage
|
|
706
|
+
- **Blocking vs. alerting**: Production tests don't block deploy
|
|
707
|
+
- **Documentation**: Team knows when full regression runs
|
|
708
|
+
- **Emergency overrides**: Documented but discouraged
|
|
709
|
+
|
|
710
|
+
---
|
|
711
|
+
|
|
712
|
+
## Test Selection Strategy Checklist
|
|
713
|
+
|
|
714
|
+
Before implementing selective testing, verify:
|
|
715
|
+
|
|
716
|
+
- [ ] **Tag strategy defined**: @smoke, @p0-p3, @regression documented
|
|
717
|
+
- [ ] **Time budgets set**: Each stage has clear timeout (smoke < 5 min, full < 30 min)
|
|
718
|
+
- [ ] **Changed file mapping**: Code changes → test selection logic implemented
|
|
719
|
+
- [ ] **Promotion rules documented**: README explains when full regression runs
|
|
720
|
+
- [ ] **CI integration**: GitHub Actions uses selective strategy
|
|
721
|
+
- [ ] **Local parity**: Developers can run same selections locally
|
|
722
|
+
- [ ] **Emergency overrides**: Skip mechanisms documented (--no-verify, admin merge)
|
|
723
|
+
- [ ] **Metrics tracked**: Monitor test execution time and selection accuracy
|
|
724
|
+
|
|
725
|
+
## Integration Points
|
|
726
|
+
|
|
727
|
+
- Used in workflows: `*ci` (CI/CD setup), `*automate` (test generation with tags)
|
|
728
|
+
- Related fragments: `ci-burn-in.md`, `test-priorities-matrix.md`, `test-quality.md`
|
|
729
|
+
- Selection tools: Playwright --grep, Cypress @cypress/grep, git diff
|
|
730
|
+
|
|
731
|
+
_Source: 32+ selective testing strategies blog, Murat testing philosophy, SEON CI optimization_
|
|
732
|
+
```
|