@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.
Files changed (109) hide show
  1. package/CHANGELOG.md +340 -0
  2. package/README.md +42 -2
  3. package/docs/architecture.md +30 -26
  4. package/docs/decisions/lane-heartbeat-caller.md +86 -0
  5. package/docs/final-report.md +23 -23
  6. package/docs/folder-structure-guide.md +100 -80
  7. package/docs/installation.md +42 -7
  8. package/docs/skills-architecture.md +23 -23
  9. package/docs/spec-driven-philosophy.md +9 -9
  10. package/docs/usage-with-agent.md +88 -9
  11. package/docs/visuals/diag-01-ejecutivo-1.png +0 -0
  12. package/docs/visuals/diag-02-tactico-1.png +0 -0
  13. package/docs/visuals/diag-03-tecnico-1.png +0 -0
  14. package/docs/visuals/info-01-ejecutivo-1.png +0 -0
  15. package/docs/visuals/info-02-tactico-1.png +0 -0
  16. package/docs/visuals/info-03-tecnico-1.png +0 -0
  17. package/docs/visuals/pres-01-ejecutivo-1.png +0 -0
  18. package/docs/visuals/pres-02-tactico-1.png +0 -0
  19. package/docs/visuals/pres-03-tecnico-1.png +0 -0
  20. package/docs/visuals/qa-01-problema-1.png +0 -0
  21. package/docs/visuals/qa-02-que-es-1.png +0 -0
  22. package/docs/visuals/qa-03-pipeline-1.png +0 -0
  23. package/docs/visuals/qa-04-6-archivos-1.png +0 -0
  24. package/docs/visuals/qa-05-humano-1.png +0 -0
  25. package/docs/visuals/qa-06-agente-1.png +0 -0
  26. package/docs/visuals/qa-07-skills-arch-1.png +0 -0
  27. package/docs/visuals/qa-08-traceability-1.png +0 -0
  28. package/docs/visuals/qa-en-01-problem-1.png +0 -0
  29. package/docs/visuals/qa-en-02-what-is-1.png +0 -0
  30. package/docs/visuals/qa-en-03-pipeline-1.png +0 -0
  31. package/docs/visuals/qa-en-04-6files-1.png +0 -0
  32. package/docs/visuals/qa-en-05-human-1.png +0 -0
  33. package/docs/visuals/qa-en-06-agent-1.png +0 -0
  34. package/docs/visuals/qa-en-07-skills-arch-1.png +0 -0
  35. package/docs/visuals/qa-en-08-traceability-1.png +0 -0
  36. package/examples/module-example/suppliers/00-inventory.md +1 -1
  37. package/examples/module-example/suppliers/suppliers-create.spec.ts +8 -8
  38. package/integrations/ado-powershell/README.md +1 -1
  39. package/integrations/ado-powershell/scripts/sync-ado-titles.ps1 +2 -2
  40. package/integrations/playwright/README.md +4 -4
  41. package/package.json +7 -3
  42. package/qa-framework.config.json +25 -3
  43. package/scripts/check-forbidden-chars.js +187 -0
  44. package/scripts/check-spanish-accents.js +159 -0
  45. package/scripts/cli.js +1 -1
  46. package/scripts/generate.js +2 -2
  47. package/scripts/init.js +101 -12
  48. package/scripts/lib/claude-agents.js +347 -0
  49. package/scripts/lib/claude-commands.js +56 -0
  50. package/scripts/lib/module-keys.js +54 -0
  51. package/scripts/sync-version.js +63 -0
  52. package/scripts/upgrade.js +369 -20
  53. package/scripts/validate.js +46 -21
  54. package/skills/qa-ado-integration/SKILL.md +19 -19
  55. package/skills/qa-ado-integration/references/scripts-and-config.md +6 -6
  56. package/skills/qa-automation/SKILL.md +49 -27
  57. package/skills/qa-automation/references/config-checklist.md +4 -4
  58. package/skills/qa-automation/references/dom-inspection-template.js +7 -7
  59. package/skills/qa-automation/references/patterns.md +20 -20
  60. package/skills/qa-automation/references/pom-template.md +161 -0
  61. package/skills/qa-maintenance/SKILL.md +11 -11
  62. package/skills/qa-maintenance/references/update-rules.md +8 -8
  63. package/skills/qa-module-analysis/SKILL.md +20 -19
  64. package/skills/qa-module-analysis/references/exploration-checklist.md +4 -4
  65. package/skills/qa-module-analysis/references/output-verification.md +69 -0
  66. package/skills/qa-module-analysis/references/spec-file-formats.md +14 -14
  67. package/skills/qa-spec-generation/SKILL.md +13 -7
  68. package/skills/qa-test-cases/SKILL.md +11 -81
  69. package/skills/qa-test-cases/references/test-case-template.md +5 -5
  70. package/skills/qa-test-plan/SKILL.md +22 -86
  71. package/skills/qa-test-plan/references/plan-de-pruebas-template.md +24 -24
  72. package/skills/qa-test-stabilization/SKILL.md +59 -30
  73. package/skills/qa-test-stabilization/references/classification-protocol.md +35 -35
  74. package/templates/agent-next-steps.md +10 -10
  75. package/templates/agents/qa-analisis.md +142 -0
  76. package/templates/agents/qa-asesoria.md +48 -0
  77. package/templates/agents/qa-informe-resultados.md +236 -0
  78. package/templates/agents/qa-investigador.md +143 -0
  79. package/templates/agents/qa-plan.md +131 -0
  80. package/templates/agents/qa-reporte-ejecucion.md +138 -0
  81. package/templates/automation-scaffold/.env.example +36 -6
  82. package/templates/automation-scaffold/fixtures/auth.ts +27 -5
  83. package/templates/automation-scaffold/fixtures/base.ts +23 -1
  84. package/templates/automation-scaffold/fixtures/test-helpers.ts +1 -1
  85. package/templates/automation-scaffold/global-setup.ts +117 -48
  86. package/templates/automation-scaffold/playwright.config.ts +72 -32
  87. package/templates/automation-scaffold/scripts/global-setup-guards.js +184 -0
  88. package/templates/automation-scaffold/scripts/lane-config.js +269 -0
  89. package/templates/automation-scaffold/scripts/lane-lock.js +589 -0
  90. package/templates/defect-report.md +17 -3
  91. package/templates/execution-report.md +9 -9
  92. package/templates/integration-scaffold/.env.example +1 -1
  93. package/templates/integration-scaffold/global-setup.ts +21 -1
  94. package/templates/integration-scaffold/playwright.config.ts +15 -1
  95. package/templates/qa-framework.instructions.md +9 -8
  96. package/templates/qa-framework.rules.md +53 -0
  97. package/templates/qa-readme.md +8 -8
  98. package/templates/session-summary.md +2 -2
  99. package/templates/specification/00-inventory.md +3 -3
  100. package/templates/specification/01-business-rules.md +6 -6
  101. package/templates/specification/02-workflows.md +1 -1
  102. package/templates/specification/03-roles-permissions.md +1 -1
  103. package/templates/specification/04-test-data.md +8 -8
  104. package/templates/specification/05-test-scenarios.md +5 -5
  105. package/templates/test-case.md +3 -3
  106. package/templates/test-data-guidelines.md +7 -7
  107. package/templates/test-plan-sprint.md +13 -13
  108. package/templates/test-plan.md +3 -3
  109. 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 |