qa-skills 3.0.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 (262) hide show
  1. package/README.md +168 -0
  2. package/bin/cli.js +42 -0
  3. package/dist/agents/registry.d.ts +5 -0
  4. package/dist/agents/registry.d.ts.map +1 -0
  5. package/dist/agents/registry.js +101 -0
  6. package/dist/agents/registry.js.map +1 -0
  7. package/dist/agents/types.d.ts +9 -0
  8. package/dist/agents/types.d.ts.map +1 -0
  9. package/dist/agents/types.js +2 -0
  10. package/dist/agents/types.js.map +1 -0
  11. package/dist/dependencies.d.ts +21 -0
  12. package/dist/dependencies.d.ts.map +1 -0
  13. package/dist/dependencies.js +125 -0
  14. package/dist/dependencies.js.map +1 -0
  15. package/dist/installer.d.ts +25 -0
  16. package/dist/installer.d.ts.map +1 -0
  17. package/dist/installer.js +437 -0
  18. package/dist/installer.js.map +1 -0
  19. package/dist/scaffold.d.ts +27 -0
  20. package/dist/scaffold.d.ts.map +1 -0
  21. package/dist/scaffold.js +182 -0
  22. package/dist/scaffold.js.map +1 -0
  23. package/package.json +40 -0
  24. package/skills/qa-accessibility-test-writer/SKILL.md +127 -0
  25. package/skills/qa-accessibility-test-writer/references/axe-core-patterns.md +349 -0
  26. package/skills/qa-accessibility-test-writer/references/best-practices.md +184 -0
  27. package/skills/qa-accessibility-test-writer/references/wcag-tests.md +331 -0
  28. package/skills/qa-api-contract-curator/SKILL.md +104 -0
  29. package/skills/qa-api-contract-curator/references/breaking-changes.md +363 -0
  30. package/skills/qa-api-contract-curator/references/openapi-structure.md +404 -0
  31. package/skills/qa-browser-data-collector/SKILL.md +132 -0
  32. package/skills/qa-browser-data-collector/references/data-collection-checklist.md +91 -0
  33. package/skills/qa-browser-data-collector/references/playwright-mcp-patterns.md +113 -0
  34. package/skills/qa-bug-ticket-creator/SKILL.md +148 -0
  35. package/skills/qa-bug-ticket-creator/references/bug-report-format.md +149 -0
  36. package/skills/qa-bug-ticket-creator/references/severity-guide.md +81 -0
  37. package/skills/qa-bug-ticket-creator/templates/bug-ticket-template.md +39 -0
  38. package/skills/qa-changelog-analyzer/SKILL.md +134 -0
  39. package/skills/qa-changelog-analyzer/references/git-analysis-patterns.md +138 -0
  40. package/skills/qa-changelog-analyzer/references/impact-mapping.md +120 -0
  41. package/skills/qa-clickup-integration/SKILL.md +166 -0
  42. package/skills/qa-clickup-integration/references/api-patterns.md +102 -0
  43. package/skills/qa-clickup-integration/references/field-mapping.md +71 -0
  44. package/skills/qa-codeceptjs-writer/SKILL.md +136 -0
  45. package/skills/qa-codeceptjs-writer/references/best-practices.md +207 -0
  46. package/skills/qa-codeceptjs-writer/references/config.md +255 -0
  47. package/skills/qa-codeceptjs-writer/references/patterns.md +285 -0
  48. package/skills/qa-coverage-analyzer/SKILL.md +166 -0
  49. package/skills/qa-coverage-analyzer/references/best-practices.md +142 -0
  50. package/skills/qa-coverage-analyzer/references/coverage-dimensions.md +155 -0
  51. package/skills/qa-coverage-analyzer/references/tools.md +204 -0
  52. package/skills/qa-cypress-writer/SKILL.md +134 -0
  53. package/skills/qa-cypress-writer/references/assertions.md +121 -0
  54. package/skills/qa-cypress-writer/references/best-practices.md +82 -0
  55. package/skills/qa-cypress-writer/references/config.md +121 -0
  56. package/skills/qa-cypress-writer/references/patterns.md +170 -0
  57. package/skills/qa-data-factory/SKILL.md +126 -0
  58. package/skills/qa-data-factory/references/factory-patterns.md +164 -0
  59. package/skills/qa-data-factory/references/faker-guide.md +131 -0
  60. package/skills/qa-diagram-generator/SKILL.md +125 -0
  61. package/skills/qa-diagram-generator/references/c4-model.md +53 -0
  62. package/skills/qa-diagram-generator/references/charts.md +58 -0
  63. package/skills/qa-diagram-generator/references/class-diagram.md +85 -0
  64. package/skills/qa-diagram-generator/references/er-diagram.md +69 -0
  65. package/skills/qa-diagram-generator/references/flowchart.md +92 -0
  66. package/skills/qa-diagram-generator/references/from-screenshot.md +45 -0
  67. package/skills/qa-diagram-generator/references/gantt.md +49 -0
  68. package/skills/qa-diagram-generator/references/journey.md +50 -0
  69. package/skills/qa-diagram-generator/references/mindmap.md +75 -0
  70. package/skills/qa-diagram-generator/references/sequence.md +69 -0
  71. package/skills/qa-diagram-generator/references/state-diagram.md +56 -0
  72. package/skills/qa-discovery-interview/SKILL.md +182 -0
  73. package/skills/qa-discovery-interview/references/completeness-checklist.md +53 -0
  74. package/skills/qa-discovery-interview/references/conflict-patterns.md +101 -0
  75. package/skills/qa-discovery-interview/references/qa-categories.md +147 -0
  76. package/skills/qa-discovery-interview/templates/qa-brief-template.md +168 -0
  77. package/skills/qa-environment-checker/SKILL.md +142 -0
  78. package/skills/qa-environment-checker/references/dependency-matrix.md +101 -0
  79. package/skills/qa-environment-checker/references/health-checks.md +209 -0
  80. package/skills/qa-environment-checker/templates/env-readiness-template.md +64 -0
  81. package/skills/qa-flaky-detector/SKILL.md +153 -0
  82. package/skills/qa-flaky-detector/references/ci-analysis.md +140 -0
  83. package/skills/qa-flaky-detector/references/flaky-patterns.md +247 -0
  84. package/skills/qa-github-issues-enhanced/SKILL.md +175 -0
  85. package/skills/qa-github-issues-enhanced/references/issue-templates.md +425 -0
  86. package/skills/qa-github-issues-enhanced/references/label-taxonomy.md +130 -0
  87. package/skills/qa-github-issues-enhanced/references/workflow-patterns.md +188 -0
  88. package/skills/qa-httpx-writer/SKILL.md +138 -0
  89. package/skills/qa-httpx-writer/references/assertions.md +195 -0
  90. package/skills/qa-httpx-writer/references/best-practices.md +140 -0
  91. package/skills/qa-httpx-writer/references/config.md +212 -0
  92. package/skills/qa-httpx-writer/references/patterns.md +262 -0
  93. package/skills/qa-jest-writer/SKILL.md +131 -0
  94. package/skills/qa-jest-writer/references/assertions.md +125 -0
  95. package/skills/qa-jest-writer/references/best-practices.md +136 -0
  96. package/skills/qa-jest-writer/references/config.md +134 -0
  97. package/skills/qa-jest-writer/references/patterns.md +172 -0
  98. package/skills/qa-jira-integration/SKILL.md +135 -0
  99. package/skills/qa-jira-integration/references/api-patterns.md +143 -0
  100. package/skills/qa-jira-integration/references/field-mapping.md +79 -0
  101. package/skills/qa-jira-integration/references/xray-integration.md +85 -0
  102. package/skills/qa-jmeter-writer/SKILL.md +171 -0
  103. package/skills/qa-jmeter-writer/references/best-practices.md +157 -0
  104. package/skills/qa-jmeter-writer/references/config.md +204 -0
  105. package/skills/qa-jmeter-writer/references/patterns.md +242 -0
  106. package/skills/qa-junit5-writer/SKILL.md +157 -0
  107. package/skills/qa-junit5-writer/references/assertions.md +118 -0
  108. package/skills/qa-junit5-writer/references/config.md +97 -0
  109. package/skills/qa-junit5-writer/references/patterns.md +162 -0
  110. package/skills/qa-k6-writer/SKILL.md +155 -0
  111. package/skills/qa-k6-writer/references/best-practices.md +236 -0
  112. package/skills/qa-k6-writer/references/config.md +219 -0
  113. package/skills/qa-k6-writer/references/patterns.md +304 -0
  114. package/skills/qa-linear-integration/SKILL.md +137 -0
  115. package/skills/qa-linear-integration/references/api-patterns.md +249 -0
  116. package/skills/qa-linear-integration/references/field-mapping.md +121 -0
  117. package/skills/qa-locust-writer/SKILL.md +151 -0
  118. package/skills/qa-locust-writer/references/best-practices.md +126 -0
  119. package/skills/qa-locust-writer/references/config.md +170 -0
  120. package/skills/qa-locust-writer/references/patterns.md +235 -0
  121. package/skills/qa-manual-test-designer/SKILL.md +145 -0
  122. package/skills/qa-manual-test-designer/references/exploratory-charters.md +138 -0
  123. package/skills/qa-manual-test-designer/references/personas.md +146 -0
  124. package/skills/qa-manual-test-designer/templates/exploratory-charter-template.md +47 -0
  125. package/skills/qa-manual-test-designer/templates/test-case-template.md +31 -0
  126. package/skills/qa-mobile-test-writer/SKILL.md +144 -0
  127. package/skills/qa-mobile-test-writer/references/best-practices.md +214 -0
  128. package/skills/qa-mobile-test-writer/references/config.md +309 -0
  129. package/skills/qa-mobile-test-writer/references/patterns.md +304 -0
  130. package/skills/qa-nfr-analyst/SKILL.md +177 -0
  131. package/skills/qa-nfr-analyst/references/iso-25010-model.md +159 -0
  132. package/skills/qa-nfr-analyst/references/owasp-wstg-baseline.md +202 -0
  133. package/skills/qa-nfr-analyst/references/wcag-checklist.md +184 -0
  134. package/skills/qa-nfr-analyst/templates/owasp-checklist-template.md +89 -0
  135. package/skills/qa-nfr-analyst/templates/wcag-checklist-template.md +48 -0
  136. package/skills/qa-orchestrator/SKILL.md +132 -0
  137. package/skills/qa-orchestrator/references/handoff-chains.md +105 -0
  138. package/skills/qa-orchestrator/references/pipeline-modes.md +115 -0
  139. package/skills/qa-orchestrator/references/scheduler-rules.md +84 -0
  140. package/skills/qa-pact-writer/SKILL.md +133 -0
  141. package/skills/qa-pact-writer/references/best-practices.md +100 -0
  142. package/skills/qa-pact-writer/references/config.md +135 -0
  143. package/skills/qa-pact-writer/references/patterns.md +161 -0
  144. package/skills/qa-plan-creator/SKILL.md +139 -0
  145. package/skills/qa-plan-creator/references/introduction-plan.md +43 -0
  146. package/skills/qa-plan-creator/references/migration-plan.md +44 -0
  147. package/skills/qa-plan-creator/references/onboarding-plan.md +46 -0
  148. package/skills/qa-plan-creator/references/performance-plan.md +44 -0
  149. package/skills/qa-plan-creator/references/regression-plan.md +45 -0
  150. package/skills/qa-plan-creator/references/release-plan.md +45 -0
  151. package/skills/qa-plan-creator/references/sprint-plan.md +44 -0
  152. package/skills/qa-plan-creator/references/test-plan.md +59 -0
  153. package/skills/qa-plan-creator/references/uat-plan.md +43 -0
  154. package/skills/qa-plan-creator/templates/checklist-template.md +36 -0
  155. package/skills/qa-plan-creator/templates/regression-checklist-template.md +49 -0
  156. package/skills/qa-plan-creator/templates/release-checklist-template.md +46 -0
  157. package/skills/qa-plan-creator/templates/test-plan-template.md +74 -0
  158. package/skills/qa-playwright-py-writer/SKILL.md +156 -0
  159. package/skills/qa-playwright-py-writer/references/best-practices.md +194 -0
  160. package/skills/qa-playwright-py-writer/references/config.md +195 -0
  161. package/skills/qa-playwright-py-writer/references/patterns.md +212 -0
  162. package/skills/qa-playwright-ts-writer/SKILL.md +151 -0
  163. package/skills/qa-playwright-ts-writer/references/assertions.md +109 -0
  164. package/skills/qa-playwright-ts-writer/references/best-practices.md +191 -0
  165. package/skills/qa-playwright-ts-writer/references/config.md +144 -0
  166. package/skills/qa-playwright-ts-writer/references/patterns.md +171 -0
  167. package/skills/qa-pytest-writer/SKILL.md +145 -0
  168. package/skills/qa-pytest-writer/references/assertions.md +149 -0
  169. package/skills/qa-pytest-writer/references/best-practices.md +97 -0
  170. package/skills/qa-pytest-writer/references/config.md +176 -0
  171. package/skills/qa-pytest-writer/references/patterns.md +251 -0
  172. package/skills/qa-qase-integration/SKILL.md +149 -0
  173. package/skills/qa-qase-integration/references/api-reference.md +354 -0
  174. package/skills/qa-qase-integration/references/ci-integration.md +196 -0
  175. package/skills/qa-qase-integration/references/field-mapping.md +157 -0
  176. package/skills/qa-requirements-generator/SKILL.md +152 -0
  177. package/skills/qa-requirements-generator/references/iso-29148-structure.md +153 -0
  178. package/skills/qa-requirements-generator/references/requirement-patterns.md +278 -0
  179. package/skills/qa-rest-assured-writer/SKILL.md +137 -0
  180. package/skills/qa-rest-assured-writer/references/best-practices.md +50 -0
  181. package/skills/qa-rest-assured-writer/references/config.md +124 -0
  182. package/skills/qa-rest-assured-writer/references/patterns.md +192 -0
  183. package/skills/qa-risk-analyzer/SKILL.md +158 -0
  184. package/skills/qa-risk-analyzer/references/impact-analysis.md +133 -0
  185. package/skills/qa-risk-analyzer/references/risk-factors.md +123 -0
  186. package/skills/qa-robot-framework-writer/SKILL.md +147 -0
  187. package/skills/qa-robot-framework-writer/references/best-practices.md +249 -0
  188. package/skills/qa-robot-framework-writer/references/config.md +204 -0
  189. package/skills/qa-robot-framework-writer/references/libraries.md +273 -0
  190. package/skills/qa-robot-framework-writer/references/patterns.md +216 -0
  191. package/skills/qa-security-test-writer/SKILL.md +123 -0
  192. package/skills/qa-security-test-writer/references/best-practices.md +155 -0
  193. package/skills/qa-security-test-writer/references/owasp-top10.md +331 -0
  194. package/skills/qa-security-test-writer/references/zap-config.md +258 -0
  195. package/skills/qa-selenium-java-writer/SKILL.md +143 -0
  196. package/skills/qa-selenium-java-writer/references/best-practices.md +59 -0
  197. package/skills/qa-selenium-java-writer/references/config.md +143 -0
  198. package/skills/qa-selenium-java-writer/references/patterns.md +170 -0
  199. package/skills/qa-selenium-py-writer/SKILL.md +150 -0
  200. package/skills/qa-selenium-py-writer/references/best-practices.md +175 -0
  201. package/skills/qa-selenium-py-writer/references/config.md +224 -0
  202. package/skills/qa-selenium-py-writer/references/patterns.md +255 -0
  203. package/skills/qa-shortcut-integration/SKILL.md +143 -0
  204. package/skills/qa-shortcut-integration/references/api-patterns.md +126 -0
  205. package/skills/qa-shortcut-integration/references/field-mapping.md +66 -0
  206. package/skills/qa-spec-auditor/SKILL.md +162 -0
  207. package/skills/qa-spec-auditor/references/audit-checklist.md +144 -0
  208. package/skills/qa-spec-auditor/references/drift-patterns.md +207 -0
  209. package/skills/qa-spec-writer/SKILL.md +143 -0
  210. package/skills/qa-spec-writer/references/gherkin-guide.md +253 -0
  211. package/skills/qa-spec-writer/references/specification-patterns.md +274 -0
  212. package/skills/qa-spring-test-writer/SKILL.md +170 -0
  213. package/skills/qa-spring-test-writer/references/best-practices.md +57 -0
  214. package/skills/qa-spring-test-writer/references/config.md +179 -0
  215. package/skills/qa-spring-test-writer/references/patterns.md +235 -0
  216. package/skills/qa-supertest-writer/SKILL.md +150 -0
  217. package/skills/qa-supertest-writer/references/assertions.md +192 -0
  218. package/skills/qa-supertest-writer/references/best-practices.md +102 -0
  219. package/skills/qa-supertest-writer/references/config.md +166 -0
  220. package/skills/qa-supertest-writer/references/patterns.md +242 -0
  221. package/skills/qa-task-creator/SKILL.md +142 -0
  222. package/skills/qa-task-creator/references/linking-patterns.md +127 -0
  223. package/skills/qa-task-creator/references/task-types.md +169 -0
  224. package/skills/qa-task-creator/templates/task-template.md +24 -0
  225. package/skills/qa-test-doc-compiler/SKILL.md +114 -0
  226. package/skills/qa-test-doc-compiler/references/agile-tailoring.md +220 -0
  227. package/skills/qa-test-doc-compiler/references/iso-29119-3-documents.md +302 -0
  228. package/skills/qa-test-healer/SKILL.md +101 -0
  229. package/skills/qa-test-healer/references/diagnosis-patterns.md +142 -0
  230. package/skills/qa-test-healer/references/fix-strategies.md +177 -0
  231. package/skills/qa-test-reporter/SKILL.md +130 -0
  232. package/skills/qa-test-reporter/references/best-practices.md +162 -0
  233. package/skills/qa-test-reporter/references/iso-29119-reports.md +236 -0
  234. package/skills/qa-test-reporter/references/report-formats.md +287 -0
  235. package/skills/qa-test-reviewer/SKILL.md +142 -0
  236. package/skills/qa-test-reviewer/references/anti-patterns.md +268 -0
  237. package/skills/qa-test-reviewer/references/review-checklist.md +93 -0
  238. package/skills/qa-test-strategy/SKILL.md +133 -0
  239. package/skills/qa-test-strategy/references/entry-exit-criteria.md +176 -0
  240. package/skills/qa-test-strategy/references/risk-matrix.md +102 -0
  241. package/skills/qa-test-strategy/references/testing-types.md +143 -0
  242. package/skills/qa-testcase-from-docs/SKILL.md +161 -0
  243. package/skills/qa-testcase-from-docs/references/test-case-format.md +196 -0
  244. package/skills/qa-testcase-from-docs/references/test-design-techniques.md +126 -0
  245. package/skills/qa-testcase-from-docs/templates/test-case-template.md +31 -0
  246. package/skills/qa-testcase-from-ui/SKILL.md +109 -0
  247. package/skills/qa-testcase-from-ui/references/ui-element-patterns.md +126 -0
  248. package/skills/qa-testcase-from-ui/references/visual-analysis-guide.md +146 -0
  249. package/skills/qa-testcase-from-ui/templates/test-case-template.md +31 -0
  250. package/skills/qa-visual-regression-writer/SKILL.md +175 -0
  251. package/skills/qa-visual-regression-writer/references/best-practices.md +154 -0
  252. package/skills/qa-visual-regression-writer/references/config.md +220 -0
  253. package/skills/qa-visual-regression-writer/references/patterns.md +213 -0
  254. package/skills/qa-vitest-writer/SKILL.md +141 -0
  255. package/skills/qa-vitest-writer/references/assertions.md +105 -0
  256. package/skills/qa-vitest-writer/references/best-practices.md +62 -0
  257. package/skills/qa-vitest-writer/references/config.md +127 -0
  258. package/skills/qa-vitest-writer/references/patterns.md +141 -0
  259. package/skills/qa-webdriverio-writer/SKILL.md +145 -0
  260. package/skills/qa-webdriverio-writer/references/best-practices.md +176 -0
  261. package/skills/qa-webdriverio-writer/references/config.md +240 -0
  262. package/skills/qa-webdriverio-writer/references/patterns.md +269 -0
