@rasensio/aidlc-content 1.3.0 → 1.4.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/package.json +1 -1
- package/skills/20-requirements.md +1 -0
- package/skills/30-design.md +1 -1
- package/skills/50-testing.md +6 -0
package/package.json
CHANGED
|
@@ -27,6 +27,7 @@ Translate the ideation output (or the user's direct request) into precise, testa
|
|
|
27
27
|
- Specific and unambiguous
|
|
28
28
|
- Testable (an observable outcome)
|
|
29
29
|
- Independent (not relying on unstated assumptions)
|
|
30
|
+
- **Identified**: write every criterion as a list item `- AC-<n>: <text>` (bold variants `- **AC-<n>**: ...` and `- **AC-<n>:** ...` are also valid). Assign `AC-1`, `AC-2`, ... sequentially. IDs are never renumbered or reused — an amended criterion keeps its meaning or is retired: mark it `- AC-<n> (retired YYYY-MM-DD, superseded by AC-<m>): <text>` and issue a new ID. The testing-phase gate parses these IDs and fails on any active criterion without a referencing test.
|
|
30
31
|
4. **Set scope boundaries.** Explicitly state what is NOT included.
|
|
31
32
|
5. **Non-functional requirements.** Address performance, security, accessibility, and compatibility where relevant.
|
|
32
33
|
6. **For complex input or open decisions**: If requirements are extensive, or unresolved decisions block the draft, create an Input_File in `.aidlc/inbox/` following the User Input Protocol in **aidlc-overview**, rather than asking many sequential questions. Prefer drafting `requirements.md` early with unresolved points marked as explicit decision blocks — users decide better reacting to a concrete draft than answering abstract questions.
|
package/skills/30-design.md
CHANGED
|
@@ -21,7 +21,7 @@ Produce a technical design that satisfies the requirements. Define architecture,
|
|
|
21
21
|
|
|
22
22
|
## Instructions
|
|
23
23
|
|
|
24
|
-
1. **Review requirements.** Read `requirements.md` (or its summary if one exists). Identify the key technical challenges.
|
|
24
|
+
1. **Review requirements.** Read `requirements.md` (or its summary if one exists). Identify the key technical challenges. When requirements carry `AC-n` IDs, note in each design section which criteria it addresses — that linkage is what reviewers and the testing phase trace against.
|
|
25
25
|
2. **Consult the knowledge graph.** If the project has a knowledge graph (`.aidlc/knowledge/` exists), run `aidlc knowledge context --scope phase --phase design` for existing architecture, decisions, and conventions before re-deriving them from code.
|
|
26
26
|
3. **Define architecture.** Describe the high-level structure: components, their responsibilities, and how they communicate.
|
|
27
27
|
4. **Specify interfaces.** For each component boundary, define the contract (function signatures, API shapes, data types).
|
package/skills/50-testing.md
CHANGED
|
@@ -27,11 +27,17 @@ Verify that the implementation satisfies all acceptance criteria. Produce eviden
|
|
|
27
27
|
- Unit tests for pure logic and edge cases
|
|
28
28
|
- Integration tests for component interactions
|
|
29
29
|
- Property-based tests where inputs have broad domains
|
|
30
|
+
- **Reference AC IDs.** When `requirements.md` defines `AC-n` criteria, each test names the criteria it verifies — in the test name or a comment (e.g. `// AC-3`). The testing-phase gate scans test files for these references and fails on any active criterion with none. If two instances define the same ID, qualify the reference as `<instance>/AC-n`.
|
|
30
31
|
3. **Run tests.** Execute the project's test suite. All new tests must pass.
|
|
31
32
|
4. **Document results.** Write `testing.md` with:
|
|
32
33
|
- Test plan (what was tested and why)
|
|
33
34
|
- Results (pass/fail counts, any notable findings)
|
|
34
35
|
- Coverage notes (which criteria are covered, any gaps)
|
|
36
|
+
- **`ac-coverage` block for indirect coverage.** A criterion verified manually or outside scannable test files is claimed in a fenced code block whose info string is `ac-coverage`, one `AC-<n>: <evidence>` line per entry — the gate unions these with scanned references:
|
|
37
|
+
|
|
38
|
+
```ac-coverage
|
|
39
|
+
AC-7: verified manually — see results table above
|
|
40
|
+
```
|
|
35
41
|
5. **Address failures.** If tests reveal bugs, fix the implementation. Do not skip or weaken tests to force a pass.
|
|
36
42
|
|
|
37
43
|
## Exit Criteria
|