agentic-code 0.5.1 → 0.6.1

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 (29) hide show
  1. package/.agents/context-maps/{task-rule-matrix.yaml → task-skills-matrix.yaml} +98 -110
  2. package/.agents/{rules/core/ai-development-guide.md → skills/ai-development-guide/SKILL.md} +9 -2
  3. package/.agents/{rules/language/general/rules.md → skills/coding-rules/SKILL.md} +14 -2
  4. package/.agents/{rules/language/typescript/rules.md → skills/coding-rules/references/typescript.md} +18 -54
  5. package/.agents/{rules/core/documentation-criteria.md → skills/documentation-criteria/SKILL.md} +8 -1
  6. package/.agents/{rules/contextual/architecture/implementation-approach.md → skills/implementation-approach/SKILL.md} +8 -1
  7. package/.agents/{rules/core/integration-e2e-testing.md → skills/integration-e2e-testing/SKILL.md} +7 -0
  8. package/.agents/{rules/core/metacognition.md → skills/metacognition/SKILL.md} +10 -3
  9. package/.agents/{rules/language/general/testing.md → skills/testing/SKILL.md} +17 -32
  10. package/.agents/skills/testing/references/typescript.md +134 -0
  11. package/.agents/{rules/core/testing-strategy.md → skills/testing-strategy/SKILL.md} +7 -0
  12. package/.agents/tasks/acceptance-test-generation.md +38 -38
  13. package/.agents/tasks/code-review.md +6 -6
  14. package/.agents/tasks/implementation.md +34 -34
  15. package/.agents/tasks/integration-test-review.md +8 -8
  16. package/.agents/tasks/prd-creation.md +20 -20
  17. package/.agents/tasks/quality-assurance.md +26 -26
  18. package/.agents/tasks/task-analysis.md +20 -20
  19. package/.agents/tasks/technical-design.md +26 -26
  20. package/.agents/tasks/technical-document-review.md +8 -8
  21. package/.agents/tasks/work-planning.md +39 -39
  22. package/.agents/workflows/agentic-coding.md +30 -30
  23. package/AGENTS.md +26 -33
  24. package/README.md +18 -16
  25. package/bin/cli.js +6 -17
  26. package/bin/install-codex-skills.js +127 -0
  27. package/package.json +9 -12
  28. package/.agents/rules/language/typescript/testing.md +0 -284
  29. package/scripts/setup.js +0 -82
