tea-resources-index.yaml 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359
  1. # TEA Resources Index
  2. # Comprehensive index of TEA documentation, knowledge fragments, and online resources
  3. base_urls:
  4. online_docs: "https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise"
  5. github_repo: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise"
  6. github_knowledge: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge"
  7. # Public Documentation (32 files)
  8. documentation:
  9. tutorials:
  10. - name: "Getting Started with Test Architect"
  11. local: "/docs/tutorials/tea-lite-quickstart.md"
  12. online: "/tutorials/tea-lite-quickstart/"
  13. description: "30-minute quick start guide to TEA Lite"
  14. how_to_guides:
  15. workflows:
  16. - name: "Set Up Test Framework"
  17. local: "/docs/how-to/workflows/setup-test-framework.md"
  18. online: "/how-to/workflows/setup-test-framework/"
  19. workflow: framework
  20. - name: "Set Up CI Pipeline"
  21. local: "/docs/how-to/workflows/setup-ci.md"
  22. online: "/how-to/workflows/setup-ci/"
  23. workflow: ci
  24. - name: "Test Design"
  25. local: "/docs/how-to/workflows/run-test-design.md"
  26. online: "/how-to/workflows/run-test-design/"
  27. workflow: test-design
  28. - name: "ATDD"
  29. local: "/docs/how-to/workflows/run-atdd.md"
  30. online: "/how-to/workflows/run-atdd/"
  31. workflow: atdd
  32. - name: "Automate"
  33. local: "/docs/how-to/workflows/run-automate.md"
  34. online: "/how-to/workflows/run-automate/"
  35. workflow: automate
  36. - name: "Test Review"
  37. local: "/docs/how-to/workflows/run-test-review.md"
  38. online: "/how-to/workflows/run-test-review/"
  39. workflow: test-review
  40. - name: "Trace"
  41. local: "/docs/how-to/workflows/run-trace.md"
  42. online: "/how-to/workflows/run-trace/"
  43. workflow: trace
  44. - name: "NFR Assessment"
  45. local: "/docs/how-to/workflows/run-nfr-assess.md"
  46. online: "/how-to/workflows/run-nfr-assess/"
  47. workflow: nfr-assess
  48. customization:
  49. - name: "Configure Browser Automation"
  50. local: "/docs/how-to/customization/configure-browser-automation.md"
  51. online: "/how-to/customization/configure-browser-automation/"
  52. - name: "Integrate Playwright Utils with TEA"
  53. local: "/docs/how-to/customization/integrate-playwright-utils.md"
  54. online: "/how-to/customization/integrate-playwright-utils/"
  55. brownfield:
  56. - name: "Running TEA for Enterprise Projects"
  57. local: "/docs/how-to/brownfield/use-tea-for-enterprise.md"
  58. online: "/how-to/brownfield/use-tea-for-enterprise/"
  59. - name: "Using TEA with Existing Tests"
  60. local: "/docs/how-to/brownfield/use-tea-with-existing-tests.md"
  61. online: "/how-to/brownfield/use-tea-with-existing-tests/"
  62. explanation:
  63. - name: "TEA Overview"
  64. local: "/docs/explanation/tea-overview.md"
  65. online: "/explanation/tea-overview/"
  66. topics: ["Architecture", "Engagement models"]
  67. - name: "Testing as Engineering"
  68. local: "/docs/explanation/testing-as-engineering.md"
  69. online: "/explanation/testing-as-engineering/"
  70. topics: ["Philosophy", "Design principles"]
  71. - name: "Engagement Models"
  72. local: "/docs/explanation/engagement-models.md"
  73. online: "/explanation/engagement-models/"
  74. topics: ["Lite", "Solo", "Integrated", "Enterprise", "Brownfield"]
  75. - name: "Risk-Based Testing"
  76. local: "/docs/explanation/risk-based-testing.md"
  77. online: "/explanation/risk-based-testing/"
  78. topics: ["P0-P3 matrix", "Probability × Impact"]
  79. - name: "Test Quality Standards"
  80. local: "/docs/explanation/test-quality-standards.md"
  81. online: "/explanation/test-quality-standards/"
  82. topics: ["Definition of Done", "7 principles"]
  83. - name: "Knowledge Base System"
  84. local: "/docs/explanation/knowledge-base-system.md"
  85. online: "/explanation/knowledge-base-system/"
  86. topics: ["Fragment management", "35 fragments"]
  87. - name: "Network-First Patterns"
  88. local: "/docs/explanation/network-first-patterns.md"
  89. online: "/explanation/network-first-patterns/"
  90. topics: ["Network interception", "Race condition prevention"]
  91. - name: "Fixture Architecture"
  92. local: "/docs/explanation/fixture-architecture.md"
  93. online: "/explanation/fixture-architecture/"
  94. topics: ["Composition", "mergeTests pattern"]
  95. - name: "Step-File Architecture"
  96. local: "/docs/explanation/step-file-architecture.md"
  97. online: "/explanation/step-file-architecture/"
  98. topics: ["Micro-file design", "JIT loading", "Sequential enforcement"]
  99. - name: "Subprocess Architecture"
  100. local: "/docs/explanation/subprocess-architecture.md"
  101. online: "/explanation/subprocess-architecture/"
  102. topics: ["Parallel execution", "Context optimization"]
  103. reference:
  104. - name: "Commands"
  105. local: "/docs/reference/commands.md"
  106. online: "/reference/commands/"
  107. - name: "Configuration"
  108. local: "/docs/reference/configuration.md"
  109. online: "/reference/configuration/"
  110. - name: "Knowledge Base"
  111. local: "/docs/reference/knowledge-base.md"
  112. online: "/reference/knowledge-base/"
  113. github_link: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/testarch/knowledge"
  114. - name: "Troubleshooting"
  115. local: "/docs/reference/troubleshooting.md"
  116. online: "/reference/troubleshooting/"
  117. # Knowledge Fragments (34 files)
  118. knowledge_fragments:
  119. testing_patterns:
  120. - name: "fixture-architecture"
  121. path: "/src/testarch/knowledge/fixture-architecture.md"
  122. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/fixture-architecture.md"
  123. description: "Composable fixture patterns and mergeTests"
  124. - name: "fixtures-composition"
  125. path: "/src/testarch/knowledge/fixtures-composition.md"
  126. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/fixtures-composition.md"
  127. description: "mergeTests composition patterns for combining utilities"
  128. - name: "network-first"
  129. path: "/src/testarch/knowledge/network-first.md"
  130. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/network-first.md"
  131. description: "Network interception safeguards"
  132. - name: "data-factories"
  133. path: "/src/testarch/knowledge/data-factories.md"
  134. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/data-factories.md"
  135. description: "Data seeding and setup patterns"
  136. - name: "component-tdd"
  137. path: "/src/testarch/knowledge/component-tdd.md"
  138. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/component-tdd.md"
  139. description: "TDD red-green-refactor loop"
  140. - name: "api-testing-patterns"
  141. path: "/src/testarch/knowledge/api-testing-patterns.md"
  142. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/api-testing-patterns.md"
  143. description: "Pure API testing without browser"
  144. - name: "test-healing-patterns"
  145. path: "/src/testarch/knowledge/test-healing-patterns.md"
  146. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/test-healing-patterns.md"
  147. description: "Auto-fix common test failures"
  148. - name: "selector-resilience"
  149. path: "/src/testarch/knowledge/selector-resilience.md"
  150. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/selector-resilience.md"
  151. description: "Robust selectors that don't break"
  152. - name: "timing-debugging"
  153. path: "/src/testarch/knowledge/timing-debugging.md"
  154. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/timing-debugging.md"
  155. description: "Race condition fixes"
  156. playwright_utils:
  157. - name: "overview"
  158. path: "/src/testarch/knowledge/overview.md"
  159. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/overview.md"
  160. description: "Playwright Utils overview and installation"
  161. - name: "api-request"
  162. path: "/src/testarch/knowledge/api-request.md"
  163. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/api-request.md"
  164. description: "Typed HTTP client with schema validation"
  165. - name: "network-recorder"
  166. path: "/src/testarch/knowledge/network-recorder.md"
  167. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/network-recorder.md"
  168. description: "HAR record and playback"
  169. - name: "intercept-network-call"
  170. path: "/src/testarch/knowledge/intercept-network-call.md"
  171. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/intercept-network-call.md"
  172. description: "Network spy and stub utilities"
  173. - name: "recurse"
  174. path: "/src/testarch/knowledge/recurse.md"
  175. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/recurse.md"
  176. description: "Async polling for eventual consistency"
  177. - name: "log"
  178. path: "/src/testarch/knowledge/log.md"
  179. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/log.md"
  180. description: "Test report logging utilities"
  181. - name: "file-utils"
  182. path: "/src/testarch/knowledge/file-utils.md"
  183. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/file-utils.md"
  184. description: "CSV/XLSX/PDF/ZIP validation"
  185. - name: "burn-in"
  186. path: "/src/testarch/knowledge/burn-in.md"
  187. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/burn-in.md"
  188. description: "Smart test selection via git diff"
  189. - name: "network-error-monitor"
  190. path: "/src/testarch/knowledge/network-error-monitor.md"
  191. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/network-error-monitor.md"
  192. description: "HTTP 4xx/5xx detection"
  193. - name: "contract-testing"
  194. path: "/src/testarch/knowledge/contract-testing.md"
  195. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/contract-testing.md"
  196. description: "Pact publishing and provider verification"
  197. - name: "visual-debugging"
  198. path: "/src/testarch/knowledge/visual-debugging.md"
  199. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/visual-debugging.md"
  200. description: "Trace viewer workflows and debugging artifacts"
  201. configuration_governance:
  202. - name: "playwright-config"
  203. path: "/src/testarch/knowledge/playwright-config.md"
  204. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/playwright-config.md"
  205. description: "Environment and timeout guardrails"
  206. - name: "ci-burn-in"
  207. path: "/src/testarch/knowledge/ci-burn-in.md"
  208. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/ci-burn-in.md"
  209. description: "CI orchestration and smart selection"
  210. - name: "selective-testing"
  211. path: "/src/testarch/knowledge/selective-testing.md"
  212. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/selective-testing.md"
  213. description: "Tag and grep filters"
  214. - name: "feature-flags"
  215. path: "/src/testarch/knowledge/feature-flags.md"
  216. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/feature-flags.md"
  217. description: "Feature flag governance and cleanup"
  218. - name: "risk-governance"
  219. path: "/src/testarch/knowledge/risk-governance.md"
  220. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/risk-governance.md"
  221. description: "Risk scoring matrix and gate rules"
  222. - name: "adr-quality-readiness-checklist"
  223. path: "/src/testarch/knowledge/adr-quality-readiness-checklist.md"
  224. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/adr-quality-readiness-checklist.md"
  225. description: "Quality readiness checklist for decisions and reviews"
  226. quality_frameworks:
  227. - name: "test-quality"
  228. path: "/src/testarch/knowledge/test-quality.md"
  229. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/test-quality.md"
  230. description: "Definition of Done execution limits"
  231. - name: "test-levels-framework"
  232. path: "/src/testarch/knowledge/test-levels-framework.md"
  233. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/test-levels-framework.md"
  234. description: "Unit/Integration/E2E selection criteria"
  235. - name: "test-priorities-matrix"
  236. path: "/src/testarch/knowledge/test-priorities-matrix.md"
  237. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/test-priorities-matrix.md"
  238. description: "P0-P3 coverage targets"
  239. - name: "probability-impact"
  240. path: "/src/testarch/knowledge/probability-impact.md"
  241. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/probability-impact.md"
  242. description: "Probability × impact scoring definitions"
  243. - name: "nfr-criteria"
  244. path: "/src/testarch/knowledge/nfr-criteria.md"
  245. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/nfr-criteria.md"
  246. description: "Non-functional requirements assessment"
  247. auth_security:
  248. - name: "email-auth"
  249. path: "/src/testarch/knowledge/email-auth.md"
  250. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/email-auth.md"
  251. description: "Magic link extraction and auth state"
  252. - name: "auth-session"
  253. path: "/src/testarch/knowledge/auth-session.md"
  254. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/auth-session.md"
  255. description: "Token persistence and multi-user auth"
  256. - name: "error-handling"
  257. path: "/src/testarch/knowledge/error-handling.md"
  258. github: "https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/blob/main/src/testarch/knowledge/error-handling.md"
  259. description: "Exception handling and retry validation"
  260. # Quick Reference Maps
  261. session_to_resources:
  262. session-01:
  263. primary_docs: ["tea-lite-quickstart", "tea-overview", "run-automate"]
  264. fragments: []
  265. session-02:
  266. primary_docs: ["testing-as-engineering", "risk-based-testing", "test-quality-standards"]
  267. fragments: ["test-quality", "probability-impact"]
  268. session-03:
  269. primary_docs: ["fixture-architecture", "network-first-patterns", "step-file-architecture"]
  270. fragments: ["fixture-architecture", "network-first", "data-factories"]
  271. session-04:
  272. primary_docs: ["run-test-design"]
  273. fragments: ["test-levels-framework", "test-priorities-matrix"]
  274. session-05:
  275. primary_docs: ["run-atdd", "run-automate"]
  276. fragments: ["component-tdd", "api-testing-patterns", "api-request"]
  277. session-06:
  278. primary_docs: ["run-test-review", "run-trace"]
  279. fragments: []
  280. session-07:
  281. primary_docs: []
  282. fragments: [] # All 35 fragments available via menu-driven exploration
  283. # Web-Browsing Fallback Strategy
  284. fallback_urls:
  285. playwright_docs: "https://playwright.dev/docs/intro"
  286. jest_docs: "https://jestjs.io/docs/getting-started"
  287. cypress_docs: "https://docs.cypress.io/guides/overview/why-cypress"
  288. vitest_docs: "https://vitest.dev/guide/"
  289. testing_library: "https://testing-library.com/docs/"