bmad-fh 6.0.0-alpha.23
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/.coderabbit.yaml +40 -0
- package/.githooks/post-checkout +129 -0
- package/.githooks/pre-commit +63 -0
- package/.githooks/pre-push +135 -0
- package/.github/CODE_OF_CONDUCT.md +128 -0
- package/.github/FUNDING.yaml +15 -0
- package/.github/ISSUE_TEMPLATE/config.yaml +8 -0
- package/.github/ISSUE_TEMPLATE/feature_request.md +22 -0
- package/.github/ISSUE_TEMPLATE/issue.md +32 -0
- package/.github/scripts/discord-helpers.sh +34 -0
- package/.github/workflows/bundle-latest.yaml +330 -0
- package/.github/workflows/discord.yaml +90 -0
- package/.github/workflows/docs.yaml +63 -0
- package/.github/workflows/manual-release.yaml +190 -0
- package/.github/workflows/publish-multi-artifact.yaml +50 -0
- package/.github/workflows/quality.yaml +115 -0
- package/.husky/pre-commit +20 -0
- package/.markdownlint-cli2.yaml +41 -0
- package/.nvmrc +1 -0
- package/.prettierignore +9 -0
- package/.vscode/settings.json +97 -0
- package/CHANGELOG.md +1394 -0
- package/CNAME +1 -0
- package/CONTRIBUTING.md +306 -0
- package/CONTRIBUTORS.md +32 -0
- package/LICENSE +30 -0
- package/README.md +126 -0
- package/SECURITY.md +85 -0
- package/TRADEMARK.md +55 -0
- package/Wordmark.png +0 -0
- package/banner-bmad-method.png +0 -0
- package/docs/404.md +9 -0
- package/docs/_README_WORKFLOW_DIAGRAMS.md +40 -0
- package/docs/_STYLE_GUIDE.md +367 -0
- package/docs/_archive/customize-workflows.md +30 -0
- package/docs/_archive/getting-started-bmadv4.md +247 -0
- package/docs/_archive/vendor-workflows.md +52 -0
- package/docs/downloads.md +72 -0
- package/docs/explanation/agents/barry-quick-flow.md +328 -0
- package/docs/explanation/agents/index.md +19 -0
- package/docs/explanation/architecture/four-phases.md +107 -0
- package/docs/explanation/architecture/preventing-agent-conflicts.md +111 -0
- package/docs/explanation/architecture/why-solutioning-matters.md +75 -0
- package/docs/explanation/bmm/index.md +131 -0
- package/docs/explanation/core/index.md +18 -0
- package/docs/explanation/core-concepts/agent-roles.md +179 -0
- package/docs/explanation/core-concepts/index.md +35 -0
- package/docs/explanation/core-concepts/what-are-agents.md +97 -0
- package/docs/explanation/core-concepts/what-are-modules.md +85 -0
- package/docs/explanation/core-concepts/what-are-workflows.md +204 -0
- package/docs/explanation/faq/brownfield-faq.md +73 -0
- package/docs/explanation/faq/getting-started-faq.md +67 -0
- package/docs/explanation/faq/implementation-faq.md +52 -0
- package/docs/explanation/faq/index.md +16 -0
- package/docs/explanation/faq/levels-and-tracks-faq.md +52 -0
- package/docs/explanation/faq/planning-faq.md +41 -0
- package/docs/explanation/faq/tools-faq.md +277 -0
- package/docs/explanation/faq/workflows-faq.md +61 -0
- package/docs/explanation/features/advanced-elicitation.md +95 -0
- package/docs/explanation/features/brainstorming-techniques.md +92 -0
- package/docs/explanation/features/party-mode.md +95 -0
- package/docs/explanation/features/quick-flow.md +149 -0
- package/docs/explanation/features/tea-overview.md +410 -0
- package/docs/explanation/features/web-bundles.md +34 -0
- package/docs/explanation/philosophy/facilitation-over-generation.md +333 -0
- package/docs/explanation/philosophy/testing-as-engineering.md +112 -0
- package/docs/explanation/tea/engagement-models.md +710 -0
- package/docs/explanation/tea/fixture-architecture.md +457 -0
- package/docs/explanation/tea/knowledge-base-system.md +554 -0
- package/docs/explanation/tea/network-first-patterns.md +853 -0
- package/docs/explanation/tea/risk-based-testing.md +586 -0
- package/docs/explanation/tea/test-quality-standards.md +907 -0
- package/docs/how-to/brownfield/add-feature-to-existing.md +74 -0
- package/docs/how-to/brownfield/document-existing-project.md +66 -0
- package/docs/how-to/brownfield/index.md +84 -0
- package/docs/how-to/brownfield/quick-fix-in-brownfield.md +77 -0
- package/docs/how-to/brownfield/use-tea-for-enterprise.md +526 -0
- package/docs/how-to/brownfield/use-tea-with-existing-tests.md +577 -0
- package/docs/how-to/customization/customize-agents.md +212 -0
- package/docs/how-to/customization/enable-tea-mcp-enhancements.md +424 -0
- package/docs/how-to/customization/index.md +23 -0
- package/docs/how-to/customization/integrate-playwright-utils.md +813 -0
- package/docs/how-to/customization/shard-large-documents.md +101 -0
- package/docs/how-to/get-answers-about-bmad.md +102 -0
- package/docs/how-to/installation/index.md +12 -0
- package/docs/how-to/installation/install-bmad.md +111 -0
- package/docs/how-to/installation/install-custom-modules.md +118 -0
- package/docs/how-to/installation/upgrade-to-v6.md +131 -0
- package/docs/how-to/workflows/bmgd-quick-flow.md +156 -0
- package/docs/how-to/workflows/conduct-research.md +97 -0
- package/docs/how-to/workflows/create-architecture.md +119 -0
- package/docs/how-to/workflows/create-epics-and-stories.md +109 -0
- package/docs/how-to/workflows/create-prd.md +91 -0
- package/docs/how-to/workflows/create-product-brief.md +94 -0
- package/docs/how-to/workflows/create-story.md +102 -0
- package/docs/how-to/workflows/create-ux-design.md +100 -0
- package/docs/how-to/workflows/implement-story.md +97 -0
- package/docs/how-to/workflows/quick-spec.md +122 -0
- package/docs/how-to/workflows/run-atdd.md +436 -0
- package/docs/how-to/workflows/run-automate.md +653 -0
- package/docs/how-to/workflows/run-brainstorming-session.md +73 -0
- package/docs/how-to/workflows/run-code-review.md +89 -0
- package/docs/how-to/workflows/run-implementation-readiness.md +125 -0
- package/docs/how-to/workflows/run-nfr-assess.md +679 -0
- package/docs/how-to/workflows/run-sprint-planning.md +94 -0
- package/docs/how-to/workflows/run-test-design.md +98 -0
- package/docs/how-to/workflows/run-test-review.md +605 -0
- package/docs/how-to/workflows/run-trace.md +883 -0
- package/docs/how-to/workflows/setup-ci.md +712 -0
- package/docs/how-to/workflows/setup-party-mode.md +89 -0
- package/docs/how-to/workflows/setup-test-framework.md +98 -0
- package/docs/index.md +63 -0
- package/docs/migration-guide.md +365 -0
- package/docs/multi-scope-guide.md +379 -0
- package/docs/plans/multi-scope-parallel-artifacts-plan.md +695 -0
- package/docs/reference/agents/index.md +109 -0
- package/docs/reference/configuration/core-tasks.md +67 -0
- package/docs/reference/configuration/global-config.md +28 -0
- package/docs/reference/glossary/index.md +159 -0
- package/docs/reference/tea/commands.md +254 -0
- package/docs/reference/tea/configuration.md +678 -0
- package/docs/reference/tea/knowledge-base.md +340 -0
- package/docs/reference/workflows/core-workflows.md +32 -0
- package/docs/reference/workflows/document-project.md +73 -0
- package/docs/reference/workflows/index.md +12 -0
- package/docs/tutorials/getting-started/getting-started-bmadv6.md +246 -0
- package/docs/tutorials/getting-started/images/workflow-method-greenfield.excalidraw +5034 -0
- package/docs/tutorials/getting-started/images/workflow-method-greenfield.svg +4 -0
- package/docs/tutorials/getting-started/images/workflow-overview.jpg +0 -0
- package/docs/tutorials/getting-started/tea-lite-quickstart.md +444 -0
- package/docs/tutorials/getting-started/workflow-overview.jpg +0 -0
- package/eslint.config.mjs +152 -0
- package/package.json +117 -0
- package/prettier.config.mjs +32 -0
- package/src/bmm/_module-installer/installer.js +48 -0
- package/src/bmm/_module-installer/platform-specifics/claude-code.js +35 -0
- package/src/bmm/_module-installer/platform-specifics/windsurf.js +32 -0
- package/src/bmm/agents/analyst.agent.yaml +41 -0
- package/src/bmm/agents/architect.agent.yaml +33 -0
- package/src/bmm/agents/dev.agent.yaml +38 -0
- package/src/bmm/agents/pm.agent.yaml +51 -0
- package/src/bmm/agents/quick-flow-solo-dev.agent.yaml +32 -0
- package/src/bmm/agents/sm.agent.yaml +47 -0
- package/src/bmm/agents/tea.agent.yaml +68 -0
- package/src/bmm/agents/tech-writer/tech-writer-sidecar/documentation-standards.md +224 -0
- package/src/bmm/agents/tech-writer/tech-writer.agent.yaml +49 -0
- package/src/bmm/agents/ux-designer.agent.yaml +30 -0
- package/src/bmm/data/README.md +29 -0
- package/src/bmm/data/project-context-template.md +40 -0
- package/src/bmm/module.yaml +64 -0
- package/src/bmm/sub-modules/claude-code/config.yaml +4 -0
- package/src/bmm/sub-modules/claude-code/injections.yaml +242 -0
- package/src/bmm/sub-modules/claude-code/readme.md +87 -0
- package/src/bmm/teams/default-party.csv +21 -0
- package/src/bmm/teams/team-fullstack.yaml +12 -0
- package/src/bmm/testarch/knowledge/api-request.md +442 -0
- package/src/bmm/testarch/knowledge/api-testing-patterns.md +843 -0
- package/src/bmm/testarch/knowledge/auth-session.md +552 -0
- package/src/bmm/testarch/knowledge/burn-in.md +273 -0
- package/src/bmm/testarch/knowledge/ci-burn-in.md +675 -0
- package/src/bmm/testarch/knowledge/component-tdd.md +486 -0
- package/src/bmm/testarch/knowledge/contract-testing.md +957 -0
- package/src/bmm/testarch/knowledge/data-factories.md +500 -0
- package/src/bmm/testarch/knowledge/email-auth.md +721 -0
- package/src/bmm/testarch/knowledge/error-handling.md +725 -0
- package/src/bmm/testarch/knowledge/feature-flags.md +750 -0
- package/src/bmm/testarch/knowledge/file-utils.md +463 -0
- package/src/bmm/testarch/knowledge/fixture-architecture.md +401 -0
- package/src/bmm/testarch/knowledge/fixtures-composition.md +382 -0
- package/src/bmm/testarch/knowledge/intercept-network-call.md +430 -0
- package/src/bmm/testarch/knowledge/log.md +429 -0
- package/src/bmm/testarch/knowledge/network-error-monitor.md +405 -0
- package/src/bmm/testarch/knowledge/network-first.md +486 -0
- package/src/bmm/testarch/knowledge/network-recorder.md +527 -0
- package/src/bmm/testarch/knowledge/nfr-criteria.md +670 -0
- package/src/bmm/testarch/knowledge/overview.md +286 -0
- package/src/bmm/testarch/knowledge/playwright-config.md +730 -0
- package/src/bmm/testarch/knowledge/probability-impact.md +601 -0
- package/src/bmm/testarch/knowledge/recurse.md +421 -0
- package/src/bmm/testarch/knowledge/risk-governance.md +615 -0
- package/src/bmm/testarch/knowledge/selective-testing.md +732 -0
- package/src/bmm/testarch/knowledge/selector-resilience.md +527 -0
- package/src/bmm/testarch/knowledge/test-healing-patterns.md +644 -0
- package/src/bmm/testarch/knowledge/test-levels-framework.md +473 -0
- package/src/bmm/testarch/knowledge/test-priorities-matrix.md +373 -0
- package/src/bmm/testarch/knowledge/test-quality.md +664 -0
- package/src/bmm/testarch/knowledge/timing-debugging.md +372 -0
- package/src/bmm/testarch/knowledge/visual-debugging.md +524 -0
- package/src/bmm/testarch/tea-index.csv +34 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/product-brief.template.md +10 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +177 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +161 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +199 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +202 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +205 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +219 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +194 -0
- package/src/bmm/workflows/1-analysis/create-product-brief/workflow.md +58 -0
- package/src/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +137 -0
- package/src/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +229 -0
- package/src/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +238 -0
- package/src/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +206 -0
- package/src/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +234 -0
- package/src/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +443 -0
- package/src/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +182 -0
- package/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +237 -0
- package/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +200 -0
- package/src/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +249 -0
- package/src/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +259 -0
- package/src/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +177 -0
- package/src/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +475 -0
- package/src/bmm/workflows/1-analysis/research/research.template.md +29 -0
- package/src/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +137 -0
- package/src/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +239 -0
- package/src/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +248 -0
- package/src/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +202 -0
- package/src/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +239 -0
- package/src/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +486 -0
- package/src/bmm/workflows/1-analysis/research/workflow.md +173 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +135 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +127 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +190 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +216 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +219 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +234 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +252 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +254 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +224 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +224 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +241 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +248 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +237 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +264 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +228 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +13 -0
- package/src/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +43 -0
- package/src/bmm/workflows/2-plan-workflows/prd/data/domain-complexity.csv +13 -0
- package/src/bmm/workflows/2-plan-workflows/prd/data/prd-purpose.md +197 -0
- package/src/bmm/workflows/2-plan-workflows/prd/data/project-types.csv +11 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-01-init.md +191 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-01b-continue.md +153 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-02-discovery.md +224 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-03-success.md +226 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-04-journeys.md +213 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-05-domain.md +207 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-06-innovation.md +226 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-07-project-type.md +237 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-08-scoping.md +228 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-09-functional.md +231 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-10-nonfunctional.md +242 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-11-polish.md +217 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-c/step-12-complete.md +180 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01-discovery.md +247 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-01b-legacy-conversion.md +208 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-02-review.md +249 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-03-edit.md +253 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-e/step-e-04-complete.md +168 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-01-discovery.md +218 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02-format-detection.md +191 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-02b-parity-check.md +209 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-03-density-validation.md +174 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-04-brief-coverage-validation.md +214 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-05-measurability-validation.md +228 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-06-traceability-validation.md +217 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-07-implementation-leakage-validation.md +205 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-08-domain-compliance-validation.md +243 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-09-project-type-validation.md +263 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-10-smart-validation.md +209 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-11-holistic-quality-validation.md +264 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-12-completeness-validation.md +242 -0
- package/src/bmm/workflows/2-plan-workflows/prd/steps-v/step-v-13-report-complete.md +232 -0
- package/src/bmm/workflows/2-plan-workflows/prd/templates/prd-template.md +10 -0
- package/src/bmm/workflows/2-plan-workflows/prd/validation-report-prd-workflow.md +433 -0
- package/src/bmm/workflows/2-plan-workflows/prd/workflow.md +150 -0
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +190 -0
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +178 -0
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +179 -0
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +139 -0
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +252 -0
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +133 -0
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/templates/readiness-report-template.md +4 -0
- package/src/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +55 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/architecture-decision-template.md +12 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/data/domain-complexity.csv +11 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/data/project-types.csv +7 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +153 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +164 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +224 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +331 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +318 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +359 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +379 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +359 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +352 -0
- package/src/bmm/workflows/3-solutioning/create-architecture/workflow.md +50 -0
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +259 -0
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +233 -0
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +272 -0
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +145 -0
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/templates/epics-template.md +57 -0
- package/src/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +59 -0
- package/src/bmm/workflows/4-implementation/code-review/checklist.md +23 -0
- package/src/bmm/workflows/4-implementation/code-review/instructions.xml +227 -0
- package/src/bmm/workflows/4-implementation/code-review/workflow.yaml +51 -0
- package/src/bmm/workflows/4-implementation/correct-course/checklist.md +288 -0
- package/src/bmm/workflows/4-implementation/correct-course/instructions.md +206 -0
- package/src/bmm/workflows/4-implementation/correct-course/workflow.yaml +60 -0
- package/src/bmm/workflows/4-implementation/create-story/checklist.md +358 -0
- package/src/bmm/workflows/4-implementation/create-story/instructions.xml +345 -0
- package/src/bmm/workflows/4-implementation/create-story/template.md +49 -0
- package/src/bmm/workflows/4-implementation/create-story/workflow.yaml +61 -0
- package/src/bmm/workflows/4-implementation/dev-story/checklist.md +80 -0
- package/src/bmm/workflows/4-implementation/dev-story/instructions.xml +410 -0
- package/src/bmm/workflows/4-implementation/dev-story/workflow.yaml +27 -0
- package/src/bmm/workflows/4-implementation/retrospective/instructions.md +1443 -0
- package/src/bmm/workflows/4-implementation/retrospective/workflow.yaml +58 -0
- package/src/bmm/workflows/4-implementation/sprint-planning/checklist.md +33 -0
- package/src/bmm/workflows/4-implementation/sprint-planning/instructions.md +225 -0
- package/src/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -0
- package/src/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +54 -0
- package/src/bmm/workflows/4-implementation/sprint-status/instructions.md +229 -0
- package/src/bmm/workflows/4-implementation/sprint-status/workflow.yaml +36 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +156 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-02-context-gathering.md +120 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-03-execute.md +113 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md +113 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +106 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md +140 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +52 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md +189 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md +144 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-03-generate.md +128 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md +191 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-spec/tech-spec-template.md +74 -0
- package/src/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md +79 -0
- package/src/bmm/workflows/document-project/checklist.md +245 -0
- package/src/bmm/workflows/document-project/documentation-requirements.csv +12 -0
- package/src/bmm/workflows/document-project/instructions.md +221 -0
- package/src/bmm/workflows/document-project/templates/deep-dive-template.md +345 -0
- package/src/bmm/workflows/document-project/templates/index-template.md +169 -0
- package/src/bmm/workflows/document-project/templates/project-overview-template.md +103 -0
- package/src/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -0
- package/src/bmm/workflows/document-project/templates/source-tree-template.md +135 -0
- package/src/bmm/workflows/document-project/workflow.yaml +30 -0
- package/src/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -0
- package/src/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -0
- package/src/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -0
- package/src/bmm/workflows/document-project/workflows/full-scan.yaml +31 -0
- package/src/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-library.json +90 -0
- package/src/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-templates.yaml +127 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/checklist.md +39 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/instructions.md +130 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-dataflow/workflow.yaml +27 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-diagram/checklist.md +43 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-diagram/instructions.md +141 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-diagram/workflow.yaml +27 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/checklist.md +49 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/instructions.md +241 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-flowchart/workflow.yaml +27 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/checklist.md +38 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/instructions.md +133 -0
- package/src/bmm/workflows/excalidraw-diagrams/create-wireframe/workflow.yaml +27 -0
- package/src/bmm/workflows/generate-project-context/project-context-template.md +21 -0
- package/src/bmm/workflows/generate-project-context/steps/step-01-discover.md +184 -0
- package/src/bmm/workflows/generate-project-context/steps/step-02-generate.md +318 -0
- package/src/bmm/workflows/generate-project-context/steps/step-03-complete.md +278 -0
- package/src/bmm/workflows/generate-project-context/workflow.md +49 -0
- package/src/bmm/workflows/testarch/atdd/atdd-checklist-template.md +364 -0
- package/src/bmm/workflows/testarch/atdd/checklist.md +374 -0
- package/src/bmm/workflows/testarch/atdd/instructions.md +806 -0
- package/src/bmm/workflows/testarch/atdd/workflow.yaml +47 -0
- package/src/bmm/workflows/testarch/automate/checklist.md +582 -0
- package/src/bmm/workflows/testarch/automate/instructions.md +1324 -0
- package/src/bmm/workflows/testarch/automate/workflow.yaml +54 -0
- package/src/bmm/workflows/testarch/ci/checklist.md +248 -0
- package/src/bmm/workflows/testarch/ci/github-actions-template.yaml +198 -0
- package/src/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +149 -0
- package/src/bmm/workflows/testarch/ci/instructions.md +536 -0
- package/src/bmm/workflows/testarch/ci/workflow.yaml +47 -0
- package/src/bmm/workflows/testarch/framework/checklist.md +321 -0
- package/src/bmm/workflows/testarch/framework/instructions.md +481 -0
- package/src/bmm/workflows/testarch/framework/workflow.yaml +49 -0
- package/src/bmm/workflows/testarch/nfr-assess/checklist.md +407 -0
- package/src/bmm/workflows/testarch/nfr-assess/instructions.md +722 -0
- package/src/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +445 -0
- package/src/bmm/workflows/testarch/nfr-assess/workflow.yaml +49 -0
- package/src/bmm/workflows/testarch/test-design/checklist.md +235 -0
- package/src/bmm/workflows/testarch/test-design/instructions.md +788 -0
- package/src/bmm/workflows/testarch/test-design/test-design-template.md +294 -0
- package/src/bmm/workflows/testarch/test-design/workflow.yaml +56 -0
- package/src/bmm/workflows/testarch/test-review/checklist.md +472 -0
- package/src/bmm/workflows/testarch/test-review/instructions.md +628 -0
- package/src/bmm/workflows/testarch/test-review/test-review-template.md +390 -0
- package/src/bmm/workflows/testarch/test-review/workflow.yaml +48 -0
- package/src/bmm/workflows/testarch/trace/checklist.md +655 -0
- package/src/bmm/workflows/testarch/trace/instructions.md +1047 -0
- package/src/bmm/workflows/testarch/trace/trace-template.md +675 -0
- package/src/bmm/workflows/testarch/trace/workflow.yaml +57 -0
- package/src/bmm/workflows/workflow-status/init/instructions.md +346 -0
- package/src/bmm/workflows/workflow-status/init/workflow.yaml +30 -0
- package/src/bmm/workflows/workflow-status/instructions.md +397 -0
- package/src/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +103 -0
- package/src/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +100 -0
- package/src/bmm/workflows/workflow-status/paths/method-brownfield.yaml +103 -0
- package/src/bmm/workflows/workflow-status/paths/method-greenfield.yaml +100 -0
- package/src/bmm/workflows/workflow-status/project-levels.yaml +59 -0
- package/src/bmm/workflows/workflow-status/workflow-status-template.yaml +24 -0
- package/src/bmm/workflows/workflow-status/workflow.yaml +32 -0
- package/src/core/_module-installer/installer.js +60 -0
- package/src/core/agents/bmad-master.agent.yaml +30 -0
- package/src/core/lib/scope/artifact-resolver.js +298 -0
- package/src/core/lib/scope/event-logger.js +411 -0
- package/src/core/lib/scope/index.js +30 -0
- package/src/core/lib/scope/scope-context.js +307 -0
- package/src/core/lib/scope/scope-initializer.js +458 -0
- package/src/core/lib/scope/scope-manager.js +512 -0
- package/src/core/lib/scope/scope-migrator.js +442 -0
- package/src/core/lib/scope/scope-sync.js +489 -0
- package/src/core/lib/scope/scope-validator.js +299 -0
- package/src/core/lib/scope/state-lock.js +342 -0
- package/src/core/module.yaml +53 -0
- package/src/core/resources/excalidraw/README.md +160 -0
- package/src/core/resources/excalidraw/excalidraw-helpers.md +127 -0
- package/src/core/resources/excalidraw/library-loader.md +50 -0
- package/src/core/resources/excalidraw/validate-json-instructions.md +79 -0
- package/src/core/tasks/editorial-review-prose.xml +91 -0
- package/src/core/tasks/editorial-review-structure.xml +198 -0
- package/src/core/tasks/index-docs.xml +65 -0
- package/src/core/tasks/review-adversarial-general.xml +46 -0
- package/src/core/tasks/shard-doc.xml +109 -0
- package/src/core/tasks/workflow.xml +277 -0
- package/src/core/workflows/advanced-elicitation/methods.csv +51 -0
- package/src/core/workflows/advanced-elicitation/workflow.xml +117 -0
- package/src/core/workflows/brainstorming/brain-methods.csv +62 -0
- package/src/core/workflows/brainstorming/steps/step-01-session-setup.md +197 -0
- package/src/core/workflows/brainstorming/steps/step-01b-continue.md +122 -0
- package/src/core/workflows/brainstorming/steps/step-02a-user-selected.md +225 -0
- package/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +237 -0
- package/src/core/workflows/brainstorming/steps/step-02c-random-selection.md +209 -0
- package/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +264 -0
- package/src/core/workflows/brainstorming/steps/step-03-technique-execution.md +399 -0
- package/src/core/workflows/brainstorming/steps/step-04-idea-organization.md +303 -0
- package/src/core/workflows/brainstorming/template.md +15 -0
- package/src/core/workflows/brainstorming/workflow.md +58 -0
- package/src/core/workflows/party-mode/steps/step-01-agent-loading.md +138 -0
- package/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +187 -0
- package/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +157 -0
- package/src/core/workflows/party-mode/workflow.md +194 -0
- package/src/utility/agent-components/activation-rules.txt +6 -0
- package/src/utility/agent-components/activation-steps.txt +28 -0
- package/src/utility/agent-components/agent-command-header.md +1 -0
- package/src/utility/agent-components/agent.customize.template.yaml +41 -0
- package/src/utility/agent-components/handler-action.txt +4 -0
- package/src/utility/agent-components/handler-data.txt +5 -0
- package/src/utility/agent-components/handler-exec.txt +19 -0
- package/src/utility/agent-components/handler-multi.txt +14 -0
- package/src/utility/agent-components/handler-tmpl.txt +5 -0
- package/src/utility/agent-components/handler-validate-workflow.txt +7 -0
- package/src/utility/agent-components/handler-workflow.txt +10 -0
- package/src/utility/agent-components/menu-handlers.txt +6 -0
- package/test/README.md +295 -0
- package/test/fixtures/agent-schema/invalid/critical-actions/actions-as-string.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/critical-actions/empty-string-in-actions.agent.yaml +30 -0
- package/test/fixtures/agent-schema/invalid/menu/empty-menu.agent.yaml +22 -0
- package/test/fixtures/agent-schema/invalid/menu/missing-menu.agent.yaml +20 -0
- package/test/fixtures/agent-schema/invalid/menu-commands/empty-command-target.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-commands/no-command-target.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/camel-case.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/compound-invalid-format.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/duplicate-triggers.agent.yaml +31 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/empty-trigger.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/leading-asterisk.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/snake-case.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/trigger-with-spaces.agent.yaml +25 -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 +27 -0
- package/test/fixtures/agent-schema/invalid/metadata/missing-id.agent.yaml +23 -0
- package/test/fixtures/agent-schema/invalid/persona/empty-principles-array.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/persona/empty-string-in-principles.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/persona/extra-persona-fields.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/persona/missing-role.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/prompts/empty-content.agent.yaml +29 -0
- package/test/fixtures/agent-schema/invalid/prompts/extra-prompt-fields.agent.yaml +31 -0
- package/test/fixtures/agent-schema/invalid/prompts/missing-content.agent.yaml +28 -0
- package/test/fixtures/agent-schema/invalid/prompts/missing-id.agent.yaml +28 -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 +28 -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 +24 -0
- package/test/fixtures/agent-schema/valid/critical-actions/no-critical-actions.agent.yaml +22 -0
- package/test/fixtures/agent-schema/valid/critical-actions/valid-critical-actions.agent.yaml +27 -0
- package/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml +31 -0
- package/test/fixtures/agent-schema/valid/menu/single-menu-item.agent.yaml +22 -0
- package/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml +38 -0
- package/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml +31 -0
- package/test/fixtures/agent-schema/valid/menu-triggers/kebab-case-triggers.agent.yaml +34 -0
- package/test/fixtures/agent-schema/valid/metadata/core-agent-with-module.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/metadata/empty-module-name-in-path.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/metadata/malformed-path-treated-as-core.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/metadata/module-agent-correct.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/metadata/module-agent-missing-module.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/metadata/wrong-module-value.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/persona/complete-persona.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/prompts/empty-prompts.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/prompts/no-prompts.agent.yaml +22 -0
- package/test/fixtures/agent-schema/valid/prompts/valid-prompts-minimal.agent.yaml +28 -0
- package/test/fixtures/agent-schema/valid/prompts/valid-prompts-with-description.agent.yaml +30 -0
- package/test/fixtures/agent-schema/valid/top-level/minimal-core-agent.agent.yaml +24 -0
- package/test/test-agent-schema.js +387 -0
- package/test/test-cli-integration.sh +159 -0
- package/test/test-installation-components.js +214 -0
- package/test/test-scope-e2e.js +450 -0
- package/test/test-scope-system.js +787 -0
- package/test/unit-test-schema.js +133 -0
- package/tools/bmad-npx-wrapper.js +38 -0
- package/tools/build-docs.js +577 -0
- package/tools/cli/README.md +7 -0
- package/tools/cli/bmad-cli.js +58 -0
- package/tools/cli/commands/install.js +87 -0
- package/tools/cli/commands/scope.js +474 -0
- package/tools/cli/external-official-modules.yaml +41 -0
- package/tools/cli/installers/install-messages.yaml +58 -0
- package/tools/cli/installers/lib/core/config-collector.js +1079 -0
- package/tools/cli/installers/lib/core/custom-module-cache.js +259 -0
- package/tools/cli/installers/lib/core/dependency-resolver.js +739 -0
- package/tools/cli/installers/lib/core/detector.js +223 -0
- package/tools/cli/installers/lib/core/ide-config-manager.js +156 -0
- package/tools/cli/installers/lib/core/installer.js +2585 -0
- package/tools/cli/installers/lib/core/manifest-generator.js +963 -0
- package/tools/cli/installers/lib/core/manifest.js +590 -0
- package/tools/cli/installers/lib/custom/handler.js +363 -0
- package/tools/cli/installers/lib/ide/_base-ide.js +654 -0
- package/tools/cli/installers/lib/ide/antigravity.js +486 -0
- package/tools/cli/installers/lib/ide/auggie.js +244 -0
- package/tools/cli/installers/lib/ide/claude-code.js +487 -0
- package/tools/cli/installers/lib/ide/cline.js +269 -0
- package/tools/cli/installers/lib/ide/codex.js +375 -0
- package/tools/cli/installers/lib/ide/crush.js +300 -0
- package/tools/cli/installers/lib/ide/cursor.js +169 -0
- package/tools/cli/installers/lib/ide/gemini.js +301 -0
- package/tools/cli/installers/lib/ide/github-copilot.js +383 -0
- package/tools/cli/installers/lib/ide/iflow.js +191 -0
- package/tools/cli/installers/lib/ide/kilo.js +250 -0
- package/tools/cli/installers/lib/ide/kiro-cli.js +326 -0
- package/tools/cli/installers/lib/ide/manager.js +244 -0
- package/tools/cli/installers/lib/ide/opencode.js +257 -0
- package/tools/cli/installers/lib/ide/qwen.js +372 -0
- package/tools/cli/installers/lib/ide/roo.js +270 -0
- package/tools/cli/installers/lib/ide/rovo-dev.js +290 -0
- package/tools/cli/installers/lib/ide/shared/agent-command-generator.js +96 -0
- package/tools/cli/installers/lib/ide/shared/bmad-artifacts.js +158 -0
- package/tools/cli/installers/lib/ide/shared/module-injections.js +136 -0
- package/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js +119 -0
- package/tools/cli/installers/lib/ide/shared/workflow-command-generator.js +242 -0
- package/tools/cli/installers/lib/ide/templates/agent-command-template.md +29 -0
- package/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml +14 -0
- package/tools/cli/installers/lib/ide/templates/gemini-task-command.toml +12 -0
- package/tools/cli/installers/lib/ide/templates/workflow-command-template.md +30 -0
- package/tools/cli/installers/lib/ide/templates/workflow-commander.md +45 -0
- package/tools/cli/installers/lib/ide/trae.js +313 -0
- package/tools/cli/installers/lib/ide/windsurf.js +258 -0
- package/tools/cli/installers/lib/message-loader.js +85 -0
- package/tools/cli/installers/lib/modules/external-manager.js +133 -0
- package/tools/cli/installers/lib/modules/manager.js +1362 -0
- package/tools/cli/lib/activation-builder.js +163 -0
- package/tools/cli/lib/agent/compiler.js +522 -0
- package/tools/cli/lib/agent/installer.js +716 -0
- package/tools/cli/lib/agent/template-engine.js +152 -0
- package/tools/cli/lib/agent-analyzer.js +109 -0
- package/tools/cli/lib/agent-party-generator.js +194 -0
- package/tools/cli/lib/cli-utils.js +227 -0
- package/tools/cli/lib/config.js +213 -0
- package/tools/cli/lib/file-ops.js +204 -0
- package/tools/cli/lib/platform-codes.js +116 -0
- package/tools/cli/lib/project-root.js +77 -0
- package/tools/cli/lib/prompts.js +433 -0
- package/tools/cli/lib/ui.js +1591 -0
- package/tools/cli/lib/xml-handler.js +177 -0
- package/tools/cli/lib/xml-to-markdown.js +82 -0
- package/tools/cli/lib/yaml-format.js +245 -0
- package/tools/cli/lib/yaml-xml-builder.js +587 -0
- package/tools/cli/scripts/migrate-workflows.js +281 -0
- package/tools/docs/BUNDLE_DISTRIBUTION_SETUP.md +95 -0
- package/tools/docs/index.md +2 -0
- package/tools/fix-doc-links.js +288 -0
- package/tools/flattener/aggregate.js +76 -0
- package/tools/flattener/binary.js +80 -0
- package/tools/flattener/discovery.js +71 -0
- package/tools/flattener/files.js +35 -0
- package/tools/flattener/ignoreRules.js +172 -0
- package/tools/flattener/main.js +483 -0
- package/tools/flattener/projectRoot.js +201 -0
- package/tools/flattener/prompts.js +44 -0
- package/tools/flattener/stats.helpers.js +368 -0
- package/tools/flattener/stats.js +75 -0
- package/tools/flattener/test-matrix.js +409 -0
- package/tools/flattener/xml.js +82 -0
- package/tools/format-workflow-md.js +263 -0
- package/tools/lib/xml-utils.js +13 -0
- package/tools/maintainer/review-pr-README.md +55 -0
- package/tools/maintainer/review-pr.md +242 -0
- package/tools/migrate-custom-module-paths.js +124 -0
- package/tools/platform-codes.yaml +157 -0
- package/tools/schema/agent.js +493 -0
- package/tools/validate-agent-schema.js +110 -0
- package/tools/validate-doc-links.js +363 -0
- package/tools/validate-svg-changes.sh +356 -0
- package/website/README.md +76 -0
- package/website/astro.config.mjs +228 -0
- package/website/public/favicon.ico +0 -0
- package/website/public/img/bmad-dark.png +0 -0
- package/website/public/img/bmad-light.png +0 -0
- package/website/public/img/logo.svg +4 -0
- package/website/public/robots.txt +37 -0
- package/website/src/components/Banner.astro +59 -0
- package/website/src/components/Header.astro +121 -0
- package/website/src/components/MobileMenuFooter.astro +53 -0
- package/website/src/content/config.ts +6 -0
- package/website/src/lib/site-url.js +25 -0
- package/website/src/rehype-markdown-links.js +102 -0
- package/website/src/styles/custom.css +485 -0
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: 'step-04-review'
|
|
3
|
+
description: 'Review and finalize the tech-spec'
|
|
4
|
+
|
|
5
|
+
workflow_path: '{project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-spec'
|
|
6
|
+
wipFile: '{implementation_artifacts}/tech-spec-wip.md'
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Step 4: Review & Finalize
|
|
10
|
+
|
|
11
|
+
**Progress: Step 4 of 4** - Final Step
|
|
12
|
+
|
|
13
|
+
## RULES:
|
|
14
|
+
|
|
15
|
+
- MUST NOT skip steps.
|
|
16
|
+
- MUST NOT optimize sequence.
|
|
17
|
+
- MUST follow exact instructions.
|
|
18
|
+
- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
|
|
19
|
+
|
|
20
|
+
## CONTEXT:
|
|
21
|
+
|
|
22
|
+
- Requires `{wipFile}` from Step 3.
|
|
23
|
+
- MUST present COMPLETE spec content. Iterate until user is satisfied.
|
|
24
|
+
- **Criteria**: The spec MUST meet the **READY FOR DEVELOPMENT** standard defined in `workflow.md`.
|
|
25
|
+
|
|
26
|
+
## SEQUENCE OF INSTRUCTIONS
|
|
27
|
+
|
|
28
|
+
### 1. Load and Present Complete Spec
|
|
29
|
+
|
|
30
|
+
**Read `{wipFile}` completely and extract `slug` from frontmatter for later use.**
|
|
31
|
+
|
|
32
|
+
**Present to user:**
|
|
33
|
+
|
|
34
|
+
"Here's your complete tech-spec. Please review:"
|
|
35
|
+
|
|
36
|
+
[Display the complete spec content - all sections]
|
|
37
|
+
|
|
38
|
+
"**Quick Summary:**
|
|
39
|
+
|
|
40
|
+
- {task_count} tasks to implement
|
|
41
|
+
- {ac_count} acceptance criteria to verify
|
|
42
|
+
- {files_count} files to modify"
|
|
43
|
+
|
|
44
|
+
**Present review menu:**
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
[y] Approve - finalize the spec
|
|
48
|
+
[c] Changes - request modifications
|
|
49
|
+
[q] Questions - ask about any section
|
|
50
|
+
[a] Advanced Elicitation - dig deeper before approving
|
|
51
|
+
[p] Party Mode - get expert feedback before approving
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**HALT and wait for user selection.**
|
|
55
|
+
|
|
56
|
+
#### Menu Handling:
|
|
57
|
+
|
|
58
|
+
- **[y]**: Proceed to Section 3 (Finalize the Spec)
|
|
59
|
+
- **[c]**: Proceed to Section 2 (Handle Review Feedback), then return here and redisplay menu
|
|
60
|
+
- **[q]**: Answer questions, then redisplay this menu
|
|
61
|
+
- **[a]**: Load and execute `{advanced_elicitation}`, then return here and redisplay menu
|
|
62
|
+
- **[p]**: Load and execute `{party_mode_exec}`, then return here and redisplay menu
|
|
63
|
+
|
|
64
|
+
### 2. Handle Review Feedback
|
|
65
|
+
|
|
66
|
+
a) **If user requests changes:**
|
|
67
|
+
|
|
68
|
+
- Make the requested edits to `{wipFile}`
|
|
69
|
+
- Re-present the affected sections
|
|
70
|
+
- Ask if there are more changes
|
|
71
|
+
- Loop until user is satisfied
|
|
72
|
+
|
|
73
|
+
b) **If the spec does NOT meet the "Ready for Development" standard:**
|
|
74
|
+
|
|
75
|
+
- Point out the missing/weak sections (e.g., non-actionable tasks, missing ACs).
|
|
76
|
+
- Propose specific improvements to reach the standard.
|
|
77
|
+
- Make the edits once the user agrees.
|
|
78
|
+
|
|
79
|
+
c) **If user has questions:**
|
|
80
|
+
|
|
81
|
+
- Answer questions about the spec
|
|
82
|
+
- Clarify any confusing sections
|
|
83
|
+
- Make clarifying edits if needed
|
|
84
|
+
|
|
85
|
+
### 3. Finalize the Spec
|
|
86
|
+
|
|
87
|
+
**When user confirms the spec is good AND it meets the "Ready for Development" standard:**
|
|
88
|
+
|
|
89
|
+
a) Update `{wipFile}` frontmatter:
|
|
90
|
+
|
|
91
|
+
```yaml
|
|
92
|
+
---
|
|
93
|
+
# ... existing values ...
|
|
94
|
+
status: 'ready-for-dev'
|
|
95
|
+
stepsCompleted: [1, 2, 3, 4]
|
|
96
|
+
---
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
b) **Rename WIP file to final filename:**
|
|
100
|
+
- Using the `slug` extracted in Section 1
|
|
101
|
+
- Rename `{wipFile}` → `{implementation_artifacts}/tech-spec-{slug}.md`
|
|
102
|
+
- Store this as `finalFile` for use in menus below
|
|
103
|
+
|
|
104
|
+
### 4. Present Final Menu
|
|
105
|
+
|
|
106
|
+
a) **Display completion message and menu:**
|
|
107
|
+
|
|
108
|
+
```
|
|
109
|
+
**Tech-Spec Complete!**
|
|
110
|
+
|
|
111
|
+
Saved to: {finalFile}
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
**Next Steps:**
|
|
116
|
+
|
|
117
|
+
[a] Advanced Elicitation - refine further
|
|
118
|
+
[r] Adversarial Review - critique of the spec (highly recommended)
|
|
119
|
+
[b] Begin Development - start implementing now (not recommended)
|
|
120
|
+
[d] Done - exit workflow
|
|
121
|
+
[p] Party Mode - get expert feedback before dev
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
Once you are fully satisfied with the spec (ideally after **Adversarial Review** and maybe a few rounds of **Advanced Elicitation**), it is recommended to run implementation in a FRESH CONTEXT for best results.
|
|
126
|
+
|
|
127
|
+
Copy this prompt to start dev:
|
|
128
|
+
|
|
129
|
+
\`\`\`
|
|
130
|
+
quick-dev {finalFile}
|
|
131
|
+
\`\`\`
|
|
132
|
+
|
|
133
|
+
This ensures the dev agent has clean context focused solely on implementation.
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
b) **HALT and wait for user selection.**
|
|
137
|
+
|
|
138
|
+
#### Menu Handling:
|
|
139
|
+
|
|
140
|
+
- **[a]**: Load and execute `{advanced_elicitation}`, then return here and redisplay menu
|
|
141
|
+
- **[b]**: Load and execute `{quick_dev_workflow}` with the final spec file (warn: fresh context is better)
|
|
142
|
+
- **[d]**: Exit workflow - display final confirmation and path to spec
|
|
143
|
+
- **[p]**: Load and execute `{party_mode_exec}`, then return here and redisplay menu
|
|
144
|
+
- **[r]**: Execute Adversarial Review:
|
|
145
|
+
1. **Invoke Adversarial Review Task**:
|
|
146
|
+
> With `{finalFile}` constructed, invoke the review task. If possible, use information asymmetry: run this task, and only it, in a separate subagent or process with read access to the project, but no context except the `{finalFile}`.
|
|
147
|
+
<invoke-task>Review {finalFile} using {project-root}/_bmad/core/tasks/review-adversarial-general.xml</invoke-task>
|
|
148
|
+
> **Platform fallback:** If task invocation not available, load the task file and execute its instructions inline, passing `{finalFile}` as the content.
|
|
149
|
+
> The task should: review `{finalFile}` and return a list of findings.
|
|
150
|
+
|
|
151
|
+
2. **Process Findings**:
|
|
152
|
+
> Capture the findings from the task output.
|
|
153
|
+
> **If zero findings:** HALT - this is suspicious. Re-analyze or request user guidance.
|
|
154
|
+
> Evaluate severity (Critical, High, Medium, Low) and validity (real, noise, undecided).
|
|
155
|
+
> DO NOT exclude findings based on severity or validity unless explicitly asked to do so.
|
|
156
|
+
> Order findings by severity.
|
|
157
|
+
> Number the ordered findings (F1, F2, F3, etc.).
|
|
158
|
+
> If TodoWrite or similar tool is available, turn each finding into a TODO, include ID, severity, validity, and description in the TODO; otherwise present findings as a table with columns: ID, Severity, Validity, Description
|
|
159
|
+
|
|
160
|
+
3. Return here and redisplay menu.
|
|
161
|
+
|
|
162
|
+
### 5. Exit Workflow
|
|
163
|
+
|
|
164
|
+
**When user selects [d]:**
|
|
165
|
+
|
|
166
|
+
"**All done!** Your tech-spec is ready at:
|
|
167
|
+
|
|
168
|
+
`{finalFile}`
|
|
169
|
+
|
|
170
|
+
When you're ready to implement, run:
|
|
171
|
+
|
|
172
|
+
```
|
|
173
|
+
quick-dev {finalFile}
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
Ship it!"
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## REQUIRED OUTPUTS:
|
|
181
|
+
|
|
182
|
+
- MUST update status to 'ready-for-dev'.
|
|
183
|
+
- MUST rename file to `tech-spec-{slug}.md`.
|
|
184
|
+
- MUST provide clear next-step guidance and recommend fresh context for dev.
|
|
185
|
+
|
|
186
|
+
## VERIFICATION CHECKLIST:
|
|
187
|
+
|
|
188
|
+
- [ ] Complete spec presented for review.
|
|
189
|
+
- [ ] Requested changes implemented.
|
|
190
|
+
- [ ] Spec verified against **READY FOR DEVELOPMENT** standard.
|
|
191
|
+
- [ ] `stepsCompleted: [1, 2, 3, 4]` set and file renamed.
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: '{title}'
|
|
3
|
+
slug: '{slug}'
|
|
4
|
+
created: '{date}'
|
|
5
|
+
status: 'in-progress'
|
|
6
|
+
stepsCompleted: []
|
|
7
|
+
tech_stack: []
|
|
8
|
+
files_to_modify: []
|
|
9
|
+
code_patterns: []
|
|
10
|
+
test_patterns: []
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# Tech-Spec: {title}
|
|
14
|
+
|
|
15
|
+
**Created:** {date}
|
|
16
|
+
|
|
17
|
+
## Overview
|
|
18
|
+
|
|
19
|
+
### Problem Statement
|
|
20
|
+
|
|
21
|
+
{problem_statement}
|
|
22
|
+
|
|
23
|
+
### Solution
|
|
24
|
+
|
|
25
|
+
{solution}
|
|
26
|
+
|
|
27
|
+
### Scope
|
|
28
|
+
|
|
29
|
+
**In Scope:**
|
|
30
|
+
{in_scope}
|
|
31
|
+
|
|
32
|
+
**Out of Scope:**
|
|
33
|
+
{out_of_scope}
|
|
34
|
+
|
|
35
|
+
## Context for Development
|
|
36
|
+
|
|
37
|
+
### Codebase Patterns
|
|
38
|
+
|
|
39
|
+
{codebase_patterns}
|
|
40
|
+
|
|
41
|
+
### Files to Reference
|
|
42
|
+
|
|
43
|
+
| File | Purpose |
|
|
44
|
+
| ---- | ------- |
|
|
45
|
+
|
|
46
|
+
{files_table}
|
|
47
|
+
|
|
48
|
+
### Technical Decisions
|
|
49
|
+
|
|
50
|
+
{technical_decisions}
|
|
51
|
+
|
|
52
|
+
## Implementation Plan
|
|
53
|
+
|
|
54
|
+
### Tasks
|
|
55
|
+
|
|
56
|
+
{tasks}
|
|
57
|
+
|
|
58
|
+
### Acceptance Criteria
|
|
59
|
+
|
|
60
|
+
{acceptance_criteria}
|
|
61
|
+
|
|
62
|
+
## Additional Context
|
|
63
|
+
|
|
64
|
+
### Dependencies
|
|
65
|
+
|
|
66
|
+
{dependencies}
|
|
67
|
+
|
|
68
|
+
### Testing Strategy
|
|
69
|
+
|
|
70
|
+
{testing_strategy}
|
|
71
|
+
|
|
72
|
+
### Notes
|
|
73
|
+
|
|
74
|
+
{notes}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: quick-spec
|
|
3
|
+
description: Conversational spec engineering - ask questions, investigate code, produce implementation-ready tech-spec.
|
|
4
|
+
main_config: '{project-root}/_bmad/bmm/config.yaml'
|
|
5
|
+
web_bundle: true
|
|
6
|
+
|
|
7
|
+
# Checkpoint handler paths
|
|
8
|
+
advanced_elicitation: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
|
|
9
|
+
party_mode_exec: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
|
|
10
|
+
quick_dev_workflow: '{project-root}/_bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md'
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# Quick-Spec Workflow
|
|
14
|
+
|
|
15
|
+
**Goal:** Create implementation-ready technical specifications through conversational discovery, code investigation, and structured documentation.
|
|
16
|
+
|
|
17
|
+
**READY FOR DEVELOPMENT STANDARD:**
|
|
18
|
+
|
|
19
|
+
A specification is considered "Ready for Development" ONLY if it meets the following:
|
|
20
|
+
|
|
21
|
+
- **Actionable**: Every task has a clear file path and specific action.
|
|
22
|
+
- **Logical**: Tasks are ordered by dependency (lowest level first).
|
|
23
|
+
- **Testable**: All ACs follow Given/When/Then and cover happy path and edge cases.
|
|
24
|
+
- **Complete**: All investigation results from Step 2 are inlined; no placeholders or "TBD".
|
|
25
|
+
- **Self-Contained**: A fresh agent can implement the feature without reading the workflow history.
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
**Your Role:** You are an elite developer and spec engineer. You ask sharp questions, investigate existing code thoroughly, and produce specs that contain ALL context a fresh dev agent needs to implement the feature. No handoffs, no missing context - just complete, actionable specs.
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## WORKFLOW ARCHITECTURE
|
|
34
|
+
|
|
35
|
+
This uses **step-file architecture** for disciplined execution:
|
|
36
|
+
|
|
37
|
+
### Core Principles
|
|
38
|
+
|
|
39
|
+
- **Micro-file Design**: Each step is a self-contained instruction file that must be followed exactly
|
|
40
|
+
- **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until directed
|
|
41
|
+
- **Sequential Enforcement**: Sequence within step files must be completed in order, no skipping or optimization
|
|
42
|
+
- **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array
|
|
43
|
+
- **Append-Only Building**: Build the tech-spec by updating content as directed
|
|
44
|
+
|
|
45
|
+
### Step Processing Rules
|
|
46
|
+
|
|
47
|
+
1. **READ COMPLETELY**: Always read the entire step file before taking any action
|
|
48
|
+
2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
|
|
49
|
+
3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
|
|
50
|
+
4. **CHECK CONTINUATION**: Only proceed to next step when user selects [c] (Continue)
|
|
51
|
+
5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
|
|
52
|
+
6. **LOAD NEXT**: When directed, load and read entire next step file, then execute
|
|
53
|
+
|
|
54
|
+
### Critical Rules (NO EXCEPTIONS)
|
|
55
|
+
|
|
56
|
+
- **NEVER** load multiple step files simultaneously
|
|
57
|
+
- **ALWAYS** read entire step file before execution
|
|
58
|
+
- **NEVER** skip steps or optimize the sequence
|
|
59
|
+
- **ALWAYS** update frontmatter of output file when completing a step
|
|
60
|
+
- **ALWAYS** follow the exact instructions in the step file
|
|
61
|
+
- **ALWAYS** halt at menus and wait for user input
|
|
62
|
+
- **NEVER** create mental todo lists from future steps
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## INITIALIZATION SEQUENCE
|
|
67
|
+
|
|
68
|
+
### 1. Configuration Loading
|
|
69
|
+
|
|
70
|
+
Load and read full config from `{main_config}` and resolve:
|
|
71
|
+
|
|
72
|
+
- `project_name`, `output_folder`, `planning_artifacts`, `implementation_artifacts`, `user_name`
|
|
73
|
+
- `communication_language`, `document_output_language`, `user_skill_level`
|
|
74
|
+
- `date` as system-generated current datetime
|
|
75
|
+
- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
|
|
76
|
+
|
|
77
|
+
### 2. First Step Execution
|
|
78
|
+
|
|
79
|
+
Load, read the full file, and then execute `steps/step-01-understand.md` to begin the workflow.
|
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
# Document Project Workflow - Validation Checklist
|
|
2
|
+
|
|
3
|
+
## Scan Level and Resumability
|
|
4
|
+
|
|
5
|
+
- [ ] Scan level selection offered (quick/deep/exhaustive) for initial_scan and full_rescan modes
|
|
6
|
+
- [ ] Deep-dive mode automatically uses exhaustive scan (no choice given)
|
|
7
|
+
- [ ] Quick scan does NOT read source files (only patterns, configs, manifests)
|
|
8
|
+
- [ ] Deep scan reads files in critical directories per project type
|
|
9
|
+
- [ ] Exhaustive scan reads ALL source files (excluding node_modules, dist, build)
|
|
10
|
+
- [ ] State file (project-scan-report.json) created at workflow start
|
|
11
|
+
- [ ] State file updated after each step completion
|
|
12
|
+
- [ ] State file contains all required fields per schema
|
|
13
|
+
- [ ] Resumability prompt shown if state file exists and is <24 hours old
|
|
14
|
+
- [ ] Old state files (>24 hours) automatically archived
|
|
15
|
+
- [ ] Resume functionality loads previous state correctly
|
|
16
|
+
- [ ] Workflow can jump to correct step when resuming
|
|
17
|
+
|
|
18
|
+
## Write-as-you-go Architecture
|
|
19
|
+
|
|
20
|
+
- [ ] Each document written to disk IMMEDIATELY after generation
|
|
21
|
+
- [ ] Document validation performed right after writing (section-level)
|
|
22
|
+
- [ ] State file updated after each document is written
|
|
23
|
+
- [ ] Detailed findings purged from context after writing (only summaries kept)
|
|
24
|
+
- [ ] Context contains only high-level summaries (1-2 sentences per section)
|
|
25
|
+
- [ ] No accumulation of full project analysis in memory
|
|
26
|
+
|
|
27
|
+
## Batching Strategy (Deep/Exhaustive Scans)
|
|
28
|
+
|
|
29
|
+
- [ ] Batching applied for deep and exhaustive scan levels
|
|
30
|
+
- [ ] Batches organized by SUBFOLDER (not arbitrary file count)
|
|
31
|
+
- [ ] Large files (>5000 LOC) handled with appropriate judgment
|
|
32
|
+
- [ ] Each batch: read files, extract info, write output, validate, purge context
|
|
33
|
+
- [ ] Batch completion tracked in state file (batches_completed array)
|
|
34
|
+
- [ ] Batch summaries kept in context (1-2 sentences max)
|
|
35
|
+
|
|
36
|
+
## Project Detection and Classification
|
|
37
|
+
|
|
38
|
+
- [ ] Project type correctly identified and matches actual technology stack
|
|
39
|
+
- [ ] Multi-part vs single-part structure accurately detected
|
|
40
|
+
- [ ] All project parts identified if multi-part (no missing client/server/etc.)
|
|
41
|
+
- [ ] Documentation requirements loaded for each part type
|
|
42
|
+
- [ ] Architecture registry match is appropriate for detected stack
|
|
43
|
+
|
|
44
|
+
## Technology Stack Analysis
|
|
45
|
+
|
|
46
|
+
- [ ] All major technologies identified (framework, language, database, etc.)
|
|
47
|
+
- [ ] Versions captured where available
|
|
48
|
+
- [ ] Technology decision table is complete and accurate
|
|
49
|
+
- [ ] Dependencies and libraries documented
|
|
50
|
+
- [ ] Build tools and package managers identified
|
|
51
|
+
|
|
52
|
+
## Codebase Scanning Completeness
|
|
53
|
+
|
|
54
|
+
- [ ] All critical directories scanned based on project type
|
|
55
|
+
- [ ] API endpoints documented (if requires_api_scan = true)
|
|
56
|
+
- [ ] Data models captured (if requires_data_models = true)
|
|
57
|
+
- [ ] State management patterns identified (if requires_state_management = true)
|
|
58
|
+
- [ ] UI components inventoried (if requires_ui_components = true)
|
|
59
|
+
- [ ] Configuration files located and documented
|
|
60
|
+
- [ ] Authentication/security patterns identified
|
|
61
|
+
- [ ] Entry points correctly identified
|
|
62
|
+
- [ ] Integration points mapped (for multi-part projects)
|
|
63
|
+
- [ ] Test files and patterns documented
|
|
64
|
+
|
|
65
|
+
## Source Tree Analysis
|
|
66
|
+
|
|
67
|
+
- [ ] Complete directory tree generated with no major omissions
|
|
68
|
+
- [ ] Critical folders highlighted and described
|
|
69
|
+
- [ ] Entry points clearly marked
|
|
70
|
+
- [ ] Integration paths noted (for multi-part)
|
|
71
|
+
- [ ] Asset locations identified (if applicable)
|
|
72
|
+
- [ ] File organization patterns explained
|
|
73
|
+
|
|
74
|
+
## Architecture Documentation Quality
|
|
75
|
+
|
|
76
|
+
- [ ] Architecture document uses appropriate template from registry
|
|
77
|
+
- [ ] All template sections filled with relevant information (no placeholders)
|
|
78
|
+
- [ ] Technology stack section is comprehensive
|
|
79
|
+
- [ ] Architecture pattern clearly explained
|
|
80
|
+
- [ ] Data architecture documented (if applicable)
|
|
81
|
+
- [ ] API design documented (if applicable)
|
|
82
|
+
- [ ] Component structure explained (if applicable)
|
|
83
|
+
- [ ] Source tree included and annotated
|
|
84
|
+
- [ ] Testing strategy documented
|
|
85
|
+
- [ ] Deployment architecture captured (if config found)
|
|
86
|
+
|
|
87
|
+
## Development and Operations Documentation
|
|
88
|
+
|
|
89
|
+
- [ ] Prerequisites clearly listed
|
|
90
|
+
- [ ] Installation steps documented
|
|
91
|
+
- [ ] Environment setup instructions provided
|
|
92
|
+
- [ ] Local run commands specified
|
|
93
|
+
- [ ] Build process documented
|
|
94
|
+
- [ ] Test commands and approach explained
|
|
95
|
+
- [ ] Deployment process documented (if applicable)
|
|
96
|
+
- [ ] CI/CD pipeline details captured (if found)
|
|
97
|
+
- [ ] Contribution guidelines extracted (if found)
|
|
98
|
+
|
|
99
|
+
## Multi-Part Project Specific (if applicable)
|
|
100
|
+
|
|
101
|
+
- [ ] Each part documented separately
|
|
102
|
+
- [ ] Part-specific architecture files created (architecture-{part_id}.md)
|
|
103
|
+
- [ ] Part-specific component inventories created (if applicable)
|
|
104
|
+
- [ ] Part-specific development guides created
|
|
105
|
+
- [ ] Integration architecture document created
|
|
106
|
+
- [ ] Integration points clearly defined with type and details
|
|
107
|
+
- [ ] Data flow between parts explained
|
|
108
|
+
- [ ] project-parts.json metadata file created
|
|
109
|
+
|
|
110
|
+
## Index and Navigation
|
|
111
|
+
|
|
112
|
+
- [ ] index.md created as master entry point
|
|
113
|
+
- [ ] Project structure clearly summarized in index
|
|
114
|
+
- [ ] Quick reference section complete and accurate
|
|
115
|
+
- [ ] All generated docs linked from index
|
|
116
|
+
- [ ] All existing docs linked from index (if found)
|
|
117
|
+
- [ ] Getting started section provides clear next steps
|
|
118
|
+
- [ ] AI-assisted development guidance included
|
|
119
|
+
- [ ] Navigation structure matches project complexity (simple for single-part, detailed for multi-part)
|
|
120
|
+
|
|
121
|
+
## File Completeness
|
|
122
|
+
|
|
123
|
+
- [ ] index.md generated
|
|
124
|
+
- [ ] project-overview.md generated
|
|
125
|
+
- [ ] source-tree-analysis.md generated
|
|
126
|
+
- [ ] architecture.md (or per-part) generated
|
|
127
|
+
- [ ] component-inventory.md (or per-part) generated if UI components exist
|
|
128
|
+
- [ ] development-guide.md (or per-part) generated
|
|
129
|
+
- [ ] api-contracts.md (or per-part) generated if APIs documented
|
|
130
|
+
- [ ] data-models.md (or per-part) generated if data models found
|
|
131
|
+
- [ ] deployment-guide.md generated if deployment config found
|
|
132
|
+
- [ ] contribution-guide.md generated if guidelines found
|
|
133
|
+
- [ ] integration-architecture.md generated if multi-part
|
|
134
|
+
- [ ] project-parts.json generated if multi-part
|
|
135
|
+
|
|
136
|
+
## Content Quality
|
|
137
|
+
|
|
138
|
+
- [ ] Technical information is accurate and specific
|
|
139
|
+
- [ ] No generic placeholders or "TODO" items remain
|
|
140
|
+
- [ ] Examples and code snippets are relevant to actual project
|
|
141
|
+
- [ ] File paths and directory references are correct
|
|
142
|
+
- [ ] Technology names and versions are accurate
|
|
143
|
+
- [ ] Terminology is consistent across all documents
|
|
144
|
+
- [ ] Descriptions are clear and actionable
|
|
145
|
+
|
|
146
|
+
## Brownfield PRD Readiness
|
|
147
|
+
|
|
148
|
+
- [ ] Documentation provides enough context for AI to understand existing system
|
|
149
|
+
- [ ] Integration points are clear for planning new features
|
|
150
|
+
- [ ] Reusable components are identified for leveraging in new work
|
|
151
|
+
- [ ] Data models are documented for schema extension planning
|
|
152
|
+
- [ ] API contracts are documented for endpoint expansion
|
|
153
|
+
- [ ] Code conventions and patterns are captured for consistency
|
|
154
|
+
- [ ] Architecture constraints are clear for informed decision-making
|
|
155
|
+
|
|
156
|
+
## Output Validation
|
|
157
|
+
|
|
158
|
+
- [ ] All files saved to correct output folder
|
|
159
|
+
- [ ] File naming follows convention (no part suffix for single-part, with suffix for multi-part)
|
|
160
|
+
- [ ] No broken internal links between documents
|
|
161
|
+
- [ ] Markdown formatting is correct and renders properly
|
|
162
|
+
- [ ] JSON files are valid (project-parts.json if applicable)
|
|
163
|
+
|
|
164
|
+
## Final Validation
|
|
165
|
+
|
|
166
|
+
- [ ] User confirmed project classification is accurate
|
|
167
|
+
- [ ] User provided any additional context needed
|
|
168
|
+
- [ ] All requested areas of focus addressed
|
|
169
|
+
- [ ] Documentation is immediately usable for brownfield PRD workflow
|
|
170
|
+
- [ ] No critical information gaps identified
|
|
171
|
+
|
|
172
|
+
## Issues Found
|
|
173
|
+
|
|
174
|
+
### Critical Issues (must fix before completion)
|
|
175
|
+
|
|
176
|
+
-
|
|
177
|
+
|
|
178
|
+
### Minor Issues (can be addressed later)
|
|
179
|
+
|
|
180
|
+
-
|
|
181
|
+
|
|
182
|
+
### Missing Information (to note for user)
|
|
183
|
+
|
|
184
|
+
-
|
|
185
|
+
|
|
186
|
+
## Deep-Dive Mode Validation (if deep-dive was performed)
|
|
187
|
+
|
|
188
|
+
- [ ] Deep-dive target area correctly identified and scoped
|
|
189
|
+
- [ ] All files in target area read completely (no skipped files)
|
|
190
|
+
- [ ] File inventory includes all exports with complete signatures
|
|
191
|
+
- [ ] Dependencies mapped for all files
|
|
192
|
+
- [ ] Dependents identified (who imports each file)
|
|
193
|
+
- [ ] Code snippets included for key implementation details
|
|
194
|
+
- [ ] Patterns and design approaches documented
|
|
195
|
+
- [ ] State management strategy explained
|
|
196
|
+
- [ ] Side effects documented (API calls, DB queries, etc.)
|
|
197
|
+
- [ ] Error handling approaches captured
|
|
198
|
+
- [ ] Testing files and coverage documented
|
|
199
|
+
- [ ] TODOs and comments extracted
|
|
200
|
+
- [ ] Dependency graph created showing relationships
|
|
201
|
+
- [ ] Data flow traced through the scanned area
|
|
202
|
+
- [ ] Integration points with rest of codebase identified
|
|
203
|
+
- [ ] Related code and similar patterns found outside scanned area
|
|
204
|
+
- [ ] Reuse opportunities documented
|
|
205
|
+
- [ ] Implementation guidance provided
|
|
206
|
+
- [ ] Modification instructions clear
|
|
207
|
+
- [ ] Index.md updated with deep-dive link
|
|
208
|
+
- [ ] Deep-dive documentation is immediately useful for implementation
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
## State File Quality
|
|
213
|
+
|
|
214
|
+
- [ ] State file is valid JSON (no syntax errors)
|
|
215
|
+
- [ ] State file is optimized (no pretty-printing, minimal whitespace)
|
|
216
|
+
- [ ] State file contains all completed steps with timestamps
|
|
217
|
+
- [ ] State file outputs_generated list is accurate and complete
|
|
218
|
+
- [ ] State file resume_instructions are clear and actionable
|
|
219
|
+
- [ ] State file findings contain only high-level summaries (not detailed data)
|
|
220
|
+
- [ ] State file can be successfully loaded for resumption
|
|
221
|
+
|
|
222
|
+
## Completion Criteria
|
|
223
|
+
|
|
224
|
+
All items in the following sections must be checked:
|
|
225
|
+
|
|
226
|
+
- ✓ Scan Level and Resumability
|
|
227
|
+
- ✓ Write-as-you-go Architecture
|
|
228
|
+
- ✓ Batching Strategy (if deep/exhaustive scan)
|
|
229
|
+
- ✓ Project Detection and Classification
|
|
230
|
+
- ✓ Technology Stack Analysis
|
|
231
|
+
- ✓ Architecture Documentation Quality
|
|
232
|
+
- ✓ Index and Navigation
|
|
233
|
+
- ✓ File Completeness
|
|
234
|
+
- ✓ Brownfield PRD Readiness
|
|
235
|
+
- ✓ State File Quality
|
|
236
|
+
- ✓ Deep-Dive Mode Validation (if applicable)
|
|
237
|
+
|
|
238
|
+
The workflow is complete when:
|
|
239
|
+
|
|
240
|
+
1. All critical checklist items are satisfied
|
|
241
|
+
2. No critical issues remain
|
|
242
|
+
3. User has reviewed and approved the documentation
|
|
243
|
+
4. Generated docs are ready for use in brownfield PRD workflow
|
|
244
|
+
5. Deep-dive docs (if any) are comprehensive and implementation-ready
|
|
245
|
+
6. State file is valid and can enable resumption if interrupted
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
project_type_id,requires_api_scan,requires_data_models,requires_state_management,requires_ui_components,requires_deployment_config,key_file_patterns,critical_directories,integration_scan_patterns,test_file_patterns,config_patterns,auth_security_patterns,schema_migration_patterns,entry_point_patterns,shared_code_patterns,monorepo_workspace_patterns,async_event_patterns,ci_cd_patterns,asset_patterns,hardware_interface_patterns,protocol_schema_patterns,localization_patterns,requires_hardware_docs,requires_asset_inventory
|
|
2
|
+
web,true,true,true,true,true,package.json;tsconfig.json;*.config.js;*.config.ts;vite.config.*;webpack.config.*;next.config.*;nuxt.config.*,src/;app/;pages/;components/;api/;lib/;styles/;public/;static/,*client.ts;*service.ts;*api.ts;fetch*.ts;axios*.ts;*http*.ts,*.test.ts;*.spec.ts;*.test.tsx;*.spec.tsx;**/__tests__/**;**/*.test.*;**/*.spec.*,.env*;config/*;*.config.*;.config/;settings/,*auth*.ts;*session*.ts;middleware/auth*;*.guard.ts;*authenticat*;*permission*;guards/,migrations/**;prisma/**;*.prisma;alembic/**;knex/**;*migration*.sql;*migration*.ts,main.ts;index.ts;app.ts;server.ts;_app.tsx;_app.ts;layout.tsx,shared/**;common/**;utils/**;lib/**;helpers/**;@*/**;packages/**,pnpm-workspace.yaml;lerna.json;nx.json;turbo.json;workspace.json;rush.json,*event*.ts;*queue*.ts;*subscriber*.ts;*consumer*.ts;*producer*.ts;*worker*.ts;jobs/**,.github/workflows/**;.gitlab-ci.yml;Jenkinsfile;.circleci/**;azure-pipelines.yml;bitbucket-pipelines.yml,.drone.yml,public/**;static/**;assets/**;images/**;media/**,N/A,*.proto;*.graphql;graphql/**;schema.graphql;*.avro;openapi.*;swagger.*,i18n/**;locales/**;lang/**;translations/**;messages/**;*.po;*.pot,false,false
|
|
3
|
+
mobile,true,true,true,true,true,package.json;pubspec.yaml;Podfile;build.gradle;app.json;capacitor.config.*;ionic.config.json,src/;app/;screens/;components/;services/;models/;assets/;ios/;android/,*client.ts;*service.ts;*api.ts;fetch*.ts;axios*.ts;*http*.ts,*.test.ts;*.test.tsx;*_test.dart;*.test.dart;**/__tests__/**,.env*;config/*;app.json;capacitor.config.*;google-services.json;GoogleService-Info.plist,*auth*.ts;*session*.ts;*authenticat*;*permission*;*biometric*;secure-store*,migrations/**;realm/**;*.realm;watermelondb/**;sqlite/**,main.ts;index.ts;App.tsx;App.ts;main.dart,shared/**;common/**;utils/**;lib/**;components/shared/**;@*/**,pnpm-workspace.yaml;lerna.json;nx.json;turbo.json,*event*.ts;*notification*.ts;*push*.ts;background-fetch*,fastlane/**;.github/workflows/**;.gitlab-ci.yml;bitbucket-pipelines.yml;appcenter-*,assets/**;Resources/**;res/**;*.xcassets;drawable*/;mipmap*/;images/**,N/A,*.proto;graphql/**;*.graphql,i18n/**;locales/**;translations/**;*.strings;*.xml,false,true
|
|
4
|
+
backend,true,true,false,false,true,package.json;requirements.txt;go.mod;Gemfile;pom.xml;build.gradle;Cargo.toml;*.csproj,src/;api/;services/;models/;routes/;controllers/;middleware/;handlers/;repositories/;domain/,*client.ts;*repository.ts;*service.ts;*connector*.ts;*adapter*.ts,*.test.ts;*.spec.ts;*_test.go;test_*.py;*Test.java;*_test.rs,.env*;config/*;*.config.*;application*.yml;application*.yaml;appsettings*.json;settings.py,*auth*.ts;*session*.ts;*authenticat*;*authorization*;middleware/auth*;guards/;*jwt*;*oauth*,migrations/**;alembic/**;flyway/**;liquibase/**;prisma/**;*.prisma;*migration*.sql;*migration*.ts;db/migrate,main.ts;index.ts;server.ts;app.ts;main.go;main.py;Program.cs;__init__.py,shared/**;common/**;utils/**;lib/**;core/**;@*/**;pkg/**,pnpm-workspace.yaml;lerna.json;nx.json;go.work,*event*.ts;*queue*.ts;*subscriber*.ts;*consumer*.ts;*producer*.ts;*worker*.ts;*handler*.ts;jobs/**;workers/**,.github/workflows/**;.gitlab-ci.yml;Jenkinsfile;.circleci/**;azure-pipelines.yml;.drone.yml,N/A,N/A,*.proto;*.graphql;graphql/**;*.avro;*.thrift;openapi.*;swagger.*;schema/**,N/A,false,false
|
|
5
|
+
cli,false,false,false,false,false,package.json;go.mod;Cargo.toml;setup.py;pyproject.toml;*.gemspec,src/;cmd/;cli/;bin/;lib/;commands/,N/A,*.test.ts;*_test.go;test_*.py;*.spec.ts;*_spec.rb,.env*;config/*;*.config.*;.*.rc;.*rc,N/A,N/A,main.ts;index.ts;cli.ts;main.go;main.py;__main__.py;bin/*,shared/**;common/**;utils/**;lib/**;helpers/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml;goreleaser.yml,N/A,N/A,N/A,N/A,false,false
|
|
6
|
+
library,false,false,false,false,false,package.json;setup.py;Cargo.toml;go.mod;*.gemspec;*.csproj;pom.xml,src/;lib/;dist/;pkg/;build/;target/,N/A,*.test.ts;*_test.go;test_*.py;*.spec.ts;*Test.java;*_test.rs,.*.rc;tsconfig.json;rollup.config.*;vite.config.*;webpack.config.*,N/A,N/A,index.ts;index.js;lib.rs;main.go;__init__.py,src/**;lib/**;core/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml;.circleci/**,N/A,N/A,N/A,N/A,false,false
|
|
7
|
+
desktop,false,false,true,true,true,package.json;Cargo.toml;*.csproj;CMakeLists.txt;tauri.conf.json;electron-builder.yml;wails.json,src/;app/;components/;main/;renderer/;resources/;assets/;build/,*service.ts;ipc*.ts;*bridge*.ts;*native*.ts;invoke*,*.test.ts;*.spec.ts;*_test.rs;*.spec.tsx,.env*;config/*;*.config.*;app.config.*;forge.config.*;builder.config.*,*auth*.ts;*session*.ts;keychain*;secure-storage*,N/A,main.ts;index.ts;main.js;src-tauri/main.rs;electron.ts,shared/**;common/**;utils/**;lib/**;components/shared/**,N/A,*event*.ts;*ipc*.ts;*message*.ts,.github/workflows/**;.gitlab-ci.yml;.circleci/**,resources/**;assets/**;icons/**;static/**;build/resources,N/A,N/A,i18n/**;locales/**;translations/**;lang/**,false,true
|
|
8
|
+
game,false,false,true,false,false,*.unity;*.godot;*.uproject;package.json;project.godot,Assets/;Scenes/;Scripts/;Prefabs/;Resources/;Content/;Source/;src/;scenes/;scripts/,N/A,*Test.cs;*_test.gd;*Test.cpp;*.test.ts,.env*;config/*;*.ini;settings/;GameSettings/,N/A,N/A,main.gd;Main.cs;GameManager.cs;main.cpp;index.ts,shared/**;common/**;utils/**;Core/**;Framework/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml,Assets/**;Scenes/**;Prefabs/**;Materials/**;Textures/**;Audio/**;Models/**;*.fbx;*.blend;*.shader;*.hlsl;*.glsl;Shaders/**;VFX/**,N/A,N/A,Localization/**;Languages/**;i18n/**,false,true
|
|
9
|
+
data,false,true,false,false,true,requirements.txt;pyproject.toml;dbt_project.yml;airflow.cfg;setup.py;Pipfile,dags/;pipelines/;models/;transformations/;notebooks/;sql/;etl/;jobs/,N/A,test_*.py;*_test.py;tests/**,.env*;config/*;profiles.yml;dbt_project.yml;airflow.cfg,N/A,migrations/**;dbt/models/**;*.sql;schemas/**,main.py;__init__.py;pipeline.py;dag.py,shared/**;common/**;utils/**;lib/**;helpers/**,N/A,*event*.py;*consumer*.py;*producer*.py;*worker*.py;jobs/**;tasks/**,.github/workflows/**;.gitlab-ci.yml;airflow/dags/**,N/A,N/A,*.proto;*.avro;schemas/**;*.parquet,N/A,false,false
|
|
10
|
+
extension,true,false,true,true,false,manifest.json;package.json;wxt.config.ts,src/;popup/;content/;background/;assets/;components/,*message.ts;*runtime.ts;*storage.ts;*tabs.ts,*.test.ts;*.spec.ts;*.test.tsx,.env*;wxt.config.*;webpack.config.*;vite.config.*,*auth*.ts;*session*.ts;*permission*,N/A,index.ts;popup.ts;background.ts;content.ts,shared/**;common/**;utils/**;lib/**,N/A,*message*.ts;*event*.ts;chrome.runtime*;browser.runtime*,.github/workflows/**,assets/**;icons/**;images/**;static/**,N/A,N/A,_locales/**;locales/**;i18n/**,false,false
|
|
11
|
+
infra,false,false,false,false,true,*.tf;*.tfvars;pulumi.yaml;cdk.json;*.yml;*.yaml;Dockerfile;docker-compose*.yml,terraform/;modules/;k8s/;charts/;playbooks/;roles/;policies/;stacks/,N/A,*_test.go;test_*.py;*_test.tf;*_spec.rb,.env*;*.tfvars;config/*;vars/;group_vars/;host_vars/,N/A,N/A,main.tf;index.ts;__main__.py;playbook.yml,modules/**;shared/**;common/**;lib/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml;.circleci/**,N/A,N/A,N/A,N/A,false,false
|
|
12
|
+
embedded,false,false,false,false,false,platformio.ini;CMakeLists.txt;*.ino;Makefile;*.ioc;mbed-os.lib,src/;lib/;include/;firmware/;drivers/;hal/;bsp/;components/,N/A,test_*.c;*_test.cpp;*_test.c;tests/**,.env*;config/*;sdkconfig;*.json;settings/,N/A,N/A,main.c;main.cpp;main.ino;app_main.c,lib/**;shared/**;common/**;drivers/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml,N/A,*.h;*.hpp;drivers/**;hal/**;bsp/**;pinout.*;peripheral*;gpio*;*.fzz;schematics/**,*.proto;mqtt*;coap*;modbus*,N/A,true,false
|