@@ -0,0 +1,134 @@
1
+ # TypeScript/Vitest Testing Rules
2
+
3
+ ## Test Framework
4
+ - **Vitest**: This project uses Vitest
5
+ - Test imports: `import { describe, it, expect, beforeEach, vi } from 'vitest'`
6
+ - Mock creation: Use `vi.mock()`
7
+
8
+ ## Directory Structure
9
+
10
+ **File structure:**
11
+ - src/application/services/service.ts: Main service file
12
+ - src/application/services/__tests__/service.test.ts: Unit tests
13
+ - src/application/services/__tests__/service.int.test.ts: Integration tests
14
+
15
+ **Naming Conventions:**
16
+ - Test files: `{target-file-name}.test.ts`
17
+ - Integration test files: `{target-file-name}.int.test.ts`
18
+
19
+ ## Cross-functional E2E Test Patterns
20
+
21
+ ```typescript
22
+ describe('Cross-functional E2E Tests', () => {
23
+ // Pattern 1: Baseline → Change → Verify
24
+ it('should maintain existing behavior after new feature', async () => {
25
+ // 1. Capture baseline
26
+ const baseline = await testExistingFeature()
27
+
28
+ // 2. Enable new feature
29
+ await enableNewFeature()
30
+
31
+ // 3. Verify continuity
32
+ const result = await testExistingFeature()
33
+ expect(result).toEqual(baseline)
34
+ expect(result.responseTime).toBeLessThan(
35
+ baseline.responseTime * 1.2 // Project-specific threshold
36
+ )
37
+ })
38
+
39
+ // Pattern 2: Data integrity across features
40
+ it('should preserve data integrity', async () => {
41
+ const data = await createTestData()
42
+ await newFeatureOperation(data.id)
43
+
44
+ const retrieved = await existingFeatureGet(data.id)
45
+ expect(retrieved).toEqual(data) // No unexpected mutations
46
+ })
47
+ })
48
+ ```
49
+
50
+ **Note**: LLM outputs naturally vary - test behavior, not exact matches
51
+
52
+ ## Test Helper Usage Examples
53
+
54
+ ```typescript
55
+ // ✅ Recommended: Utilize builder pattern
56
+ const testData = new TestDataBuilder()
57
+ .withDefaults()
58
+ .withName('Test User')
59
+ .build()
60
+
61
+ // ✅ Recommended: Custom assertions
62
+ function assertValidUser(user: unknown): asserts user is User {
63
+ // Validation logic
64
+ }
65
+
66
+ // ❌ Avoid: Individual implementation of duplicate complex mocks
67
+ ```
68
+
69
+ ## Test Granularity Examples
70
+
71
+ ```typescript
72
+ // ✅ Test observable behavior
73
+ expect(calculatePrice(100, 0.1)).toBe(110)
74
+
75
+ // ❌ Test implementation details (as any access)
76
+ expect((calculator as any).taxRate).toBe(0.1)
77
+ expect((service as any).validate(input)).toBe(true)
78
+ ```
79
+
80
+ ## Mock Type Safety Enforcement
81
+
82
+ ### Minimal Type Definition Requirements
83
+ ```typescript
84
+ // ✅ Only required parts
85
+ type TestRepo = Pick<Repository, 'find' | 'save'>
86
+ const mock: TestRepo = { find: vi.fn(), save: vi.fn() }
87
+
88
+ // Only when absolutely necessary, with clear justification
89
+ const sdkMock = {
90
+ call: vi.fn()
91
+ } as unknown as ExternalSDK // Complex external SDK type structure
92
+ ```
93
+
94
+ ## Basic Vitest Example
95
+
96
+ ```typescript
97
+ import { describe, it, expect, beforeEach, vi } from 'vitest'
98
+
99
+ // Mock setup example
100
+ vi.mock('./userService', () => ({
101
+ getUserById: vi.fn(),
102
+ updateUser: vi.fn()
103
+ }))
104
+
105
+ describe('ComponentName', () => {
106
+ it('should follow AAA pattern', () => {
107
+ // Arrange
108
+ const input = 'test'
109
+
110
+ // Act
111
+ const result = someFunction(input)
112
+
113
+ // Assert
114
+ expect(result).toBe('expected')
115
+ })
116
+ })
117
+ ```
118
+
119
+ ## Quality Check Commands [MANDATORY for VERIFY phase]
120
+
121
+ **ALL TypeScript/JavaScript commands MUST pass with 0 errors before task completion:**
122
+
123
+ ```bash
124
+ npm test # MUST pass all tests
125
+ npm run build # MUST build successfully
126
+ npm run lint # MUST have 0 lint errors
127
+ npm run type-check # MUST have 0 type errors
128
+ ```
129
+
130
+ **ENFORCEMENT:**
131
+ - Run ALL applicable commands listed above
132
+ - Fix ANY errors or warnings before marking task complete
133
+ - If command doesn't exist in package.json, skip that specific command
134
+ - Document which commands were run in task completion
@@ -1,3 +1,10 @@
1
+ ---
2
+ name: testing-strategy
3
+ description: |
4
+ ROI-based test selection framework with calculation formula, critical user journey definitions, and test prioritization guidelines.
5
+ Use when: designing test strategy, selecting which tests to write, calculating test ROI, or prioritizing test coverage.
6
+ ---
7
+
1
8
  # Test Strategy: ROI-Based Selection
2
9
 
3
10
  ## Core Principle: Maximum Coverage, Minimum Tests
@@ -2,59 +2,59 @@
2
2
 
3
3
  ## Required Rules [MANDATORY - MUST BE ACTIVE]
4
4
 
5
- **RULE AVAILABILITY VERIFICATION:**
6
- 1. [LOAD IF NOT ACTIVE] `.agents/rules/language/testing.md`
7
- 2. [LOAD IF NOT ACTIVE] `.agents/rules/core/documentation-criteria.md`
8
- 3. [LOAD IF NOT ACTIVE] `.agents/rules/core/testing-strategy.md`
9
- 4. [LOAD IF NOT ACTIVE] `.agents/rules/core/integration-e2e-testing.md`
5
+ **SKILL AVAILABILITY VERIFICATION:**
6
+ 1. [LOAD IF NOT ACTIVE] `.agents/skills/testing/SKILL.md`
7
+ 2. [LOAD IF NOT ACTIVE] `.agents/skills/documentation-criteria/SKILL.md`
8
+ 3. [LOAD IF NOT ACTIVE] `.agents/skills/testing-strategy/SKILL.md`
9
+ 4. [LOAD IF NOT ACTIVE] `.agents/skills/integration-e2e-testing/SKILL.md`
10
10
 
