bmad-method-test-architecture-enterprise 0.1.1-beta.0

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.
Files changed (320) hide show
  1. package/.github/CODE_OF_CONDUCT.md +128 -0
  2. package/.github/FUNDING.yaml +15 -0
  3. package/.github/ISSUE_TEMPLATE/config.yaml +11 -0
  4. package/.github/ISSUE_TEMPLATE/feature_request.md +70 -0
  5. package/.github/ISSUE_TEMPLATE/issue.md +61 -0
  6. package/.github/workflows/docs.yaml +66 -0
  7. package/.github/workflows/manual-release.yaml +195 -0
  8. package/.github/workflows/quality.yaml +114 -0
  9. package/.husky/pre-commit +20 -0
  10. package/.markdownlint-cli2.yaml +36 -0
  11. package/.nvmrc +1 -0
  12. package/.prettierignore +9 -0
  13. package/.vscode/settings.json +47 -0
  14. package/CHANGELOG.md +217 -0
  15. package/CONTRIBUTING.md +268 -0
  16. package/LICENSE +26 -0
  17. package/README.md +300 -0
  18. package/SECURITY.md +85 -0
  19. package/TEA-MODULE-MIGRATION-PLAN.md +3788 -0
  20. package/docs/404.md +20 -0
  21. package/docs/MIGRATION.md +447 -0
  22. package/docs/explanation/engagement-models.md +767 -0
  23. package/docs/explanation/fixture-architecture.md +484 -0
  24. package/docs/explanation/knowledge-base-system.md +599 -0
  25. package/docs/explanation/network-first-patterns.md +884 -0
  26. package/docs/explanation/risk-based-testing.md +628 -0
  27. package/docs/explanation/step-file-architecture.md +609 -0
  28. package/docs/explanation/subprocess-architecture.md +578 -0
  29. package/docs/explanation/subprocess-implementation-status.md +327 -0
  30. package/docs/explanation/tea-overview.md +425 -0
  31. package/docs/explanation/test-quality-standards.md +965 -0
  32. package/docs/explanation/testing-as-engineering.md +111 -0
  33. package/docs/glossary/index.md +160 -0
  34. package/docs/how-to/brownfield/use-tea-for-enterprise.md +571 -0
  35. package/docs/how-to/brownfield/use-tea-with-existing-tests.md +631 -0
  36. package/docs/how-to/customization/enable-tea-mcp-enhancements.md +455 -0
  37. package/docs/how-to/customization/integrate-playwright-utils.md +846 -0
  38. package/docs/how-to/workflows/run-atdd.md +460 -0
  39. package/docs/how-to/workflows/run-automate.md +690 -0
  40. package/docs/how-to/workflows/run-nfr-assess.md +731 -0
  41. package/docs/how-to/workflows/run-test-design.md +144 -0
  42. package/docs/how-to/workflows/run-test-review.md +638 -0
  43. package/docs/how-to/workflows/run-trace.md +951 -0
  44. package/docs/how-to/workflows/setup-ci.md +761 -0
  45. package/docs/how-to/workflows/setup-test-framework.md +99 -0
  46. package/docs/index.md +122 -0
  47. package/docs/reference/commands.md +300 -0
  48. package/docs/reference/configuration.md +729 -0
  49. package/docs/reference/knowledge-base.md +365 -0
  50. package/docs/reference/troubleshooting.md +717 -0
  51. package/docs/tutorials/tea-lite-quickstart.md +465 -0
  52. package/eslint.config.mjs +152 -0
  53. package/package.json +117 -0
  54. package/prettier.config.mjs +32 -0
  55. package/release_notes.md +28 -0
  56. package/src/_module-installer/installer.js +92 -0
  57. package/src/agents/tea.agent.yaml +63 -0
  58. package/src/module-help.csv +9 -0
  59. package/src/module.yaml +91 -0
  60. package/src/testarch/knowledge/adr-quality-readiness-checklist.md +377 -0
  61. package/src/testarch/knowledge/api-request.md +442 -0
  62. package/src/testarch/knowledge/api-testing-patterns.md +851 -0
  63. package/src/testarch/knowledge/auth-session.md +548 -0
  64. package/src/testarch/knowledge/burn-in.md +273 -0
  65. package/src/testarch/knowledge/ci-burn-in.md +675 -0
  66. package/src/testarch/knowledge/component-tdd.md +486 -0
  67. package/src/testarch/knowledge/contract-testing.md +957 -0
  68. package/src/testarch/knowledge/data-factories.md +500 -0
  69. package/src/testarch/knowledge/email-auth.md +721 -0
  70. package/src/testarch/knowledge/error-handling.md +725 -0
  71. package/src/testarch/knowledge/feature-flags.md +750 -0
  72. package/src/testarch/knowledge/file-utils.md +456 -0
  73. package/src/testarch/knowledge/fixture-architecture.md +401 -0
  74. package/src/testarch/knowledge/fixtures-composition.md +382 -0
  75. package/src/testarch/knowledge/intercept-network-call.md +426 -0
  76. package/src/testarch/knowledge/log.md +426 -0
  77. package/src/testarch/knowledge/network-error-monitor.md +401 -0
  78. package/src/testarch/knowledge/network-first.md +486 -0
  79. package/src/testarch/knowledge/network-recorder.md +527 -0
  80. package/src/testarch/knowledge/nfr-criteria.md +670 -0
  81. package/src/testarch/knowledge/overview.md +286 -0
  82. package/src/testarch/knowledge/playwright-config.md +730 -0
  83. package/src/testarch/knowledge/probability-impact.md +601 -0
  84. package/src/testarch/knowledge/recurse.md +421 -0
  85. package/src/testarch/knowledge/risk-governance.md +615 -0
  86. package/src/testarch/knowledge/selective-testing.md +732 -0
  87. package/src/testarch/knowledge/selector-resilience.md +527 -0
  88. package/src/testarch/knowledge/test-healing-patterns.md +644 -0
  89. package/src/testarch/knowledge/test-levels-framework.md +473 -0
  90. package/src/testarch/knowledge/test-priorities-matrix.md +373 -0
  91. package/src/testarch/knowledge/test-quality.md +664 -0
  92. package/src/testarch/knowledge/timing-debugging.md +372 -0
  93. package/src/testarch/knowledge/visual-debugging.md +524 -0
  94. package/src/testarch/tea-index.csv +35 -0
  95. package/src/workflows/testarch/README.md +74 -0
  96. package/src/workflows/testarch/atdd/atdd-checklist-template.md +363 -0
  97. package/src/workflows/testarch/atdd/checklist.md +374 -0
  98. package/src/workflows/testarch/atdd/instructions.md +38 -0
  99. package/src/workflows/testarch/atdd/steps-c/step-01-preflight-and-context.md +110 -0
  100. package/src/workflows/testarch/atdd/steps-c/step-02-generation-mode.md +79 -0
  101. package/src/workflows/testarch/atdd/steps-c/step-03-test-strategy.md +76 -0
  102. package/src/workflows/testarch/atdd/steps-c/step-04-generate-tests.md +228 -0
  103. package/src/workflows/testarch/atdd/steps-c/step-04a-subprocess-api-failing.md +215 -0
  104. package/src/workflows/testarch/atdd/steps-c/step-04b-subprocess-e2e-failing.md +212 -0
  105. package/src/workflows/testarch/atdd/steps-c/step-04c-aggregate.md +329 -0
  106. package/src/workflows/testarch/atdd/steps-c/step-05-validate-and-complete.md +68 -0
  107. package/src/workflows/testarch/atdd/steps-e/step-01-assess.md +65 -0
  108. package/src/workflows/testarch/atdd/steps-e/step-02-apply-edit.md +60 -0
  109. package/src/workflows/testarch/atdd/steps-v/step-01-validate.md +67 -0
  110. package/src/workflows/testarch/atdd/validation-report-20260127-095021.md +73 -0
  111. package/src/workflows/testarch/atdd/validation-report-20260127-102401.md +116 -0
  112. package/src/workflows/testarch/atdd/workflow-plan.md +21 -0
  113. package/src/workflows/testarch/atdd/workflow.md +39 -0
  114. package/src/workflows/testarch/atdd/workflow.yaml +47 -0
  115. package/src/workflows/testarch/automate/checklist.md +582 -0
  116. package/src/workflows/testarch/automate/instructions.md +43 -0
  117. package/src/workflows/testarch/automate/steps-c/step-01-preflight-and-context.md +127 -0
  118. package/src/workflows/testarch/automate/steps-c/step-02-identify-targets.md +95 -0
  119. package/src/workflows/testarch/automate/steps-c/step-03-generate-tests.md +199 -0
  120. package/src/workflows/testarch/automate/steps-c/step-03a-subprocess-api.md +183 -0
  121. package/src/workflows/testarch/automate/steps-c/step-03b-subprocess-e2e.md +181 -0
  122. package/src/workflows/testarch/automate/steps-c/step-03c-aggregate.md +300 -0
  123. package/src/workflows/testarch/automate/steps-c/step-04-validate-and-summarize.md +69 -0
  124. package/src/workflows/testarch/automate/steps-e/step-01-assess.md +65 -0
  125. package/src/workflows/testarch/automate/steps-e/step-02-apply-edit.md +60 -0
  126. package/src/workflows/testarch/automate/steps-v/step-01-validate.md +67 -0
  127. package/src/workflows/testarch/automate/validation-report-20260127-095021.md +72 -0
  128. package/src/workflows/testarch/automate/validation-report-20260127-102401.md +114 -0
  129. package/src/workflows/testarch/automate/workflow-plan.md +20 -0
  130. package/src/workflows/testarch/automate/workflow.md +39 -0
  131. package/src/workflows/testarch/automate/workflow.yaml +54 -0
  132. package/src/workflows/testarch/ci/checklist.md +247 -0
  133. package/src/workflows/testarch/ci/github-actions-template.yaml +198 -0
  134. package/src/workflows/testarch/ci/gitlab-ci-template.yaml +149 -0
  135. package/src/workflows/testarch/ci/instructions.md +38 -0
  136. package/src/workflows/testarch/ci/steps-c/step-01-preflight.md +92 -0
  137. package/src/workflows/testarch/ci/steps-c/step-02-generate-pipeline.md +82 -0
  138. package/src/workflows/testarch/ci/steps-c/step-03-configure-quality-gates.md +75 -0
  139. package/src/workflows/testarch/ci/steps-c/step-04-validate-and-summary.md +67 -0
  140. package/src/workflows/testarch/ci/steps-e/step-01-assess.md +65 -0
  141. package/src/workflows/testarch/ci/steps-e/step-02-apply-edit.md +60 -0
  142. package/src/workflows/testarch/ci/steps-v/step-01-validate.md +67 -0
  143. package/src/workflows/testarch/ci/validation-report-20260127-095021.md +72 -0
  144. package/src/workflows/testarch/ci/validation-report-20260127-102401.md +114 -0
  145. package/src/workflows/testarch/ci/workflow-plan.md +20 -0
  146. package/src/workflows/testarch/ci/workflow.md +39 -0
  147. package/src/workflows/testarch/ci/workflow.yaml +47 -0
  148. package/src/workflows/testarch/framework/checklist.md +320 -0
  149. package/src/workflows/testarch/framework/instructions.md +38 -0
  150. package/src/workflows/testarch/framework/steps-c/step-01-preflight.md +75 -0
  151. package/src/workflows/testarch/framework/steps-c/step-02-select-framework.md +73 -0
  152. package/src/workflows/testarch/framework/steps-c/step-03-scaffold-framework.md +120 -0
  153. package/src/workflows/testarch/framework/steps-c/step-04-docs-and-scripts.md +70 -0
  154. package/src/workflows/testarch/framework/steps-c/step-05-validate-and-summary.md +68 -0
  155. package/src/workflows/testarch/framework/steps-e/step-01-assess.md +65 -0
  156. package/src/workflows/testarch/framework/steps-e/step-02-apply-edit.md +60 -0
  157. package/src/workflows/testarch/framework/steps-v/step-01-validate.md +67 -0
  158. package/src/workflows/testarch/framework/validation-report-20260127-095021.md +73 -0
  159. package/src/workflows/testarch/framework/validation-report-20260127-102401.md +116 -0
  160. package/src/workflows/testarch/framework/workflow-plan.md +22 -0
  161. package/src/workflows/testarch/framework/workflow.md +39 -0
  162. package/src/workflows/testarch/framework/workflow.yaml +49 -0
  163. package/src/workflows/testarch/nfr-assess/checklist.md +407 -0
  164. package/src/workflows/testarch/nfr-assess/instructions.md +36 -0
  165. package/src/workflows/testarch/nfr-assess/nfr-report-template.md +462 -0
  166. package/src/workflows/testarch/nfr-assess/steps-c/step-01-load-context.md +85 -0
  167. package/src/workflows/testarch/nfr-assess/steps-c/step-02-define-thresholds.md +82 -0
  168. package/src/workflows/testarch/nfr-assess/steps-c/step-03-gather-evidence.md +64 -0
  169. package/src/workflows/testarch/nfr-assess/steps-c/step-04-evaluate-and-score.md +140 -0
  170. package/src/workflows/testarch/nfr-assess/steps-c/step-04a-subprocess-security.md +138 -0
  171. package/src/workflows/testarch/nfr-assess/steps-c/step-04b-subprocess-performance.md +84 -0
  172. package/src/workflows/testarch/nfr-assess/steps-c/step-04c-subprocess-reliability.md +85 -0
  173. package/src/workflows/testarch/nfr-assess/steps-c/step-04d-subprocess-scalability.md +88 -0
  174. package/src/workflows/testarch/nfr-assess/steps-c/step-04e-aggregate-nfr.md +219 -0
  175. package/src/workflows/testarch/nfr-assess/steps-c/step-05-generate-report.md +71 -0
  176. package/src/workflows/testarch/nfr-assess/steps-e/step-01-assess.md +65 -0
  177. package/src/workflows/testarch/nfr-assess/steps-e/step-02-apply-edit.md +60 -0
  178. package/src/workflows/testarch/nfr-assess/steps-v/step-01-validate.md +67 -0
  179. package/src/workflows/testarch/nfr-assess/validation-report-20260127-095021.md +73 -0
  180. package/src/workflows/testarch/nfr-assess/validation-report-20260127-102401.md +116 -0
  181. package/src/workflows/testarch/nfr-assess/workflow-plan.md +19 -0
  182. package/src/workflows/testarch/nfr-assess/workflow.md +39 -0
  183. package/src/workflows/testarch/nfr-assess/workflow.yaml +49 -0
  184. package/src/workflows/testarch/test-design/checklist.md +410 -0
  185. package/src/workflows/testarch/test-design/instructions.md +52 -0
  186. package/src/workflows/testarch/test-design/steps-c/step-01-detect-mode.md +109 -0
  187. package/src/workflows/testarch/test-design/steps-c/step-02-load-context.md +127 -0
  188. package/src/workflows/testarch/test-design/steps-c/step-03-risk-and-testability.md +85 -0
  189. package/src/workflows/testarch/test-design/steps-c/step-04-coverage-plan.md +98 -0
  190. package/src/workflows/testarch/test-design/steps-c/step-05-generate-output.md +97 -0
  191. package/src/workflows/testarch/test-design/steps-e/step-01-assess.md +65 -0
  192. package/src/workflows/testarch/test-design/steps-e/step-02-apply-edit.md +60 -0
  193. package/src/workflows/testarch/test-design/steps-v/step-01-validate.md +67 -0
  194. package/src/workflows/testarch/test-design/test-design-architecture-template.md +222 -0
  195. package/src/workflows/testarch/test-design/test-design-qa-template.md +296 -0
  196. package/src/workflows/testarch/test-design/test-design-template.md +294 -0
  197. package/src/workflows/testarch/test-design/validation-report-20260127-095021.md +73 -0
  198. package/src/workflows/testarch/test-design/validation-report-20260127-102401.md +116 -0
  199. package/src/workflows/testarch/test-design/workflow-plan.md +22 -0
  200. package/src/workflows/testarch/test-design/workflow.md +39 -0
  201. package/src/workflows/testarch/test-design/workflow.yaml +71 -0
  202. package/src/workflows/testarch/test-review/checklist.md +472 -0
  203. package/src/workflows/testarch/test-review/instructions.md +36 -0
  204. package/src/workflows/testarch/test-review/steps-c/step-01-load-context.md +101 -0
  205. package/src/workflows/testarch/test-review/steps-c/step-02-discover-tests.md +69 -0
  206. package/src/workflows/testarch/test-review/steps-c/step-03-quality-evaluation.md +184 -0
  207. package/src/workflows/testarch/test-review/steps-c/step-03a-subprocess-determinism.md +214 -0
  208. package/src/workflows/testarch/test-review/steps-c/step-03b-subprocess-isolation.md +125 -0
  209. package/src/workflows/testarch/test-review/steps-c/step-03c-subprocess-maintainability.md +102 -0
  210. package/src/workflows/testarch/test-review/steps-c/step-03d-subprocess-coverage.md +111 -0
  211. package/src/workflows/testarch/test-review/steps-c/step-03e-subprocess-performance.md +117 -0
  212. package/src/workflows/testarch/test-review/steps-c/step-03f-aggregate-scores.md +246 -0
  213. package/src/workflows/testarch/test-review/steps-c/step-04-generate-report.md +72 -0
  214. package/src/workflows/testarch/test-review/steps-e/step-01-assess.md +65 -0
  215. package/src/workflows/testarch/test-review/steps-e/step-02-apply-edit.md +60 -0
  216. package/src/workflows/testarch/test-review/steps-v/step-01-validate.md +67 -0
  217. package/src/workflows/testarch/test-review/test-review-template.md +390 -0
  218. package/src/workflows/testarch/test-review/validation-report-20260127-095021.md +72 -0
  219. package/src/workflows/testarch/test-review/validation-report-20260127-102401.md +114 -0
  220. package/src/workflows/testarch/test-review/workflow-plan.md +18 -0
  221. package/src/workflows/testarch/test-review/workflow.md +39 -0
  222. package/src/workflows/testarch/test-review/workflow.yaml +48 -0
  223. package/src/workflows/testarch/trace/checklist.md +642 -0
  224. package/src/workflows/testarch/trace/instructions.md +36 -0
  225. package/src/workflows/testarch/trace/steps-c/step-01-load-context.md +80 -0
  226. package/src/workflows/testarch/trace/steps-c/step-02-discover-tests.md +69 -0
  227. package/src/workflows/testarch/trace/steps-c/step-03-map-criteria.md +65 -0
  228. package/src/workflows/testarch/trace/steps-c/step-04-analyze-gaps.md +244 -0
  229. package/src/workflows/testarch/trace/steps-c/step-05-gate-decision.md +232 -0
  230. package/src/workflows/testarch/trace/steps-e/step-01-assess.md +65 -0
  231. package/src/workflows/testarch/trace/steps-e/step-02-apply-edit.md +60 -0
  232. package/src/workflows/testarch/trace/steps-v/step-01-validate.md +67 -0
  233. package/src/workflows/testarch/trace/trace-template.md +675 -0
  234. package/src/workflows/testarch/trace/validation-report-20260127-095021.md +73 -0
  235. package/src/workflows/testarch/trace/validation-report-20260127-102401.md +116 -0
  236. package/src/workflows/testarch/trace/workflow-plan.md +21 -0
  237. package/src/workflows/testarch/trace/workflow.md +39 -0
  238. package/src/workflows/testarch/trace/workflow.yaml +57 -0
  239. package/test/README.md +23 -0
  240. package/test/fixtures/agent-schema/invalid/critical-actions/actions-as-string.agent.yaml +27 -0
  241. package/test/fixtures/agent-schema/invalid/critical-actions/empty-string-in-actions.agent.yaml +30 -0
  242. package/test/fixtures/agent-schema/invalid/menu/empty-menu.agent.yaml +22 -0
  243. package/test/fixtures/agent-schema/invalid/menu/missing-menu.agent.yaml +20 -0
  244. package/test/fixtures/agent-schema/invalid/menu-commands/empty-command-target.agent.yaml +25 -0
  245. package/test/fixtures/agent-schema/invalid/menu-commands/no-command-target.agent.yaml +24 -0
  246. package/test/fixtures/agent-schema/invalid/menu-triggers/camel-case.agent.yaml +25 -0
  247. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-invalid-format.agent.yaml +25 -0
  248. package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml +25 -0
  249. package/test/fixtures/agent-schema/invalid/menu-triggers/duplicate-triggers.agent.yaml +31 -0
  250. package/test/fixtures/agent-schema/invalid/menu-triggers/empty-trigger.agent.yaml +25 -0
  251. package/test/fixtures/agent-schema/invalid/menu-triggers/leading-asterisk.agent.yaml +25 -0
  252. package/test/fixtures/agent-schema/invalid/menu-triggers/snake-case.agent.yaml +25 -0
  253. package/test/fixtures/agent-schema/invalid/menu-triggers/trigger-with-spaces.agent.yaml +25 -0
  254. package/test/fixtures/agent-schema/invalid/metadata/empty-module-string.agent.yaml +26 -0
  255. package/test/fixtures/agent-schema/invalid/metadata/empty-name.agent.yaml +24 -0
  256. package/test/fixtures/agent-schema/invalid/metadata/extra-metadata-fields.agent.yaml +27 -0
  257. package/test/fixtures/agent-schema/invalid/metadata/missing-id.agent.yaml +23 -0
  258. package/test/fixtures/agent-schema/invalid/persona/empty-principles-array.agent.yaml +24 -0
  259. package/test/fixtures/agent-schema/invalid/persona/empty-string-in-principles.agent.yaml +27 -0
  260. package/test/fixtures/agent-schema/invalid/persona/extra-persona-fields.agent.yaml +27 -0
  261. package/test/fixtures/agent-schema/invalid/persona/missing-role.agent.yaml +24 -0
  262. package/test/fixtures/agent-schema/invalid/prompts/empty-content.agent.yaml +29 -0
  263. package/test/fixtures/agent-schema/invalid/prompts/extra-prompt-fields.agent.yaml +31 -0
  264. package/test/fixtures/agent-schema/invalid/prompts/missing-content.agent.yaml +28 -0
  265. package/test/fixtures/agent-schema/invalid/prompts/missing-id.agent.yaml +28 -0
  266. package/test/fixtures/agent-schema/invalid/top-level/empty-file.agent.yaml +5 -0
  267. package/test/fixtures/agent-schema/invalid/top-level/extra-top-level-keys.agent.yaml +28 -0
  268. package/test/fixtures/agent-schema/invalid/top-level/missing-agent-key.agent.yaml +11 -0
  269. package/test/fixtures/agent-schema/invalid/yaml-errors/invalid-indentation.agent.yaml +19 -0
  270. package/test/fixtures/agent-schema/invalid/yaml-errors/malformed-yaml.agent.yaml +18 -0
  271. package/test/fixtures/agent-schema/valid/critical-actions/empty-critical-actions.agent.yaml +24 -0
  272. package/test/fixtures/agent-schema/valid/critical-actions/no-critical-actions.agent.yaml +22 -0
  273. package/test/fixtures/agent-schema/valid/critical-actions/valid-critical-actions.agent.yaml +27 -0
  274. package/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml +31 -0
  275. package/test/fixtures/agent-schema/valid/menu/single-menu-item.agent.yaml +22 -0
  276. package/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml +38 -0
  277. package/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml +24 -0
  278. package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml +31 -0
  279. package/test/fixtures/agent-schema/valid/menu-triggers/kebab-case-triggers.agent.yaml +34 -0
  280. package/test/fixtures/agent-schema/valid/metadata/core-agent-with-module.agent.yaml +24 -0
  281. package/test/fixtures/agent-schema/valid/metadata/empty-module-name-in-path.agent.yaml +24 -0
  282. package/test/fixtures/agent-schema/valid/metadata/malformed-path-treated-as-core.agent.yaml +24 -0
  283. package/test/fixtures/agent-schema/valid/metadata/module-agent-correct.agent.yaml +24 -0
  284. package/test/fixtures/agent-schema/valid/metadata/module-agent-missing-module.agent.yaml +23 -0
  285. package/test/fixtures/agent-schema/valid/metadata/wrong-module-value.agent.yaml +24 -0
  286. package/test/fixtures/agent-schema/valid/persona/complete-persona.agent.yaml +24 -0
  287. package/test/fixtures/agent-schema/valid/prompts/empty-prompts.agent.yaml +24 -0
  288. package/test/fixtures/agent-schema/valid/prompts/no-prompts.agent.yaml +22 -0
  289. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-minimal.agent.yaml +28 -0
  290. package/test/fixtures/agent-schema/valid/prompts/valid-prompts-with-description.agent.yaml +30 -0
  291. package/test/fixtures/agent-schema/valid/top-level/minimal-core-agent.agent.yaml +24 -0
  292. package/test/schema/agent.js +491 -0
  293. package/test/test-agent-schema.js +387 -0
  294. package/test/test-installation-components.js +183 -0
  295. package/test/test-knowledge-base.js +199 -0
  296. package/test/unit-test-schema.js +133 -0
  297. package/test/validate-agent-schema.js +110 -0
  298. package/tools/build-docs.js +575 -0
  299. package/tools/fix-doc-links.js +288 -0
  300. package/tools/schema/agent.js +491 -0
  301. package/tools/validate-agent-schema.js +111 -0
  302. package/tools/validate-doc-links.js +371 -0
  303. package/tools/verify-paths.js +100 -0
  304. package/website/README.md +137 -0
  305. package/website/astro.config.mjs +158 -0
  306. package/website/package-lock.json +6856 -0
  307. package/website/package.json +23 -0
  308. package/website/public/favicon.ico +0 -0
  309. package/website/public/img/tea-logo.svg +7 -0
  310. package/website/public/robots.txt +37 -0
  311. package/website/src/components/Banner.astro +59 -0
  312. package/website/src/components/Header.astro +121 -0
  313. package/website/src/components/MobileMenuFooter.astro +53 -0
  314. package/website/src/content/config.ts +6 -0
  315. package/website/src/lib/site-url.js +25 -0
  316. package/website/src/pages/404.astro +11 -0
  317. package/website/src/rehype-base-paths.js +89 -0
  318. package/website/src/rehype-markdown-links.js +117 -0
  319. package/website/src/styles/custom.css +499 -0
  320. package/website/tsconfig.json +9 -0
