qfai 1.5.6 → 1.6.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/README.md +6 -9
- package/assets/init/.qfai/README.md +1 -3
- package/assets/init/.qfai/assistant/instructions/workflow.md +5 -1
- package/assets/init/.qfai/assistant/skills/qfai-atdd/SKILL.md +3 -5
- package/assets/init/.qfai/assistant/skills/qfai-discussion/references/ui_ux_best_practices.md +1066 -0
- package/assets/init/.qfai/assistant/skills/qfai-implement/SKILL.md +221 -0
- package/assets/init/.qfai/specs/spec-XXXX/tdd/test-list.md +4 -0
- package/dist/cli/index.cjs +2447 -224
- package/dist/cli/index.cjs.map +1 -1
- package/dist/cli/index.mjs +2437 -214
- package/dist/cli/index.mjs.map +1 -1
- package/dist/index.cjs +2228 -23
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +8 -1
- package/dist/index.d.ts +8 -1
- package/dist/index.mjs +2228 -23
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
- package/assets/init/.qfai/assistant/skills/qfai-tdd-green/SKILL.md +0 -126
- package/assets/init/.qfai/assistant/skills/qfai-tdd-red/SKILL.md +0 -126
- package/assets/init/.qfai/assistant/skills/qfai-tdd-refactor/SKILL.md +0 -126
package/README.md
CHANGED
|
@@ -123,7 +123,7 @@ QFAI includes a small set of custom skills (stored under `.qfai/assistant/skills
|
|
|
123
123
|
- **qfai-sdd**: Unified SDD entrypoint with discussion-pack preflight guard (missing/incomplete/blocking OQ causes stop + next action guidance).
|
|
124
124
|
- **qfai-prototyping**: Build an all-spec contract-aligned skeleton and prove runtime coverage before deep coding.
|
|
125
125
|
- **qfai-atdd**: Implement acceptance tests driven by specs/scenarios.
|
|
126
|
-
- **qfai-
|
|
126
|
+
- **qfai-implement**: Unified TDD micro-cycle (Red/Green/Refactor) one test at a time using `test-list.md` as the execution ledger.
|
|
127
127
|
- **qfai-verify**: Run/interpret the local quality gates and produce a release-ready summary.
|
|
128
128
|
|
|
129
129
|
### Workflow sequence (example)
|
|
@@ -166,9 +166,10 @@ AG->>Q: Read .qfai/assistant/skills/qfai-atdd/SKILL.md
|
|
|
166
166
|
AG->>R: Implement acceptance tests
|
|
167
167
|
AG-->>U: ATDD tests ready
|
|
168
168
|
|
|
169
|
-
U->>AG:
|
|
170
|
-
AG->>Q: Read
|
|
171
|
-
AG
|
|
169
|
+
U->>AG: Run /qfai-implement
|
|
170
|
+
AG->>Q: Read .qfai/assistant/skills/qfai-implement/SKILL.md
|
|
171
|
+
AG->>R: Execute TDD micro-cycle (Red/Green/Refactor) per test-list.md
|
|
172
|
+
AG-->>U: Implementation complete
|
|
172
173
|
|
|
173
174
|
U->>AG: Run /qfai-verify
|
|
174
175
|
AG->>Q: Read .qfai/assistant/skills/qfai-verify/SKILL.md
|
|
@@ -357,11 +358,7 @@ Typical customizations.
|
|
|
357
358
|
│ │ │ │ └── SKILL.md
|
|
358
359
|
│ │ │ ├── qfai-atdd
|
|
359
360
|
│ │ │ │ └── SKILL.md
|
|
360
|
-
│ │ │ ├── qfai-
|
|
361
|
-
│ │ │ │ └── SKILL.md
|
|
362
|
-
│ │ │ ├── qfai-tdd-green
|
|
363
|
-
│ │ │ │ └── SKILL.md
|
|
364
|
-
│ │ │ ├── qfai-tdd-refactor
|
|
361
|
+
│ │ │ ├── qfai-implement
|
|
365
362
|
│ │ │ │ └── SKILL.md
|
|
366
363
|
│ │ │ └── qfai-verify
|
|
367
364
|
│ │ │ └── SKILL.md
|
|
@@ -17,9 +17,7 @@ flowchart TD
|
|
|
17
17
|
A[/qfai-discussion/] --> C[/qfai-sdd/]
|
|
18
18
|
C --> D[/qfai-prototyping/]
|
|
19
19
|
D --> E[/qfai-atdd/]
|
|
20
|
-
E --> F[/qfai-
|
|
21
|
-
F --> G[/qfai-tdd-green/]
|
|
22
|
-
G --> H[/qfai-tdd-refactor/]
|
|
20
|
+
E --> F[/qfai-implement/]
|
|
23
21
|
```
|
|
24
22
|
|
|
25
23
|
> Formatting must follow the templates and checklists documented in each directory README.
|
|
@@ -66,9 +66,13 @@ Prototyping stage policy:
|
|
|
66
66
|
- Completion requires prototyping evidence (markdown + json in `.qfai/evidence/`) and `qfai validate --fail-on error` pass.
|
|
67
67
|
- Coverage gaps (missing spec rows, unresolved declared checks, API 404) are blocking.
|
|
68
68
|
|
|
69
|
+
Implementation stage:
|
|
70
|
+
|
|
71
|
+
- `/qfai-implement` orchestrates the full TDD micro-cycle (Red/Green/Refactor) one test at a time using `test-list.md` as the execution ledger.
|
|
72
|
+
|
|
69
73
|
Legacy note:
|
|
70
74
|
|
|
71
|
-
-
|
|
75
|
+
- The three legacy TDD skills were abolished. Use `/qfai-implement` instead.
|
|
72
76
|
|
|
73
77
|
### Stage 0 — Steering refresh contract (mandatory)
|
|
74
78
|
|
|
@@ -228,7 +228,7 @@ Turn specs/contracts obligations (`US` / `TC` / `CON-API`) into runnable accepta
|
|
|
228
228
|
## Scope (ATDD only)
|
|
229
229
|
|
|
230
230
|
- In scope: E2E, API, Integration.
|
|
231
|
-
- Out of scope: Unit and Component (`/qfai-
|
|
231
|
+
- Out of scope: Unit and Component (`/qfai-implement`).
|
|
232
232
|
|
|
233
233
|
## Non-goals
|
|
234
234
|
|
|
@@ -421,9 +421,7 @@ When declaring DONE, include:
|
|
|
421
421
|
|
|
422
422
|
When this skill is complete, provide a final user-facing completion message and enumerate all actionable next steps.
|
|
423
423
|
|
|
424
|
-
- Proceed (recommended): `/qfai-
|
|
425
|
-
Action:
|
|
424
|
+
- Proceed (recommended): `/qfai-implement`.
|
|
425
|
+
Action: run unified TDD micro-cycle (Red/Green/Refactor) one test at a time from test-list.md.
|
|
426
426
|
- Acceptance tests need fixes: rerun `/qfai-atdd`.
|
|
427
427
|
Action: close uncovered `US` / `TC` / `CON-API` obligations and rerun validation.
|
|
428
|
-
- Implementation phase: `/qfai-tdd-green`.
|
|
429
|
-
Action: implement code to satisfy failing tests.
|