11
11
  **LOADING PROTOCOL:**
12
- - STEP 1: CHECK if language/testing.md is active in working memory
13
- - STEP 2: If language/testing.md NOT active → Execute BLOCKING READ
14
- - STEP 3: CHECK if documentation-criteria.md is active in working memory
15
- - STEP 4: If documentation-criteria.md NOT active → Execute BLOCKING READ
16
- - STEP 5: CHECK if testing-strategy.md is active in working memory
17
- - STEP 6: If testing-strategy.md NOT active → Execute BLOCKING READ
18
- - STEP 7: CHECK if integration-e2e-testing.md is active in working memory
19
- - STEP 8: If integration-e2e-testing.md NOT active → Execute BLOCKING READ
20
- - STEP 9: CONFIRM all required rules active before proceeding
21
-
22
- ## Plan Injection Requirement [MANDATORY]
23
-
24
- **Upon reading this file, IMMEDIATELY inject to work plan:**
12
+ - STEP 1: CHECK if testing/SKILL.md is active in working memory
13
+ - STEP 2: If testing/SKILL.md NOT active → Execute BLOCKING READ
14
+ - STEP 3: CHECK if documentation-criteria/SKILL.md is active in working memory
15
+ - STEP 4: If documentation-criteria/SKILL.md NOT active → Execute BLOCKING READ
16
+ - STEP 5: CHECK if testing-strategy/SKILL.md is active in working memory
17
+ - STEP 6: If testing-strategy/SKILL.md NOT active → Execute BLOCKING READ
18
+ - STEP 7: CHECK if integration-e2e-testing/SKILL.md is active in working memory
19
+ - STEP 8: If integration-e2e-testing/SKILL.md NOT active → Execute BLOCKING READ
20
+ - STEP 9: CONFIRM all required skills active before proceeding
21
+
22
+ ## Task Tracking Requirement [MANDATORY]
23
+
24
+ **Upon reading this file, IMMEDIATELY add to your internal task management (Task List):**
25
25
  1. All BLOCKING READs identified in Loading Protocol above:
26
- - `.agents/rules/language/testing.md` (if not active)
27
- - `.agents/rules/core/documentation-criteria.md` (if not active)
28
- - `.agents/rules/core/testing-strategy.md` (if not active)
29
- - `.agents/rules/core/integration-e2e-testing.md` (if not active)
26
+ - `.agents/skills/testing/SKILL.md` (if not active)
27
+ - `.agents/skills/documentation-criteria/SKILL.md` (if not active)
28
+ - `.agents/skills/testing-strategy/SKILL.md` (if not active)
29
+ - `.agents/skills/integration-e2e-testing/SKILL.md` (if not active)
30
30
  2. Mark each with "[From acceptance-test-generation.md]" source tag
31
- 3. Show evidence of injection:
31
+ 3. Show evidence:
32
32
  ```
33
- [PLAN INJECTION FROM acceptance-test-generation.md]
34
- Injected to work plan:
35
- ✓ BLOCKING READ: language/testing.md - testing standards
36
- ✓ BLOCKING READ: documentation-criteria.md - document analysis
37
- ✓ BLOCKING READ: testing-strategy.md - ROI-based test selection
38
- ✓ BLOCKING READ: integration-e2e-testing.md - integration/E2E test design
33
+ [TASK TRACKING FROM acceptance-test-generation.md]
34
+ Added to Task List:
35
+ ✓ BLOCKING READ: testing/SKILL.md - testing standards
36
+ ✓ BLOCKING READ: documentation-criteria/SKILL.md - document analysis
37
+ ✓ BLOCKING READ: testing-strategy/SKILL.md - ROI-based test selection
38
+ ✓ BLOCKING READ: integration-e2e-testing/SKILL.md - integration/E2E test design
39
39
  Status: VERIFIED
40
40
  ```
41
41
 
42
- **ENFORCEMENT:** Cannot proceed without Plan Injection evidence
42
+ **ENFORCEMENT:** Cannot proceed without Task Tracking evidence
43
43
 
44
44
  **EVIDENCE REQUIRED:**