@@ -0,0 +1,499 @@
1
+ /**
2
+ * BMAD Method Documentation - Custom Styles for Starlight
3
+ * Electric Blue theme optimized for dark mode
4
+ *
5
+ * CSS Variable Mapping:
6
+ * Docusaurus → Starlight
7
+ * --ifm-color-primary → --sl-color-accent
8
+ * --ifm-background-color → --sl-color-bg
9
+ * --ifm-font-color-base → --sl-color-text
10
+ */
11
+
12
+ /* ============================================
13
+ COLOR PALETTE - Light Mode
14
+ ============================================ */
15
+ :root {
16
+ --ai-banner-height: 2.75rem;
17
+ --sl-nav-height: 6.25rem; /* Base nav height (~3.5rem) + banner height (2.75rem) */
18
+
19
+ /* Full-width content - override Starlight's default 45rem/67.5rem */
20
+ --sl-content-width: 100%;
21
+
22
+ /* Primary accent colors - purple to match Docusaurus */
23
+ --sl-color-accent-low: #e0e0ff;
24
+ --sl-color-accent: #8c8cff;
25
+ --sl-color-accent-high: #4141ff;
26
+
27
+ /* Text colors */
28
+ --sl-color-white: #1e293b;
29
+ --sl-color-gray-1: #334155;
30
+ --sl-color-gray-2: #475569;
31
+ --sl-color-gray-3: #64748b;
32
+ --sl-color-gray-4: #94a3b8;
33
+ --sl-color-gray-5: #cbd5e1;
34
+ --sl-color-gray-6: #e2e8f0;
35
+ --sl-color-black: #f8fafc;
36
+
37
+ /* Font settings */
38
+ --sl-font: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
39
+ --sl-text-base: 1rem;
40
+ --sl-line-height: 1.7;
41
+
42
+ /* Code highlighting */
43
+ --sl-color-bg-inline-code: rgba(140, 140, 255, 0.1);
44
+ }
45
+
46
+ /* ============================================
47
+ COLOR PALETTE - Dark Mode (Primary Focus)
48
+ ============================================ */
49
+ :root[data-theme='dark'] {
50
+ /* Full-width content - override Starlight's default */
51
+ --sl-content-width: 100%;
52
+
53
+ /* Primary accent colors - purple to match Docusaurus */
54
+ --sl-color-accent-low: #2a2a5a;
55
+ --sl-color-accent: #8c8cff;
56
+ --sl-color-accent-high: #b9b9ff;
57
+
58
+ /* Background colors */
59
+ --sl-color-bg: #1b1b1d;
60
+ --sl-color-bg-nav: #1b1b1d;
61
+ --sl-color-bg-sidebar: #1b1b1d;
62
+ --sl-color-hairline-light: rgba(140, 140, 255, 0.1);
63
+ --sl-color-hairline: rgba(140, 140, 255, 0.15);
64
+
65
+ /* Text colors */
66
+ --sl-color-white: #f8fafc;
67
+ --sl-color-gray-1: #e2e8f0;
68
+ --sl-color-gray-2: #cbd5e1;
69
+ --sl-color-gray-3: #94a3b8;
70
+ --sl-color-gray-4: #64748b;
71
+ --sl-color-gray-5: #475569;
72
+ --sl-color-gray-6: #334155;
73
+ --sl-color-black: #1b1b1d;
74
+
75
+ /* Code highlighting */
76
+ --sl-color-bg-inline-code: rgba(140, 140, 255, 0.15);
77
+ }
78
+
79
+ /* ============================================
80
+ TYPOGRAPHY
81
+ ============================================ */
82
+ .sl-markdown-content h1 {
83
+ margin-bottom: 1.5rem;
84
+ }
85
+
86
+ .sl-markdown-content h2 {
87
+ margin-top: 2.5rem;
88
+ margin-bottom: 1rem;
89
+ }
90
+
91
+ .sl-markdown-content h3 {
92
+ margin-top: 2rem;
93
+ margin-bottom: 0.75rem;
94
+ }
95
+
96
+ .sl-markdown-content p {
97
+ margin-bottom: 1.25rem;
98
+ }
99
+
100
+ /* ============================================
101
+ SIDEBAR & NAVIGATION
102
+ Clean styling inspired by React Native docs
103
+ ============================================ */
104
+
105
+ /* Base transition for all sidebar links */
106
+ .sidebar-content a {
107
+ transition:
108
+ background-color 0.15s ease,
109
+ color 0.15s ease,
110
+ border-color 0.15s ease;
111
+ border-radius: 4px;
112
+ }
113
+
114
+ /* Top-level sidebar items (Diataxis categories) */
115
+ .sidebar-content > ul > li > details > summary,
116
+ .sidebar-content > ul > li > a {
117
+ font-weight: 700;
118
+ font-size: 0.9375rem;
119
+ padding: 0.5rem 0.75rem;
120
+ }
121
+
122
+ /* Nested sidebar items */
123
+ .sidebar-content ul ul a {
124
+ font-weight: 500;
125
+ font-size: 0.875rem;
126
+ padding: 0.375rem 0.75rem;
127
+ padding-left: 1.5rem;
128
+ border-left: 3px solid transparent;
129
+ }
130
+
131
+ /* Deep nested items */
132
+ .sidebar-content ul ul ul a {
133
+ font-weight: 400;
134
+ font-size: 0.8125rem;
135
+ padding-left: 2.25rem;
136
+ }
137
+
138
+ /* Active state - thin left accent bar */
139
+ .sidebar-content a[aria-current='page'] {
140
+ background-color: rgba(140, 140, 255, 0.08);
141
+ color: var(--sl-color-accent);
142
+ border-left-color: var(--sl-color-accent);
143
+ font-weight: 600;
144
+ }
145
+
146
+ :root[data-theme='dark'] .sidebar-content a[aria-current='page'] {
147
+ background-color: rgba(140, 140, 255, 0.1);
148
+ color: var(--sl-color-accent-high);
149
+ border-left-color: var(--sl-color-accent);
150
+ }
151
+
152
+ /* Hover states */
153
+ .sidebar-content a:hover {
154
+ background-color: rgba(0, 0, 0, 0.05);
155
+ }
156
+
157
+ :root[data-theme='dark'] .sidebar-content a:hover {
158
+ background-color: rgba(255, 255, 255, 0.05);
159
+ }
160
+
161
+ /* Section spacing */
162
+ .sidebar-content > ul > li {
163
+ margin-top: 0.75rem;
164
+ }
165
+
166
+ .sidebar-content > ul > li:first-child {
167
+ margin-top: 0;
168
+ }
169
+
170
+ /* Lighter chevrons/carets */
171
+ .sidebar-content summary::marker,
172
+ .sidebar-content details > summary::after {
173
+ opacity: 0.4;
174
+ }
175
+
176
+ .sidebar-content summary:hover::marker,
177
+ .sidebar-content details > summary:hover::after {
178
+ opacity: 0.6;
179
+ }
180
+
181
+ /* ============================================
182
+ LAYOUT - Full width content
183
+ ============================================ */
184
+ .content-panel {
185
+ width: 100%;
186
+ margin: 0 auto;
187
+ }
188
+
189
+ /* Full-width workflow diagram iframe */
190
+ .sl-markdown-content > iframe:first-child {
191
+ width: 100vw !important;
192
+ margin-left: calc(50% - 50vw);
193
+ border-radius: 0 !important;
194
+ border-left: none !important;
195
+ border-right: none !important;
196
+ }
197
+
198
+ /* Main content area */
199
+ main {
200
+ min-width: 0;
201
+ }
202
+
203
+ .sl-markdown-content {
204
+ min-width: 0;
205
+ overflow-wrap: break-word;
206
+ word-wrap: break-word;
207
+ }
208
+
209
+ /* Hide breadcrumbs if desired */
210
+ /* Uncomment to hide:
211
+ nav[aria-label="Breadcrumb"] {
212
+ display: none;
213
+ }
214
+ */
215
+
216
+ /* ============================================
217
+ NAVBAR
218
+ ============================================ */
219
+ header.header {
220
+ padding: 0 !important; /* Remove all padding for full-width banner */
221
+ box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
222
+ height: var(--sl-nav-height) !important;
223
+ display: flex;
224
+ flex-direction: column;
225
+ }
226
+
227
+ header.header .header.sl-flex {
228
+ padding: 0 1.5rem;
229
+ height: calc(var(--sl-nav-height) - var(--ai-banner-height));
230
+ width: 100%;
231
+ }
232
+
233
+ :root[data-theme='dark'] header.header {
234
+ box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
235
+ }
236
+
237
+ .site-title {
238
+ font-weight: 700;
239
+ margin-left: 0;
240
+ padding-left: 0;
241
+ }
242
+
243
+ /* Logo sizing - constrain to reasonable size */
244
+ .site-title img {
245
+ height: 2.5rem;
246
+ width: auto;
247
+ }
248
+
249
+ /* Social links styling */
250
+ .social-icons a {
251
+ padding: 0.5rem;
252
+ transition:
253
+ background-color 0.15s ease,
254
+ color 0.15s ease;
255
+ border-radius: 6px;
256
+ }
257
+
258
+ .social-icons a:hover {
259
+ background-color: rgba(0, 0, 0, 0.05);
260
+ }
261
+
262
+ :root[data-theme='dark'] .social-icons a:hover {
263
+ background-color: rgba(255, 255, 255, 0.05);
264
+ }
265
+
266
+ /* ============================================
267
+ CARDS
268
+ ============================================ */
269
+ .card {
270
+ border-radius: 12px;
271
+ border: 2px solid var(--sl-color-gray-5);
272
+ background-color: var(--sl-color-bg);
273
+ box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
274
+ transition:
275
+ transform 0.2s ease,
276
+ box-shadow 0.2s ease,
277
+ border-color 0.2s ease;
278
+ }
279
+
280
+ .card:hover {
281
+ transform: translateY(-3px);
282
+ border-color: var(--sl-color-accent);
283
+ box-shadow: 0 8px 24px rgba(140, 140, 255, 0.15);
284
+ }
285
+
286
+ :root[data-theme='dark'] .card {
287
+ background: linear-gradient(145deg, rgba(30, 41, 59, 0.6), rgba(15, 23, 42, 0.8));
288
+ border-color: rgba(140, 140, 255, 0.2);
289
+ box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
290
+ }
291
+
292
+ :root[data-theme='dark'] .card:hover {
293
+ border-color: rgba(140, 140, 255, 0.5);
294
+ box-shadow:
295
+ 0 8px 32px rgba(140, 140, 255, 0.2),
296
+ 0 0 0 1px rgba(140, 140, 255, 0.1);
297
+ }
298
+
299
+ /* Starlight card grid */
300
+ .sl-link-card {
301
+ border-radius: 12px;
302
+ border: 2px solid var(--sl-color-gray-5);
303
+ transition:
304
+ transform 0.2s ease,
305
+ box-shadow 0.2s ease,
306
+ border-color 0.2s ease;
307
+ }
308
+
309
+ .sl-link-card:hover {
310
+ transform: translateY(-3px);
311
+ border-color: var(--sl-color-accent);
312
+ }
313
+
314
+ :root[data-theme='dark'] .sl-link-card {
315
+ border-color: rgba(140, 140, 255, 0.2);
316
+ }
317
+
318
+ :root[data-theme='dark'] .sl-link-card:hover {
319
+ border-color: rgba(140, 140, 255, 0.5);
320
+ }
321
+
322
+ /* ============================================
323
+ BUTTONS
324
+ ============================================ */
325
+ .sl-flex a[href],
326
+ button {
327
+ transition:
328
+ background-color 0.2s ease,
329
+ transform 0.1s ease;
330
+ }
331
+
332
+ .sl-flex a[href]:hover,
333
+ button:hover {
334
+ transform: translateY(-1px);
335
+ }
336
+
337
+ /* ============================================
338
+ MISC ENHANCEMENTS
339
+ ============================================ */
340
+
341
+ /* Smooth scrolling */
342
+ html {
343
+ scroll-behavior: smooth;
344
+ }
345
+
346
+ /* Better link underlines */
347
+ .sl-markdown-content a:not(.sl-link-card) {
348
+ text-decoration-thickness: 1px;
349
+ text-underline-offset: 2px;
350
+ }
351
+
352
+ /* Table styling */
353
+ table {
354
+ display: table;
355
+ width: 100%;
356
+ }
357
+
358
+ :root[data-theme='dark'] table {
359
+ border-color: rgba(140, 140, 255, 0.1);
360
+ }
361
+
362
+ :root[data-theme='dark'] table th {
363
+ background-color: rgba(140, 140, 255, 0.05);
364
+ }
365
+
366
+ :root[data-theme='dark'] table tr:nth-child(2n) {
367
+ background-color: rgba(140, 140, 255, 0.02);
368
+ }
369
+
370
+ /* Blockquotes */
371
+ blockquote {
372
+ border-left-color: var(--sl-color-accent);
373
+ background-color: rgba(140, 140, 255, 0.05);
374
+ border-radius: 0 8px 8px 0;
375
+ padding: 1rem 1.25rem;
376
+ }
377
+
378
+ /* ============================================
379
+ ADMONITIONS (Starlight Asides)
380
+ Rounded, no left border bar
381
+ ============================================ */
382
+ .starlight-aside {
383
+ margin-bottom: 1.5rem;
384
+ padding: 1.25rem 1.5rem;
385
+ border-radius: 12px;
386
+ border: none;
387
+ border-left: 0;
388
+ box-shadow: 0 1px 4px rgba(0, 0, 0, 0.08);
389
+ }
390
+
391
+ /* Tip aside */
392
+ .starlight-aside--tip {
393
+ background-color: rgba(16, 185, 129, 0.08);
394
+ }
395
+
396
+ .starlight-aside--tip .starlight-aside__title {
397
+ color: #059669;
398
+ }
399
+
400
+ :root[data-theme='dark'] .starlight-aside--tip {
401
+ background-color: rgba(16, 185, 129, 0.12);
402
+ }
403
+
404
+ :root[data-theme='dark'] .starlight-aside--tip .starlight-aside__title {
405
+ color: #34d399;
406
+ }
407
+
408
+ /* Note aside */
409
+ .starlight-aside--note {
410
+ background-color: rgba(140, 140, 255, 0.08);
411
+ }
412
+
413
+ .starlight-aside--note .starlight-aside__title {
414
+ color: #8c8cff;
415
+ }
416
+
417
+ :root[data-theme='dark'] .starlight-aside--note {
418
+ background-color: rgba(140, 140, 255, 0.12);
419
+ }
420
+
421
+ :root[data-theme='dark'] .starlight-aside--note .starlight-aside__title {
422
+ color: #8c8cff;
423
+ }
424
+
425
+ /* Caution aside */
426
+ .starlight-aside--caution {
427
+ background-color: rgba(245, 158, 11, 0.1);
428
+ }
429
+
430
+ .starlight-aside--caution .starlight-aside__title {
431
+ color: #d97706;
432
+ }
433
+
434
+ :root[data-theme='dark'] .starlight-aside--caution {
435
+ background-color: rgba(245, 158, 11, 0.15);
436
+ }
437
+
438
+ :root[data-theme='dark'] .starlight-aside--caution .starlight-aside__title {
439
+ color: #fbbf24;
440
+ }
441
+
442
+ /* Danger aside */
443
+ .starlight-aside--danger {
444
+ background-color: rgba(239, 68, 68, 0.1);
445
+ }
446
+
447
+ .starlight-aside--danger .starlight-aside__title {
448
+ color: #dc2626;
449
+ }
450
+
451
+ :root[data-theme='dark'] .starlight-aside--danger {
452
+ background-color: rgba(239, 68, 68, 0.15);
453
+ }
454
+
455
+ :root[data-theme='dark'] .starlight-aside--danger .starlight-aside__title {
456
+ color: #f87171;
457
+ }
458
+
459
+ /* Aside icon styling */
460
+ .starlight-aside__icon svg {
461
+ width: 1.25rem;
462
+ height: 1.25rem;
463
+ }
464
+
465
+ /* ============================================
466
+ FOOTER - Minimal styling
467
+ ============================================ */
468
+ footer {
469
+ background-color: var(--sl-color-black);
470
+ border-top: 1px solid var(--sl-color-hairline);
471
+ }
472
+
473
+ :root[data-theme='dark'] footer {
474
+ background-color: #020617;
475
+ }
476
+
477
+ /* ============================================
478
+ RESPONSIVE ADJUSTMENTS
479
+ ============================================ */
480
+ @media (max-width: 72rem) {
481
+ .content-panel {
482
+ max-width: 100%;
483
+ }
484
+ }
485
+
486
+ /* Responsive padding on navbar row only - banner stays full-width */
487
+ @media (min-width: 50rem) {
488
+ header.header .header.sl-flex {
489
+ padding-left: 1rem;
490
+ padding-right: 2.5rem;
491
+ }
492
+ }
493
+
494
+ @media (min-width: 72rem) {
495
+ header.header .header.sl-flex {
496
+ padding-left: 1rem;
497
+ padding-right: 3rem;
498
+ }
499
+ }
@@ -0,0 +1,9 @@
1
+ {
2
+ "extends": "astro/tsconfigs/strict",
3
+ "compilerOptions": {
4
+ "baseUrl": ".",
5
+ "paths": {
6
+ "@/*": ["./src/*"]
7
+ }
8
+ }
9
+ }