@@ -0,0 +1,69 @@
1
+ # Mermaid Sequence Diagram Syntax — QA Use Cases
2
+
3
+ ## Syntax Overview
4
+
5
+ Sequence diagrams use `sequenceDiagram`. Participants: `participant A`, `actor User`. Messages: `A->>B: message`, `A-->>B: async`, `A->>+B: create`, `A->>-B: destroy`. Loops: `loop`, `alt`, `opt`, `par`.
6
+
7
+ ```mermaid
8
+ sequenceDiagram
9
+ participant U as User
10
+ participant A as API
11
+ U->>A: request
12
+ A-->>U: response
13
+ ```
14
+
15
+ ## Example 1: API Interaction
16
+
17
+ ```mermaid
18
+ sequenceDiagram
19
+ participant T as Test
20
+ participant API as REST API
21
+ participant DB as Database
22
+ T->>API: POST /users
23
+ API->>DB: INSERT user
24
+ DB-->>API: OK
25
+ API-->>T: 201 Created
26
+ ```
27
+
28
+ ## Example 2: Login Flow
29
+
30
+ ```mermaid
31
+ sequenceDiagram
32
+ participant U as User
33
+ participant UI as Frontend
34
+ participant Auth as Auth Service
35
+ participant DB as Database
36
+ U->>UI: Enter credentials
37
+ UI->>Auth: POST /login
38
+ Auth->>DB: Validate
39
+ alt Valid
40
+ DB-->>Auth: User
41
+ Auth-->>UI: JWT
42
+ UI-->>U: Redirect
43
+ else Invalid
44
+ Auth-->>UI: 401
45
+ UI-->>U: Error message
46
+ end
47
+ ```
48
+
49
+ ## Example 3: Test Execution Flow
50
+
51
+ ```mermaid
52
+ sequenceDiagram
53
+ participant CI as CI Runner
54
+ participant Runner as Test Runner
55
+ participant SUT as System
56
+ CI->>Runner: Execute suite
57
+ loop Each test
58
+ Runner->>SUT: Setup
59
+ Runner->>SUT: Execute
60
+ Runner->>Runner: Assert
61
+ end
62
+ Runner-->>CI: Results
63
+ ```
64
+
65
+ ## When to Use
66
+
67
+ - **API flows:** Request/response, error paths
68
+ - **Auth flows:** Login, token refresh, logout
69
+ - **Test execution:** Setup → act → assert sequence
@@ -0,0 +1,56 @@
1
+ # Mermaid State Diagram Syntax — QA Use Cases
2
+
3
+ ## Syntax Overview
4
+
5
+ State diagrams use `stateDiagram-v2`. States: `state "Name" as id`. Transitions: `id --> id2 : event`. Composite: `state state_name { [*] --> s1; s1 --> s2 }`. Choice: `[*] --> choice`, `choice --> s1 : cond`.
6
+
7
+ ```mermaid
8
+ stateDiagram-v2
9
+ [*] --> Idle
10
+ Idle --> Running : start
11
+ Running --> Idle : stop
12
+ ```
13
+
14
+ ## Example 1: Bug Lifecycle
15
+
16
+ ```mermaid
17
+ stateDiagram-v2
18
+ [*] --> New
19
+ New --> InProgress : Assign
20
+ InProgress --> InReview : Submit
21
+ InReview --> InProgress : Reject
22
+ InReview --> Done : Approve
23
+ Done --> InProgress : Reopen
24
+ ```
25
+
26
+ ## Example 2: Test Case States
27
+
28
+ ```mermaid
29
+ stateDiagram-v2
30
+ [*] --> Draft
31
+ Draft --> Ready : Review
32
+ Ready --> Executing : Run
33
+ Executing --> Passed : Pass
34
+ Executing --> Failed : Fail
35
+ Executing --> Blocked : Block
36
+ Passed --> Ready : Rerun
37
+ Failed --> Ready : Rerun
38
+ Blocked --> Ready : Unblock
39
+ ```
40
+
41
+ ## Example 3: User Session States
42
+
43
+ ```mermaid
44
+ stateDiagram-v2
45
+ [*] --> Anonymous
46
+ Anonymous --> Authenticated : Login
47
+ Authenticated --> Anonymous : Logout
48
+ Authenticated --> Expired : Timeout
49
+ Expired --> Anonymous : Re-login
50
+ ```
51
+
52
+ ## When to Use
53
+
54
+ - **Bug lifecycle:** New → In Progress → Done
55
+ - **Test case states:** Draft, Ready, Executing, Passed/Failed
56
+ - **Session/auth states:** Anonymous, Authenticated, Expired
@@ -0,0 +1,182 @@
1
+ ---
2
+ name: qa-discovery-interview
3
+ description: QA-adapted discovery interview that transforms vague context into structured QA briefs through iterative questioning. Works standalone or as an embedded service auto-triggered by other skills when input is insufficient.
4
+ output_dir: docs/briefs
5
+ ---
6
+
7
+ # QA Discovery Interview
8
+
9
+ ## Purpose
10
+
11
+ QA-adapted discovery interview that transforms vague project context into a structured QA brief through iterative, category-driven questioning. Works in two modes:
12
+ - **Standalone:** User directly starts an interview for a new project or feature
13
+ - **Embedded:** Other skills auto-delegate here when their input is insufficient (<3 sentences or missing critical context)
14
+
15
+ ## Trigger Phrases
16
+
17
+ - "Start QA discovery interview"
18
+ - "Interview me about the project"
19
+ - "I need to set up QA for a new project"
20
+ - "Help me define testing scope"
21
+ - "QA brief for [project/feature]"
22
+ - "What should we test?"
23
+ - "New project QA setup"
24
+
25
+ ## Dual-Use Pattern
26
+
27
+ | Mode | Trigger | Output |
28
+ |------|---------|--------|
29
+ | **Standalone** | User: "Start a QA discovery interview for our payment system" | Full QA Discovery Brief |
30
+ | **Embedded** | qa-requirements-generator receives <3 sentences of input | Notify user → offer interview → feed brief back to calling skill |
31
+
32
+ ### Embedding Pattern for Other Skills
33
+
34
+ When another skill detects insufficient input:
35
+
36
+ 1. Notify user: "Not enough context for quality output."
37
+ 2. Offer: "I can run a QA discovery interview, or you can provide more details manually."
38
+ 3. If interview chosen → run interview → feed QA Brief output back into the calling skill.
39
+
40
+ Skills that auto-trigger this interview:
41
+ - `qa-requirements-generator` (from-description mode with <3 sentences)
42
+ - `qa-spec-writer` (ambiguous requirements or incomplete acceptance criteria)
43
+ - `qa-plan-creator` (no requirements, no codebase, no prior docs)
44
+ - `qa-test-strategy` (first run on a project with no existing docs)
45
+ - `qa-orchestrator` (full-cycle pipeline with no existing QA documentation)
46
+
47
+ ## Interview Phases
48
+
49
+ | Phase | Name | Description |
50
+ |-------|------|-------------|
51
+ | 1 | **Initial QA Orientation** | 2-3 broad questions: what are we testing, who are stakeholders, new or existing project |
52
+ | 2 | **Category Deep Dive** | 8 QA categories, 2-4 questions each (see `references/qa-categories.md`) |
53
+ | 3 | **Research Loops** | When uncertainty detected — research codebase/docs, return with informed questions |
54
+ | 4 | **Conflict Resolution** | Resolve priority conflicts, scope creep, unrealistic expectations |
55
+ | 5 | **Completeness Check** | QA-specific checklist before generating output (see `references/completeness-checklist.md`) |
56
+ | 6 | **QA Brief Generation** | Structured document that feeds Phase 1 skills |
57
+
58
+ ## Workflow
59
+
60
+ ### Phase 1: Initial QA Orientation (2-3 questions)
61
+
62
+ Start with broad orientation to establish context:
63
+
64
+ 1. "What product/feature are we testing? Give me a brief overview."
65
+ 2. "Is this a new project, an existing one, or a migration? What's the current state?"
66
+ 3. "Who are the key stakeholders, and what are their quality expectations?"
67
+
68
+ Based on answers, determine which of the 8 categories need deepest exploration.
69
+
70
+ ### Phase 2: Category Deep Dive
71
+
72
+ Work through 8 QA categories adaptively. Skip or abbreviate categories where context is already clear. Spend more time on gaps and risk areas.
73
+
74
+ See `references/qa-categories.md` for full question sets per category.
75
+
76
+ **Category summary:**
77
+
78
+ | Cat | Name | Focus |
79
+ |-----|------|-------|
80
+ | A | Problem & Product | Business context, impact of defects |
81
+ | B | Testing Scope & Objectives | Testing types needed, in/out scope |
82
+ | C | User Flows & Critical Paths | Core scenarios, happy/unhappy paths |
83
+ | D | Technical Landscape | Stack, architecture, constraints, APIs |
84
+ | E | Existing QA Processes | Current CI/CD, automation, tools |
85
+ | F | Risk Areas & Priorities | Defect-prone areas, business criticality |
86
+ | G | Team, Tools & Infrastructure | Team expertise, environments, tools |
87
+ | H | Compliance & Standards | WCAG, OWASP, ISO, GDPR, industry |
88
+
89
+ **Adaptive behavior:**
90
+ - Ask 2-4 questions per category (not all at once — batch by relevance)
91
+ - After each answer, decide: go deeper, move to next category, or trigger research loop
92
+ - When answer reveals uncertainty: pause, research (read code, docs, URLs), return with informed follow-up
93
+
94
+ ### Phase 3: Research Loops
95
+
96
+ When the interviewee mentions something that requires verification:
97
+
98
+ 1. Read codebase (project structure, API routes, test files, configs)
99
+ 2. Navigate URLs via Playwright MCP (if a live app exists)
100
+ 3. Read documentation files in the project
101
+ 4. Return with specific, informed follow-up questions
102
+
103
+ ### Phase 4: Conflict Resolution
104
+
105
+ Identify and resolve conflicts in stated requirements:
106
+
107
+ - Scope vs timeline conflicts ("we want full coverage in 2 days")
108
+ - Priority misalignment (everything is "critical")
109
+ - Unrealistic automation expectations
110
+ - Missing infrastructure for stated testing types
111
+
112
+ See `references/conflict-patterns.md` for common patterns and resolution strategies.
113
+
114
+ ### Phase 5: Completeness Check
115
+
116
+ Before generating the brief, verify all critical areas are covered. See `references/completeness-checklist.md`.
117
+
118
+ ### Phase 6: QA Brief Generation
119
+
120
+ Generate the structured QA Discovery Brief using `templates/qa-brief-template.md`.
121
+
122
+ ## Output
123
+
124
+ **QA Discovery Brief** (markdown) — the primary handoff document. Contains:
125
+ - Project/product overview
126
+ - Testing scope and objectives
127
+ - Critical user flows and scenarios
128
+ - Technical constraints and environment
129
+ - Risk assessment and priorities
130
+ - Compliance requirements
131
+ - Recommended testing types and approach
132
+ - Team and infrastructure summary
133
+
134
+ This brief feeds directly into: `qa-requirements-generator`, `qa-spec-writer`, `qa-plan-creator`, `qa-test-strategy`.
135
+
136
+ ## MCP Tools Used
137
+
138
+ - **Sequential Thinking MCP:** Structured reasoning during deep dive and conflict resolution
139
+ - **Playwright MCP:** Research loops — navigate live app to verify answers
140
+ - **Filesystem MCP:** Research loops — read codebase, docs, configs
141
+ - **Memory MCP:** Persist interview state for multi-session interviews
142
+
143
+ ## Scope
144
+
145
+ **Can do (autonomous):**
146
+ - Conduct full discovery interview through all 6 phases
147
+ - Adapt question depth based on answers
148
+ - Research codebase and live app during interview
149
+ - Generate structured QA Discovery Brief
150
+ - Serve as embedded service for other skills
151
+
152
+ **Cannot do (requires confirmation):**
153
+ - Make scope decisions on behalf of stakeholders
154
+ - Set final priorities without stakeholder input
155
+ - Skip categories the user explicitly wants to discuss
156
+
157
+ **Will not do (out of scope):**
158
+ - Write test code or create test cases (hand off to downstream skills)
159
+ - Modify production systems
160
+ - Make business decisions about product direction
161
+
162
+ ## Quality Checklist
163
+
164
+ - [ ] All 8 QA categories addressed (or explicitly marked N/A with rationale)
165
+ - [ ] Critical user flows identified and documented
166
+ - [ ] Risk areas ranked by business impact
167
+ - [ ] Technical stack and constraints captured
168
+ - [ ] Testing type recommendations align with project context
169
+ - [ ] Compliance requirements identified (or confirmed none apply)
170
+ - [ ] No ambiguous or conflicting statements in final brief
171
+ - [ ] Brief is sufficient for downstream skills to operate without additional input
172
+
173
+ ## Troubleshooting
174
+
175
+ | Symptom | Likely Cause | Fix |
176
+ |---------|--------------|-----|
177
+ | Interview feels too long | Too many categories explored in depth | Adapt: skip/abbreviate clear categories, focus on gaps |
178
+ | Interviewee gives vague answers | Unclear questions or unfamiliar domain | Rephrase with concrete examples; offer multiple-choice options |
179
+ | Conflicting priorities discovered | Stakeholder misalignment | Enter Phase 4: present conflicts explicitly, ask for resolution |
180
+ | Research loop finds no codebase | New project, no code yet | Skip code research, focus on specs/mockups/descriptions |
181
+ | Embedded trigger too aggressive | Skill triggers interview on minimal input | Check threshold: <3 sentences AND missing critical context (both conditions) |
182
+ | Brief too shallow for downstream | Rushed interview or skipped categories | Re-run completeness check, fill gaps with follow-up questions |
@@ -0,0 +1,53 @@
1
+ # QA Discovery Interview — Completeness Checklist
2
+
3
+ Verify all critical areas are covered before generating the QA Discovery Brief. Each item must be either answered or explicitly marked N/A with rationale.
4
+
5
+ ## Critical (Must Have)
6
+
7
+ | # | Area | Question | Status | Notes |
8
+ |---|------|----------|--------|-------|
9
+ | 1 | Product Overview | Do we know what the product/feature does? | {{Yes/No/Partial}} | |
10
+ | 2 | Testing Scope | Are testing types and boundaries defined? | {{Yes/No/Partial}} | |
11
+ | 3 | Critical Flows | Are top 3 user journeys identified? | {{Yes/No/Partial}} | |
12
+ | 4 | Tech Stack | Do we know frontend, backend, DB, and key integrations? | {{Yes/No/Partial}} | |
13
+ | 5 | Risk Areas | Are high-risk areas identified and ranked? | {{Yes/No/Partial}} | |
14
+ | 6 | Exit Criteria | Is "done" defined for QA? | {{Yes/No/Partial}} | |
15
+
16
+ ## Important (Should Have)
17
+
18
+ | # | Area | Question | Status | Notes |
19
+ |---|------|----------|--------|-------|
20
+ | 7 | User Roles | Are different user roles and their permissions clear? | {{Yes/No/N-A}} | |
21
+ | 8 | Environments | Do we know what environments exist and their purpose? | {{Yes/No/N-A}} | |
22
+ | 9 | Existing Tests | Do we know what testing already exists? | {{Yes/No/N-A}} | |
23
+ | 10 | CI/CD | Is the CI/CD pipeline understood? | {{Yes/No/N-A}} | |
24
+ | 11 | Team Skills | Do we know the team's automation capability? | {{Yes/No/N-A}} | |
25
+ | 12 | Timeline | Are schedule constraints known? | {{Yes/No/N-A}} | |
26
+
27
+ ## Optional (Nice to Have)
28
+
29
+ | # | Area | Question | Status | Notes |
30
+ |---|------|----------|--------|-------|
31
+ | 13 | Compliance | Are regulatory requirements identified? | {{Yes/No/N-A}} | |
32
+ | 14 | Accessibility | Is WCAG level defined? | {{Yes/No/N-A}} | |
33
+ | 15 | Security | Are security testing requirements clear? | {{Yes/No/N-A}} | |
34
+ | 16 | Performance | Are SLAs/thresholds defined? | {{Yes/No/N-A}} | |
35
+ | 17 | Browser/Device Matrix | Are supported platforms listed? | {{Yes/No/N-A}} | |
36
+ | 18 | Defect History | Are historical patterns known? | {{Yes/No/N-A}} | |
37
+
38
+ ## Completeness Scoring
39
+
40
+ | Score | Meaning | Action |
41
+ |-------|---------|--------|
42
+ | **All Critical = Yes** | Ready to generate brief | Proceed to Phase 6 |
43
+ | **1-2 Critical = Partial** | Gaps exist but manageable | Note gaps in brief, recommend follow-up |
44
+ | **Any Critical = No** | Not ready | Return to Phase 2, ask targeted questions for missing areas |
45
+ | **Important mostly N/A** | New project or limited context | Acceptable — note assumptions in brief |
46
+
47
+ ## Before Generating Brief
48
+
49
+ - [ ] All 6 Critical items are Yes or Partial (with notes)
50
+ - [ ] No unresolved conflicts from Phase 4
51
+ - [ ] Interviewee confirmed summary is accurate
52
+ - [ ] Assumptions are explicitly stated
53
+ - [ ] Research loops completed for uncertain areas
@@ -0,0 +1,101 @@
1
+ # QA Discovery Interview — Conflict Patterns & Resolution
2
+
3
+ Common conflicts discovered during interviews and strategies to resolve them.
4
+
5
+ ## Conflict Type 1: Scope vs Timeline
6
+
7
+ **Pattern:** "We need full test coverage for all features, and the release is in 2 weeks."
8
+
9
+ **Detection signals:**
10
+ - Large feature list + short timeline
11
+ - "Test everything" + limited team
12
+ - No prioritization between features
13
+
14
+ **Resolution strategy:**
15
+ 1. Present the scope-timeline-quality triangle
16
+ 2. Ask: "If we can only thoroughly test 3 areas, which ones matter most?"
17
+ 3. Propose: smoke testing for low-risk areas, full testing for critical paths
18
+ 4. Document agreed priorities in the brief with explicit rationale
19
+
20
+ ## Conflict Type 2: Everything is Critical
21
+
22
+ **Pattern:** "All features are P0, everything must be tested."
23
+
24
+ **Detection signals:**
25
+ - Every priority answer is "High" or "Critical"
26
+ - No differentiation between core and peripheral features
27
+ - Stakeholder avoids making trade-off decisions
28
+
29
+ **Resolution strategy:**
30
+ 1. Force-rank: "If the entire system is down except ONE feature, which one must work?"
31
+ 2. Use impact matrix: "What's the revenue/user impact if Feature X is broken vs Feature Y?"
32
+ 3. Categorize into: must-not-fail (P0), should-work (P1), nice-to-have (P2)
33
+ 4. If stakeholder still won't prioritize: document risk and recommend risk-based approach
34
+
35
+ ## Conflict Type 3: Automation Expectations vs Reality
36
+
37
+ **Pattern:** "We want 100% automated testing" but team has no automation experience and no CI/CD.
38
+
39
+ **Detection signals:**
40
+ - High automation expectations + junior team
41
+ - No existing test infrastructure
42
+ - Unrealistic timeline for automation setup
43
+
44
+ **Resolution strategy:**
45
+ 1. Acknowledge the goal: "100% automation is a great target. Let's plan a realistic path."
46
+ 2. Propose phased approach: manual first → automate critical paths → expand coverage
47
+ 3. Estimate setup time: framework, CI/CD, first tests (typically 2-4 weeks minimum)
48
+ 4. Recommend starting framework based on team skills (see Category G)
49
+
50
+ ## Conflict Type 4: Missing Infrastructure
51
+
52
+ **Pattern:** "Test on staging" but staging doesn't exist or isn't maintained.
53
+
54
+ **Detection signals:**
55
+ - References to environments that don't exist
56
+ - Test data assumptions without data sources
57
+ - External service dependencies without mocks/sandboxes
58
+
59
+ **Resolution strategy:**
60
+ 1. Document what exists vs what's assumed
61
+ 2. Create prerequisites list: environment setup, test data, service access
62
+ 3. Recommend qa-environment-checker as first step
63
+ 4. Include infrastructure tasks in the QA brief timeline
64
+
65
+ ## Conflict Type 5: Stakeholder Misalignment
66
+
67
+ **Pattern:** Dev team says "unit tests are enough" while PM expects "full E2E coverage."
68
+
69
+ **Detection signals:**
70
+ - Different team members give contradictory answers
71
+ - Testing philosophy conflicts (shift-left vs traditional QA)
72
+ - Unclear ownership of quality
73
+
74
+ **Resolution strategy:**
75
+ 1. Document both perspectives without judgment
76
+ 2. Present testing pyramid: unit → integration → E2E (each has its place)
77
+ 3. Recommend: "Let's define what 'tested' means for this project" (exit criteria)
78
+ 4. Propose balanced approach that addresses both concerns
79
+
80
+ ## Conflict Type 6: Security/Compliance Uncertainty
81
+
82
+ **Pattern:** "We probably don't need GDPR compliance" for a product handling EU user data.
83
+
84
+ **Detection signals:**
85
+ - Dismissive answers about compliance
86
+ - Handling user data without mentioning privacy
87
+ - Payment processing without PCI awareness
88
+
89
+ **Resolution strategy:**
90
+ 1. Don't challenge directly — ask clarifying questions
91
+ 2. "Does the application store personal data from EU users?" (→ GDPR applies)
92
+ 3. "Does it process credit card numbers directly?" (→ PCI-DSS applies)
93
+ 4. If compliance likely applies: note it as a risk in the brief, recommend specialist review
94
+
95
+ ## General Resolution Principles
96
+
97
+ 1. **Don't resolve conflicts yourself** — present them clearly, let stakeholders decide
98
+ 2. **Document both sides** — the brief should capture the conflict and the resolution
99
+ 3. **Quantify when possible** — "3 weeks vs 1 week" is clearer than "more time needed"
100
+ 4. **Propose options** — give 2-3 approaches with trade-offs, let stakeholder choose
101
+ 5. **Escalate when necessary** — some conflicts require management decisions beyond QA scope
@@ -0,0 +1,147 @@
1
+ # QA Discovery Interview — Category Deep Dive Questions
2
+
3
+ ## Category A: Problem & Product
4
+
5
+ **Focus:** What is being tested, business context, impact of defects.
6
+
7
+ | # | Question | Purpose |
8
+ |---|----------|---------|
9
+ | A1 | What is the core problem this product/feature solves for users? | Understand business value and testing priority |
10
+ | A2 | What happens if this feature ships with defects? What's the business impact? | Calibrate severity thresholds |
11
+ | A3 | Who are the end users? How many? What's their technical proficiency? | Define user personas for test design |
12
+ | A4 | Are there competing products? What differentiates this one? | Identify areas where quality is a competitive advantage |
13
+
14
+ **Signals for deeper exploration:**
15
+ - "Millions of users" → performance and scalability are critical
16
+ - "Financial transactions" → security, data integrity, compliance
17
+ - "Healthcare/legal" → regulatory compliance, audit trails
18
+
19
+ ## Category B: Testing Scope & Objectives
20
+
21
+ **Focus:** What types of testing are needed, what's in/out of scope.
22
+
23
+ | # | Question | Purpose |
24
+ |---|----------|---------|
25
+ | B1 | Which testing types are critical: functional, performance, security, accessibility? | Prioritize testing types |
26
+ | B2 | What is explicitly OUT of scope for testing? | Prevent scope creep |
27
+ | B3 | What is the definition of "done" for QA on this project? | Set clear exit criteria |
28
+ | B4 | Are there existing quality metrics or KPIs we need to meet? | Quantify quality targets |
29
+
30
+ **Signals for deeper exploration:**
31
+ - No clear exit criteria → probe for pass/fail thresholds
32
+ - "Everything is important" → force-rank with severity/impact matrix
33
+
34
+ ## Category C: User Flows & Critical Paths
35
+
36
+ **Focus:** Core scenarios, happy paths, unhappy paths, edge cases.
37
+
38
+ | # | Question | Purpose |
39
+ |---|----------|---------|
40
+ | C1 | Walk me through: a user completes the primary action. What happens step by step? | Map the happy path |
41
+ | C2 | What are the top 3 most critical user journeys? | Prioritize test coverage |
42
+ | C3 | What are the known edge cases or unusual user behaviors? | Identify boundary/negative test scenarios |
43
+ | C4 | Are there different user roles? How do their flows differ? | Role-based test scenarios |
44
+
45
+ **Signals for deeper exploration:**
46
+ - Complex multi-step flows → state diagram needed
47
+ - Multiple user roles → permission matrix testing
48
+ - "Users do unexpected things" → exploratory testing emphasis
49
+
50
+ ## Category D: Technical Landscape
51
+
52
+ **Focus:** Technology stack, architecture, constraints, integrations.
53
+
54
+ | # | Question | Purpose |
55
+ |---|----------|---------|
56
+ | D1 | What technologies, frameworks, and languages are used? (frontend, backend, DB) | Select appropriate test writers |
57
+ | D2 | What external APIs, services, or third-party integrations exist? | Contract testing, mock requirements |
58
+ | D3 | Is this a monolith, microservices, serverless, or hybrid architecture? | Architecture-appropriate test strategy |
59
+ | D4 | What are the known technical constraints or limitations? | Adjust test approach for constraints |
60
+
61
+ **Signals for deeper exploration:**
62
+ - Microservices → contract testing (Pact), service-level testing
63
+ - External APIs → mock/stub strategy, API contract validation
64
+ - Legacy systems → integration risk, compatibility testing
65
+
66
+ ## Category E: Existing QA Processes
67
+
68
+ **Focus:** Current CI/CD, test automation, tools, coverage.
69
+
70
+ | # | Question | Purpose |
71
+ |---|----------|---------|
72
+ | E1 | What testing exists today? Automated? Manual? Both? | Baseline current state |
73
+ | E2 | What CI/CD pipeline is in place? What tests run automatically? | Integration points for new tests |
74
+ | E3 | What test management tools are used? (Jira, TestRail, Qase, spreadsheets) | Tool integration requirements |
75
+ | E4 | What's the current test coverage? Are there known gaps? | Coverage gap analysis starting point |
76
+
77
+ **Signals for deeper exploration:**
78
+ - No automation → need onboarding plan, framework selection
79
+ - Flaky tests mentioned → qa-flaky-detector engagement
80
+ - No CI/CD → environment setup is prerequisite
81
+
82
+ ## Category F: Risk Areas & Priorities
83
+
84
+ **Focus:** What can break, what matters most, defect history.
85
+
86
+ | # | Question | Purpose |
87
+ |---|----------|---------|
88
+ | F1 | Which areas have the highest defect history or most production incidents? | Risk-based test prioritization |
89
+ | F2 | What was the last major bug that reached production? What caused it? | Pattern analysis for prevention |
90
+ | F3 | If you could only test 3 things, what would they be? | Force-rank priorities |
91
+ | F4 | Are there upcoming changes that increase risk? (migrations, refactors, new integrations) | Proactive risk management |
92
+
93
+ **Signals for deeper exploration:**
94
+ - Frequent production bugs → regression testing emphasis
95
+ - Major migration planned → migration test plan needed
96
+ - "Payment bugs" → security + functional testing priority
97
+
98
+ ## Category G: Team, Tools & Infrastructure
99
+
100
+ **Focus:** Who tests, with what tools, in which environments.
101
+
102
+ | # | Question | Purpose |
103
+ |---|----------|---------|
104
+ | G1 | What is the team's automation expertise? (junior, mid, senior; languages known) | Framework complexity calibration |
105
+ | G2 | What test environments exist? (dev, staging, QA, UAT, production) | Environment setup and readiness |
106
+ | G3 | What browsers, devices, and OS versions must be supported? | Browser/device matrix |
107
+ | G4 | What budget and timeline constraints exist for QA? | Resource planning and prioritization |
108
+
109
+ **Signals for deeper exploration:**
110
+ - Junior team → simpler frameworks (CodeceptJS, Robot Framework)
111
+ - No staging environment → environment-checker priority
112
+ - Mobile required → mobile test writer engagement
113
+
114
+ ## Category H: Compliance & Standards
115
+
116
+ **Focus:** WCAG, OWASP, ISO, GDPR, industry-specific regulations.
117
+
118
+ | # | Question | Purpose |
119
+ |---|----------|---------|
120
+ | H1 | Are there regulatory or compliance requirements? (GDPR, HIPAA, PCI-DSS, SOC2) | Compliance test requirements |
121
+ | H2 | What accessibility standard is required? (WCAG 2.2 Level A/AA/AAA) | Accessibility testing scope |
122
+ | H3 | Are there security requirements or certifications needed? (OWASP, penetration testing) | Security testing scope |
123
+ | H4 | Are there industry-specific standards? (ISO 27001, FDA, FedRAMP) | Specialized compliance testing |
124
+
125
+ **Signals for deeper exploration:**
126
+ - GDPR → data privacy testing, consent flows, deletion verification
127
+ - WCAG AA → accessibility-test-writer engagement, full checklist
128
+ - PCI-DSS → payment security, encryption validation
129
+ - No compliance mentioned → confirm explicitly ("Are you sure no regulations apply?")
130
+
131
+ ## Adaptive Questioning Strategy
132
+
133
+ ### Question Ordering
134
+ 1. Start with the category most relevant to the initial orientation answers
135
+ 2. If business-critical → A, F, C first
136
+ 3. If technical migration → D, E, G first
137
+ 4. If compliance-driven → H, B, F first
138
+
139
+ ### Depth Calibration
140
+ - **Shallow (1-2 questions):** Category is clear from context or explicitly out of scope
141
+ - **Normal (2-3 questions):** Standard exploration
142
+ - **Deep (3-4 questions + follow-ups):** High risk, uncertainty, or conflicts detected
143
+
144
+ ### Batching
145
+ - Ask 2-3 questions at a time (not one by one — too slow; not all at once — overwhelming)
146
+ - Group related questions within a category
147
+ - After each batch, summarize understanding before proceeding