45
45
  ```
46
- Rule Status Verification:
47
- language/testing.md - ACTIVE
48
- ✓ documentation-criteria.md - ACTIVE
49
- ✓ testing-strategy.md - ACTIVE
50
- ✓ integration-e2e-testing.md - ACTIVE
46
+ Skill Status Verification:
47
+ testing/SKILL.md - ACTIVE
48
+ ✓ documentation-criteria/SKILL.md - ACTIVE
49
+ ✓ testing-strategy/SKILL.md - ACTIVE
50
+ ✓ integration-e2e-testing/SKILL.md - ACTIVE
51
51
  ```
52
52
 
53
53
  ## Phase Entry Gate [BLOCKING - SYSTEM HALT IF VIOLATED]
54
54
 
55
55
  **CHECKPOINT: System CANNOT proceed until ALL boxes checked:**
56
- ☐ [VERIFIED] Plan Injection completed (from acceptance-test-generation.md)
57
- ☐ [VERIFIED] Work plan contains ALL BLOCKING READs from this file
56
+ ☐ [VERIFIED] Task Tracking completed (from acceptance-test-generation.md)
57
+ ☐ [VERIFIED] Task List contains ALL BLOCKING READs from this file
58
58
  ☐ [VERIFIED] Design document exists and contains Acceptance Criteria section
59
59
  ☐ [VERIFIED] Project testing structure investigated (existing test patterns)
60
60
  ☐ [VERIFIED] Test framework configuration confirmed
@@ -244,7 +244,7 @@ Where:
244
244
  - Test Level Cost: Unit=3, Integration=11, E2E=38
245
245
  ```
246
246
 
247
- **See**: `.agents/rules/core/testing-strategy.md` for detailed ROI framework
247
+ **See**: `.agents/skills/testing-strategy/SKILL.md` for detailed ROI framework
248
248
 
249
249
  **4.2 Deduplication Check**
250
250
 
@@ -2,16 +2,16 @@
2
2
 
3
3
  ## Required Rules [MANDATORY - MUST BE ACTIVE]
4
4
 
5
- **RULE AVAILABILITY VERIFICATION:**
6
- 1. [LOAD IF NOT ACTIVE] `.agents/rules/language/rules.md`
7
- 2. [LOAD IF NOT ACTIVE] `.agents/rules/core/ai-development-guide.md`
5
+ **SKILL AVAILABILITY VERIFICATION:**
6
+ 1. [LOAD IF NOT ACTIVE] `.agents/skills/coding-rules/SKILL.md`
7
+ 2. [LOAD IF NOT ACTIVE] `.agents/skills/ai-development-guide/SKILL.md`
8
8
 
9
9
  **LOADING PROTOCOL:**
10
- - STEP 1: CHECK if `.agents/rules/language/rules.md` is active in working memory
10
+ - STEP 1: CHECK if `.agents/skills/coding-rules/SKILL.md` is active in working memory
11
11
  - STEP 2: If NOT active → Execute BLOCKING READ
12
- - STEP 3: CHECK if `.agents/rules/core/ai-development-guide.md` is active in working memory
12
+ - STEP 3: CHECK if `.agents/skills/ai-development-guide/SKILL.md` is active in working memory
13
13
  - STEP 4: If NOT active → Execute BLOCKING READ
14
- - STEP 5: CONFIRM all required rules active before proceeding
14
+ - STEP 5: CONFIRM all required skills active before proceeding
15
15
 
16
16
  ## Purpose
17
17
 
@@ -2,54 +2,54 @@
2
2
 
3
3
  ## Required Rules [MANDATORY - MUST BE ACTIVE]
4
4
 
5
- **RULE AVAILABILITY VERIFICATION:**
6
- 1. [VERIFY ACTIVE] `.agents/rules/core/metacognition.md`
7
- 2. [LOAD IF NOT ACTIVE] `.agents/rules/language/rules.md`
8
- 3. [LOAD IF NOT ACTIVE] `.agents/rules/language/testing.md`
5
+ **SKILL AVAILABILITY VERIFICATION:**
6
+ 1. [VERIFY ACTIVE] `.agents/skills/metacognition/SKILL.md`
7
+ 2. [LOAD IF NOT ACTIVE] `.agents/skills/coding-rules/SKILL.md`
8
+ 3. [LOAD IF NOT ACTIVE] `.agents/skills/testing/SKILL.md`
9
9
 
10
10
  **LOADING PROTOCOL:**
11
- - STEP 1: VERIFY metacognition.md is active from initial session setup
12
- - STEP 2: CHECK if language/rules.md is active in working memory
13
- - STEP 3: If language/rules.md NOT active → Execute BLOCKING READ
14
- - STEP 4: CHECK if testing.md is active in working memory
15
- - STEP 5: If testing.md NOT active → Execute BLOCKING READ
16
- - STEP 6: CONFIRM all rules active before writing ANY code
11
+ - STEP 1: VERIFY metacognition/SKILL.md is active from initial session setup
12
+ - STEP 2: CHECK if coding-rules/SKILL.md is active in working memory
13
+ - STEP 3: If coding-rules/SKILL.md NOT active → Execute BLOCKING READ
14
+ - STEP 4: CHECK if testing/SKILL.md is active in working memory
15
+ - STEP 5: If testing/SKILL.md NOT active → Execute BLOCKING READ
16
+ - STEP 6: CONFIRM all skills active before writing ANY code
17
17
 
18
- ## Plan Injection Requirement [MANDATORY]
18
+ ## Task Tracking Requirement [MANDATORY]
19
19
 
20
- **Upon reading this file, IMMEDIATELY inject to work plan:**
20
+ **Upon reading this file, IMMEDIATELY add to your internal task management (Task List):**
21
21
  1. All BLOCKING READs identified in Loading Protocol above:
22
- - `.agents/rules/language/rules.md` (if not active)
23
- - `.agents/rules/language/testing.md` (if not active)
22
+ - `.agents/skills/coding-rules/SKILL.md` (if not active)
23
+ - `.agents/skills/testing/SKILL.md` (if not active)
24
24
  2. Mark each with "[From implementation.md]" source tag
25
- 3. Show evidence of injection:
25
+ 3. Show evidence:
26
26
  ```
