@keber/qa-framework 1.11.3 → 1.13.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.
- package/CHANGELOG.md +340 -0
- package/README.md +42 -2
- package/docs/architecture.md +30 -26
- package/docs/decisions/lane-heartbeat-caller.md +86 -0
- package/docs/final-report.md +23 -23
- package/docs/folder-structure-guide.md +100 -80
- package/docs/installation.md +42 -7
- package/docs/skills-architecture.md +23 -23
- package/docs/spec-driven-philosophy.md +9 -9
- package/docs/usage-with-agent.md +88 -9
- package/docs/visuals/diag-01-ejecutivo-1.png +0 -0
- package/docs/visuals/diag-02-tactico-1.png +0 -0
- package/docs/visuals/diag-03-tecnico-1.png +0 -0
- package/docs/visuals/info-01-ejecutivo-1.png +0 -0
- package/docs/visuals/info-02-tactico-1.png +0 -0
- package/docs/visuals/info-03-tecnico-1.png +0 -0
- package/docs/visuals/pres-01-ejecutivo-1.png +0 -0
- package/docs/visuals/pres-02-tactico-1.png +0 -0
- package/docs/visuals/pres-03-tecnico-1.png +0 -0
- package/docs/visuals/qa-01-problema-1.png +0 -0
- package/docs/visuals/qa-02-que-es-1.png +0 -0
- package/docs/visuals/qa-03-pipeline-1.png +0 -0
- package/docs/visuals/qa-04-6-archivos-1.png +0 -0
- package/docs/visuals/qa-05-humano-1.png +0 -0
- package/docs/visuals/qa-06-agente-1.png +0 -0
- package/docs/visuals/qa-07-skills-arch-1.png +0 -0
- package/docs/visuals/qa-08-traceability-1.png +0 -0
- package/docs/visuals/qa-en-01-problem-1.png +0 -0
- package/docs/visuals/qa-en-02-what-is-1.png +0 -0
- package/docs/visuals/qa-en-03-pipeline-1.png +0 -0
- package/docs/visuals/qa-en-04-6files-1.png +0 -0
- package/docs/visuals/qa-en-05-human-1.png +0 -0
- package/docs/visuals/qa-en-06-agent-1.png +0 -0
- package/docs/visuals/qa-en-07-skills-arch-1.png +0 -0
- package/docs/visuals/qa-en-08-traceability-1.png +0 -0
- package/examples/module-example/suppliers/00-inventory.md +1 -1
- package/examples/module-example/suppliers/suppliers-create.spec.ts +8 -8
- package/integrations/ado-powershell/README.md +1 -1
- package/integrations/ado-powershell/scripts/sync-ado-titles.ps1 +2 -2
- package/integrations/playwright/README.md +4 -4
- package/package.json +7 -3
- package/qa-framework.config.json +25 -3
- package/scripts/check-forbidden-chars.js +187 -0
- package/scripts/check-spanish-accents.js +159 -0
- package/scripts/cli.js +1 -1
- package/scripts/generate.js +2 -2
- package/scripts/init.js +101 -12
- package/scripts/lib/claude-agents.js +347 -0
- package/scripts/lib/claude-commands.js +56 -0
- package/scripts/lib/module-keys.js +54 -0
- package/scripts/sync-version.js +63 -0
- package/scripts/upgrade.js +369 -20
- package/scripts/validate.js +46 -21
- package/skills/qa-ado-integration/SKILL.md +19 -19
- package/skills/qa-ado-integration/references/scripts-and-config.md +6 -6
- package/skills/qa-automation/SKILL.md +49 -27
- package/skills/qa-automation/references/config-checklist.md +4 -4
- package/skills/qa-automation/references/dom-inspection-template.js +7 -7
- package/skills/qa-automation/references/patterns.md +20 -20
- package/skills/qa-automation/references/pom-template.md +161 -0
- package/skills/qa-maintenance/SKILL.md +11 -11
- package/skills/qa-maintenance/references/update-rules.md +8 -8
- package/skills/qa-module-analysis/SKILL.md +20 -19
- package/skills/qa-module-analysis/references/exploration-checklist.md +4 -4
- package/skills/qa-module-analysis/references/output-verification.md +69 -0
- package/skills/qa-module-analysis/references/spec-file-formats.md +14 -14
- package/skills/qa-spec-generation/SKILL.md +13 -7
- package/skills/qa-test-cases/SKILL.md +11 -81
- package/skills/qa-test-cases/references/test-case-template.md +5 -5
- package/skills/qa-test-plan/SKILL.md +22 -86
- package/skills/qa-test-plan/references/plan-de-pruebas-template.md +24 -24
- package/skills/qa-test-stabilization/SKILL.md +59 -30
- package/skills/qa-test-stabilization/references/classification-protocol.md +35 -35
- package/templates/agent-next-steps.md +10 -10
- package/templates/agents/qa-analisis.md +142 -0
- package/templates/agents/qa-asesoria.md +48 -0
- package/templates/agents/qa-informe-resultados.md +236 -0
- package/templates/agents/qa-investigador.md +143 -0
- package/templates/agents/qa-plan.md +131 -0
- package/templates/agents/qa-reporte-ejecucion.md +138 -0
- package/templates/automation-scaffold/.env.example +36 -6
- package/templates/automation-scaffold/fixtures/auth.ts +27 -5
- package/templates/automation-scaffold/fixtures/base.ts +23 -1
- package/templates/automation-scaffold/fixtures/test-helpers.ts +1 -1
- package/templates/automation-scaffold/global-setup.ts +117 -48
- package/templates/automation-scaffold/playwright.config.ts +72 -32
- package/templates/automation-scaffold/scripts/global-setup-guards.js +184 -0
- package/templates/automation-scaffold/scripts/lane-config.js +269 -0
- package/templates/automation-scaffold/scripts/lane-lock.js +589 -0
- package/templates/defect-report.md +17 -3
- package/templates/execution-report.md +9 -9
- package/templates/integration-scaffold/.env.example +1 -1
- package/templates/integration-scaffold/global-setup.ts +21 -1
- package/templates/integration-scaffold/playwright.config.ts +15 -1
- package/templates/qa-framework.instructions.md +9 -8
- package/templates/qa-framework.rules.md +53 -0
- package/templates/qa-readme.md +8 -8
- package/templates/session-summary.md +2 -2
- package/templates/specification/00-inventory.md +3 -3
- package/templates/specification/01-business-rules.md +6 -6
- package/templates/specification/02-workflows.md +1 -1
- package/templates/specification/03-roles-permissions.md +1 -1
- package/templates/specification/04-test-data.md +8 -8
- package/templates/specification/05-test-scenarios.md +5 -5
- package/templates/test-case.md +3 -3
- package/templates/test-data-guidelines.md +7 -7
- package/templates/test-plan-sprint.md +13 -13
- package/templates/test-plan.md +3 -3
- package/skills/qa-test-plan/references/priority-and-feasibility.md +0 -159
|
@@ -1,159 +0,0 @@
|
|
|
1
|
-
# Reference: Test Plan Template
|
|
2
|
-
|
|
3
|
-
> Loaded by `skills/qa-test-plan/` when generating a test plan document.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## Complete Test Plan Template
|
|
8
|
-
|
|
9
|
-
Create at: `qa/02-test-plans/automated/{module}-test-plan.md`
|
|
10
|
-
|
|
11
|
-
```markdown
|
|
12
|
-
# Test Plan: {Module Display Name}
|
|
13
|
-
|
|
14
|
-
| Field | Value |
|
|
15
|
-
|-------|-------|
|
|
16
|
-
| Version | 1.0 |
|
|
17
|
-
| Date | YYYY-MM-DD |
|
|
18
|
-
| Module | {module-code} |
|
|
19
|
-
| Test plan type | Automated / Manual / Combined |
|
|
20
|
-
| Author | {agent or human name} |
|
|
21
|
-
| Status | Draft / Approved / Active |
|
|
22
|
-
|
|
23
|
-
---
|
|
24
|
-
|
|
25
|
-
## 1. Objective
|
|
26
|
-
|
|
27
|
-
{1-2 sentences: what this test plan covers and why}
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
## 2. Scope
|
|
32
|
-
|
|
33
|
-
### In scope
|
|
34
|
-
- {submodule 1}: {what is being tested}
|
|
35
|
-
|
|
36
|
-
### Out of scope
|
|
37
|
-
- {what is explicitly excluded and why}
|
|
38
|
-
|
|
39
|
-
---
|
|
40
|
-
|
|
41
|
-
## 3. Automation Feasibility Analysis
|
|
42
|
-
|
|
43
|
-
| Submodule | Total TCs | Fully automatable | Partially | Not automatable | Reason for exclusions |
|
|
44
|
-
|-----------|-----------|------------------|-----------|-----------------|----------------------|
|
|
45
|
-
| {name} | {N} | {N} ({%}) | {N} ({%}) | {N} ({%}) | {brief reason} |
|
|
46
|
-
|
|
47
|
-
---
|
|
48
|
-
|
|
49
|
-
## 4. Priority Distribution
|
|
50
|
-
|
|
51
|
-
| Priority | TCs selected | Automated | Manual |
|
|
52
|
-
|----------|-------------|-----------|--------|
|
|
53
|
-
| P0 (Critical — every build) | {N} | {N} | {N} |
|
|
54
|
-
| P1 (High — every release) | {N} | {N} | {N} |
|
|
55
|
-
| P2 (Medium — periodic regression) | {N} | {N} | {N} |
|
|
56
|
-
| P3 (Low — manual only) | {N} | 0 | {N} |
|
|
57
|
-
|
|
58
|
-
---
|
|
59
|
-
|
|
60
|
-
## 5. TC Selection and Automation Plan
|
|
61
|
-
|
|
62
|
-
### P0 Suite
|
|
63
|
-
|
|
64
|
-
| TC ID | Title | Type | Automation status |
|
|
65
|
-
|-------|-------|------|------------------|
|
|
66
|
-
| TC-{M}-{S}-001 | {title} | Functional | Queued |
|
|
67
|
-
|
|
68
|
-
### P1 Suite
|
|
69
|
-
|
|
70
|
-
| TC ID | Title | Type | Automation status |
|
|
71
|
-
|-------|-------|------|------------------|
|
|
72
|
-
| TC-{M}-{S}-010 | {title} | Functional | Queued |
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
76
|
-
## 6. Azure DevOps Test Plan (if enabled)
|
|
77
|
-
|
|
78
|
-
| Item | Value |
|
|
79
|
-
|------|-------|
|
|
80
|
-
| ADO Plan ID | (populate after creation) |
|
|
81
|
-
| ADO Suite IDs | (populate after creation) |
|
|
82
|
-
| Reporter | @alex_neo/playwright-azure-reporter |
|
|
83
|
-
|
|
84
|
-
---
|
|
85
|
-
|
|
86
|
-
## 7. Test Environment
|
|
87
|
-
|
|
88
|
-
| Item | Value |
|
|
89
|
-
|------|-------|
|
|
90
|
-
| QA URL | {{QA_BASE_URL}} |
|
|
91
|
-
| Browser | Chromium (Playwright) |
|
|
92
|
-
| Workers (local) | {N} |
|
|
93
|
-
| Workers (CI) | {N} |
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
## 8. Risks and Assumptions
|
|
98
|
-
|
|
99
|
-
| Risk | Likelihood | Impact | Mitigation |
|
|
100
|
-
|------|-----------|--------|------------|
|
|
101
|
-
| Unstable QA data | Medium | High | Use EXEC_IDX-generated data |
|
|
102
|
-
| External service unavailable | High | Medium | Use intercept / mock strategy |
|
|
103
|
-
|
|
104
|
-
---
|
|
105
|
-
|
|
106
|
-
## 9. Excluded TCs
|
|
107
|
-
|
|
108
|
-
| TC ID | Reason for exclusion |
|
|
109
|
-
|-------|---------------------|
|
|
110
|
-
| TC-{M}-{S}-NNN | `BLOCKED-PERMISSIONS` |
|
|
111
|
-
| TC-{M}-{S}-NNN | `PENDING-CODE` |
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
## 10. Execution Schedule
|
|
116
|
-
|
|
117
|
-
| Suite | Trigger | Frequency |
|
|
118
|
-
|-------|---------|-----------|
|
|
119
|
-
| P0 smoke | Every CI build | On push to main / PR |
|
|
120
|
-
| P1 regression | Scheduled | Nightly |
|
|
121
|
-
| P2 full regression | Manual trigger | Before each release |
|
|
122
|
-
|
|
123
|
-
---
|
|
124
|
-
|
|
125
|
-
## Changelog
|
|
126
|
-
|
|
127
|
-
| Version | Date | Description |
|
|
128
|
-
|---------|------|-------------|
|
|
129
|
-
| 1.0 | YYYY-MM-DD | Initial creation |
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
---
|
|
133
|
-
|
|
134
|
-
## Priority Decision Tree
|
|
135
|
-
|
|
136
|
-
```
|
|
137
|
-
Primary happy path of the feature?
|
|
138
|
-
YES → P0
|
|
139
|
-
Critical data corruption or show-stopper risk?
|
|
140
|
-
YES → P0
|
|
141
|
-
Common negative scenario (empty required field, duplicate)?
|
|
142
|
-
YES → P1
|
|
143
|
-
Cross-module dependency or state machine transition?
|
|
144
|
-
YES → P1
|
|
145
|
-
Secondary feature (export, pagination, search)?
|
|
146
|
-
YES → P2
|
|
147
|
-
Edge case, cosmetic, or low-frequency scenario?
|
|
148
|
-
YES → P3
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
---
|
|
152
|
-
|
|
153
|
-
## Automation Feasibility Criteria
|
|
154
|
-
|
|
155
|
-
| Feasibility | Criteria |
|
|
156
|
-
|---|---|
|
|
157
|
-
| Fully automatable | Deterministic, observable via browser, no external system dependency |
|
|
158
|
-
| Partially automatable | External system can be mocked, or some step requires human inspection |
|
|
159
|
-
| Not automatable | Physical access required; irreversible side effects; non-deterministic; BLOCKED-PERMISSIONS |
|