27
- [PLAN INJECTION FROM implementation.md]
28
- Injected to work plan:
29
- ✓ BLOCKING READ: language/rules.md - development standards
30
- ✓ BLOCKING READ: language/testing.md - TDD process
27
+ [TASK TRACKING FROM implementation.md]
28
+ Added to Task List:
29
+ ✓ BLOCKING READ: coding-rules/SKILL.md - development standards
30
+ ✓ BLOCKING READ: testing/SKILL.md - TDD process
31
31
  Status: VERIFIED
32
32
  ```
33
33
 
34
- **ENFORCEMENT:** Cannot proceed without Plan Injection evidence
34
+ **ENFORCEMENT:** Cannot proceed without Task Tracking evidence
35
35
 
36
36
  **EVIDENCE REQUIRED:**
37
37
  ```
38
- Rule Status Verification:
39
- ✓ metacognition.md - ACTIVE (from session setup)
40
- language/rules.md - ACTIVE (loaded/verified)
41
- language/testing.md - ACTIVE (loaded/verified)
38
+ Skill Status Verification:
39
+ ✓ metacognition/SKILL.md - ACTIVE (from session setup)
40
+ coding-rules/SKILL.md - ACTIVE (loaded/verified)
41
+ testing/SKILL.md - ACTIVE (loaded/verified)
42
42
  ```
43
43
 
44
44
  ## Phase Entry Gate [BLOCKING - SYSTEM HALT IF VIOLATED]
45
45
 
46
46
  **CHECKPOINT: System CANNOT write ANY CODE until ALL boxes checked:**
47
47
  ☐ [VERIFIED] THIS FILE (`implementation.md`) has been READ and is active
48
- ☐ [VERIFIED] Plan Injection completed (from implementation.md Plan Injection Requirement)
48
+ ☐ [VERIFIED] Task Tracking completed (from implementation.md Task Tracking Requirement)
49
49
  ☐ [VERIFIED] All required rules listed above are LOADED and active
50
- ☐ [VERIFIED] Work plan EXISTS with task definitions
51
- ☐ [VERIFIED] Work plan contains ALL BLOCKING READs from this file
52
- ☐ [VERIFIED] Current task identified from work plan
50
+ ☐ [VERIFIED] Work Plan document EXISTS with task definitions
51
+ ☐ [VERIFIED] Task List contains ALL BLOCKING READs from this file
52
+ ☐ [VERIFIED] Current task identified from Work Plan document
53
53
  ☐ [VERIFIED] TDD process understood (Red-Green-Refactor-Verify)
54
54
  ☐ [VERIFIED] SESSION_BASELINE_DATE established and active
55
55
 
@@ -99,18 +99,18 @@ Implement code using TDD process.
99
99
 
100
100
  **3. REFACTOR Phase - Improve code**
101
101
  - Clean up implementation
102
- - Apply coding standards from language/rules.md
102
+ - Apply coding standards from coding-rules/SKILL.md
103
103
  - Ensure test still passes
104
104
 
105
105
  **4. VERIFY Phase - Quality checks**
106
- - Execute ALL commands from language/testing.md Quality Check Commands section
106
+ - Execute ALL commands from testing/SKILL.md Quality Check Commands section
107
107
  - Confirm ALL checks pass with 0 errors
108
108
  - Ready for commit
109
109
 
110
110
  **5. COMMIT Phase - Version control [MANDATORY]**
111
111
  - Stage changes for current implementation
112
112
  - Create commit with descriptive message
113
- - Commit message format: "feat: [what was implemented]" or follow work plan task name if available
113
+ - Commit message format: "feat: [what was implemented]" or follow Work Plan task name if available
114
114
  - ENFORCEMENT: Implementation task NOT complete until committed
115
115
  - NOTE: Skip if user explicitly says "don't commit"
116
116
 
@@ -157,7 +157,7 @@ Regardless of language:
157
157
 
158
158
  ### 6. Testing Approach
159
159
 
160
- **REFERENCE `.agents/rules/language/testing.md` for complete testing strategy including:**
160
+ **REFERENCE `.agents/skills/testing/SKILL.md` for complete testing strategy including:**
161
161
  - Test types and granularity
162
162
  - Test-first development process
163
163
  - Coverage requirements
@@ -188,8 +188,8 @@ Always:
188
188
 
189
189
  Essential completion requirements:
190
190
  □ ALL quality standards from quality-assurance.md satisfied
191
- □ ALL language requirements from language/rules.md met
192
- □ ALL testing requirements from testing.md completed
191
+ □ ALL language requirements from coding-rules/SKILL.md met
192
+ □ ALL testing requirements from testing/SKILL.md completed
193
193
  □ Work plan task checkbox updated to [✓]
194
194
  □ Metacognition "After Completion" executed
195
195
 
@@ -2,16 +2,16 @@
2
2
 
3
3
  ## Required Rules [MANDATORY - MUST BE ACTIVE]
4
4
 
5
- **RULE AVAILABILITY VERIFICATION:**
6
- 1. [LOAD IF NOT ACTIVE] `.agents/rules/language/testing.md`
7
- 2. [LOAD IF NOT ACTIVE] `.agents/rules/core/integration-e2e-testing.md`
5
+ **SKILL AVAILABILITY VERIFICATION:**
6
+ 1. [LOAD IF NOT ACTIVE] `.agents/skills/testing/SKILL.md`
7
+ 2. [LOAD IF NOT ACTIVE] `.agents/skills/integration-e2e-testing/SKILL.md`
8
8
 
9
9
  **LOADING PROTOCOL:**
10
- - STEP 1: CHECK if language/testing.md is active in working memory
11
- - STEP 2: If language/testing.md NOT active → Execute BLOCKING READ
12
- - STEP 3: CHECK if integration-e2e-testing.md is active in working memory
13
- - STEP 4: If integration-e2e-testing.md NOT active → Execute BLOCKING READ
14
- - STEP 5: CONFIRM all required rules active before proceeding
10
+ - STEP 1: CHECK if testing/SKILL.md is active in working memory
11
+ - STEP 2: If testing/SKILL.md NOT active → Execute BLOCKING READ
12
+ - STEP 3: CHECK if integration-e2e-testing/SKILL.md is active in working memory
13
+ - STEP 4: If integration-e2e-testing/SKILL.md NOT active → Execute BLOCKING READ
14
+ - STEP 5: CONFIRM all required skills active before proceeding
15
15
 
16
16
  ## Purpose
17
17
 
@@ -2,45 +2,45 @@
2
2
 
3
3
  ## Required Rules [MANDATORY - MUST BE ACTIVE]
4
4
 
5
- **RULE AVAILABILITY VERIFICATION:**
6
- 1. [VERIFY ACTIVE] `.agents/rules/core/metacognition.md` (loaded at session start)
7
- 2. [LOAD IF NOT ACTIVE] `.agents/rules/core/documentation-criteria.md`
5
+ **SKILL AVAILABILITY VERIFICATION:**
6
+ 1. [VERIFY ACTIVE] `.agents/skills/metacognition/SKILL.md` (loaded at session start)
7
+ 2. [LOAD IF NOT ACTIVE] `.agents/skills/documentation-criteria/SKILL.md`
8
8
 
9
9
  **LOADING PROTOCOL:**
10
- - STEP 1: VERIFY metacognition.md is active from initial session setup
11
- - STEP 2: CHECK if documentation-criteria.md is active in working memory
12
- - STEP 3: If documentation-criteria.md NOT active → Execute BLOCKING READ
13
- - STEP 4: CONFIRM all rules active before proceeding
10
+ - STEP 1: VERIFY metacognition/SKILL.md is active from initial session setup
11
+ - STEP 2: CHECK if documentation-criteria/SKILL.md is active in working memory
12
+ - STEP 3: If documentation-criteria/SKILL.md NOT active → Execute BLOCKING READ
13
+ - STEP 4: CONFIRM all skills active before proceeding
14
14
 
15
- ## Plan Injection Requirement [MANDATORY]
15
+ ## Task Tracking Requirement [MANDATORY]
16
16
 
17
- **Upon reading this file, IMMEDIATELY inject to work plan:**
17
+ **Upon reading this file, IMMEDIATELY add to your internal task management (Task List):**
18
18
  1. All BLOCKING READs identified in Loading Protocol above:
19
- - `.agents/rules/core/documentation-criteria.md` (if not active)
19
+ - `.agents/skills/documentation-criteria/SKILL.md` (if not active)
20
20
  2. Mark each with "[From prd-creation.md]" source tag
21
- 3. Show evidence of injection:
21
+ 3. Show evidence:
22
22
  ```
23
- [PLAN INJECTION FROM prd-creation.md]
24
- Injected to work plan:
25
- ✓ BLOCKING READ: documentation-criteria.md - PRD creation criteria
23
+ [TASK TRACKING FROM prd-creation.md]
24
+ Added to Task List:
25
+ ✓ BLOCKING READ: documentation-criteria/SKILL.md - PRD creation criteria
26
26
  Status: VERIFIED
27
27
  ```
28
28
 
29
- **ENFORCEMENT:** Cannot proceed without Plan Injection evidence
29
+ **ENFORCEMENT:** Cannot proceed without Task Tracking evidence
30
30
 
31
31
  **EVIDENCE REQUIRED:**
32
32
  ```
33
- Rule Status Verification:
34
- ✓ metacognition.md - ACTIVE (from session setup)
35
- ✓ documentation-criteria.md - ACTIVE (loaded/verified)
33
+ Skill Status Verification:
34
+ ✓ metacognition/SKILL.md - ACTIVE (from session setup)
35
+ ✓ documentation-criteria/SKILL.md - ACTIVE (loaded/verified)
36
36
  ```
37
37
 
38
38
  ## Phase Entry Gate [BLOCKING - SYSTEM HALT IF VIOLATED]
39
39
 
40
40
  **CHECKPOINT: System CANNOT proceed until ALL boxes checked:**
41
41
  ☐ [VERIFIED] THIS FILE (`prd-creation.md`) has been READ and is active
42
- ☐ [VERIFIED] Plan Injection completed (from prd-creation.md Plan Injection Requirement)
43
- ☐ [VERIFIED] Work plan contains ALL BLOCKING READs from this file
42
+ ☐ [VERIFIED] Task Tracking completed (from prd-creation.md Task Tracking Requirement)
43
+ ☐ [VERIFIED] Task List contains ALL BLOCKING READs from this file
44
44
  ☐ [VERIFIED] Project structure confirmed
45
45
  ☐ [VERIFIED] Existing PRDs investigation COMPLETED with evidence
46
46
  ☐ [VERIFIED] Related documentation search EXECUTED with results documented
@@ -2,56 +2,56 @@
2
2
 
3
3
  ## Required Rules [MANDATORY - MUST BE ACTIVE]
4
4
 
5
- **RULE AVAILABILITY VERIFICATION:**
6
- 1. [LOAD IF NOT ACTIVE] `.agents/rules/language/rules.md`
7
- 2. [LOAD IF NOT ACTIVE] `.agents/rules/language/testing.md`
5
+ **SKILL AVAILABILITY VERIFICATION:**
6
+ 1. [LOAD IF NOT ACTIVE] `.agents/skills/coding-rules/SKILL.md`
7
+ 2. [LOAD IF NOT ACTIVE] `.agents/skills/testing/SKILL.md`
8
8
 
9
9
  **LOADING PROTOCOL:**
10
- - STEP 1: CHECK if language/rules.md is active in working memory
11
- - STEP 2: If language/rules.md NOT active → Execute BLOCKING READ
12
- - STEP 3: CHECK if testing.md is active in working memory
13
- - STEP 4: If testing.md NOT active → Execute BLOCKING READ
14
- - STEP 5: CONFIRM all rules active before executing quality gates
10
+ - STEP 1: CHECK if coding-rules/SKILL.md is active in working memory
11
+ - STEP 2: If coding-rules/SKILL.md NOT active → Execute BLOCKING READ
12
+ - STEP 3: CHECK if testing/SKILL.md is active in working memory
13
+ - STEP 4: If testing/SKILL.md NOT active → Execute BLOCKING READ
14
+ - STEP 5: CONFIRM all skills active before executing quality gates
15
15
 
16
16
  **CRITICAL**: Cannot execute quality checks until ALL required rules confirmed active
17
17
 
18
- ## Plan Injection Requirement [MANDATORY]
18
+ ## Task Tracking Requirement [MANDATORY]
19
19
 
20
- **Upon reading this file, IMMEDIATELY inject to work plan:**
20
+ **Upon reading this file, IMMEDIATELY add to your internal task management (Task List):**
21
21
  1. All BLOCKING READs identified in Loading Protocol above:
22
- - `.agents/rules/language/rules.md` (if not active)
23
- - `.agents/rules/language/testing.md` (if not active)
22
+ - `.agents/skills/coding-rules/SKILL.md` (if not active)
23
+ - `.agents/skills/testing/SKILL.md` (if not active)
24
24
  2. Mark each with "[From quality-assurance.md]" source tag
25
- 3. Show evidence of injection:
25
+ 3. Show evidence:
26
26
  ```
27
- [PLAN INJECTION FROM quality-assurance.md]
28
- Injected to work plan:
29
- ✓ BLOCKING READ: language/rules.md - quality standards
30
- ✓ BLOCKING READ: language/testing.md - testing requirements
27
+ [TASK TRACKING FROM quality-assurance.md]
28
+ Added to Task List:
29
+ ✓ BLOCKING READ: coding-rules/SKILL.md - quality standards
30
+ ✓ BLOCKING READ: testing/SKILL.md - testing requirements
31
31
  Status: VERIFIED
32
32
  ```
33
33
 
34
- **ENFORCEMENT:** Cannot proceed without Plan Injection evidence
34
+ **ENFORCEMENT:** Cannot proceed without Task Tracking evidence
35
35
 
36
36
  **EVIDENCE REQUIRED:**
37
37
  ```
38
- Rule Status Verification:
39
- language/rules.md - ACTIVE (loaded/verified)
40
- ✓ testing.md - ACTIVE (loaded/verified)
38
+ Skill Status Verification:
39
+ coding-rules/SKILL.md - ACTIVE (loaded/verified)
40
+ ✓ testing/SKILL.md - ACTIVE (loaded/verified)
41
41
  ```
42
42
 
43
43
  ## Task Completion Gate [STRICT ENFORCEMENT - NO EXCEPTIONS]
44
44
 
45
45
  **CANNOT mark task as complete until ALL quality checks pass:**
46
- Plan Injection completed (from quality-assurance.md Plan Injection Requirement)
47
- Work plan contains ALL BLOCKING READs from this file
46
+ Task Tracking completed (from quality-assurance.md Task Tracking Requirement)
47
+ Task List contains ALL BLOCKING READs from this file
48
48
  □ Build process succeeds
49
49
  □ Tests pass (or no tests if not applicable)
50
50
  □ Linting: 0 errors
51
51
  □ Static analysis passes (if applicable)
52
52
  □ Manual testing performed (if applicable)
53
53
  □ Changes committed to git (for implementation tasks)
54
- □ Task tracking updated (work plan checkbox if using workflow)
54
+ □ Task tracking updated (Work Plan checkbox if using workflow)
55
55
 
56
56
  **If any check fails:**
57
57
  → Fix issues before proceeding
@@ -92,7 +92,7 @@ Run project build:
92
92
  - Verify output artifacts
93
93
  - Confirm dependencies resolved
94
94
 
95
- *Note: Build commands are language-specific. Check language/testing.md*
95
+ *Note: Build commands are language-specific. Check testing/SKILL.md*
96
96
 
97
97
  ### 2. Test Execution
98
98
 
@@ -190,7 +190,7 @@ Ensure:
190
190
 
191
191
  ## Tools by Language
192
192
 
193
- Reference `.agents/rules/language/testing.md` for:
193
+ Reference `.agents/skills/testing/SKILL.md` for:
194
194
  - Language-specific test commands
195
195
  - Coverage tools
196
196
  - Linting configuration