agentic-code 0.5.1 → 0.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/.agents/context-maps/{task-rule-matrix.yaml → task-skills-matrix.yaml} +98 -110
- package/.agents/{rules/core/ai-development-guide.md → skills/ai-development-guide/SKILL.md} +9 -2
- package/.agents/{rules/language/general/rules.md → skills/coding-rules/SKILL.md} +14 -2
- package/.agents/{rules/language/typescript/rules.md → skills/coding-rules/references/typescript.md} +18 -54
- package/.agents/{rules/core/documentation-criteria.md → skills/documentation-criteria/SKILL.md} +8 -1
- package/.agents/{rules/contextual/architecture/implementation-approach.md → skills/implementation-approach/SKILL.md} +8 -1
- package/.agents/{rules/core/integration-e2e-testing.md → skills/integration-e2e-testing/SKILL.md} +7 -0
- package/.agents/{rules/core/metacognition.md → skills/metacognition/SKILL.md} +10 -3
- package/.agents/{rules/language/general/testing.md → skills/testing/SKILL.md} +17 -32
- package/.agents/skills/testing/references/typescript.md +134 -0
- package/.agents/{rules/core/testing-strategy.md → skills/testing-strategy/SKILL.md} +7 -0
- package/.agents/tasks/acceptance-test-generation.md +38 -38
- package/.agents/tasks/code-review.md +6 -6
- package/.agents/tasks/implementation.md +34 -34
- package/.agents/tasks/integration-test-review.md +8 -8
- package/.agents/tasks/prd-creation.md +20 -20
- package/.agents/tasks/quality-assurance.md +26 -26
- package/.agents/tasks/task-analysis.md +20 -20
- package/.agents/tasks/technical-design.md +26 -26
- package/.agents/tasks/technical-document-review.md +8 -8
- package/.agents/tasks/work-planning.md +39 -39
- package/.agents/workflows/agentic-coding.md +30 -30
- package/AGENTS.md +20 -32
- package/README.md +18 -16
- package/bin/cli.js +6 -17
- package/bin/install-codex-skills.js +127 -0
- package/package.json +9 -12
- package/.agents/rules/language/typescript/testing.md +0 -284
- 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
|
-
**
|
|
6
|
-
1. [LOAD IF NOT ACTIVE] `.agents/
|
|
7
|
-
2. [LOAD IF NOT ACTIVE] `.agents/
|
|
8
|
-
3. [LOAD IF NOT ACTIVE] `.agents/
|
|
9
|
-
4. [LOAD IF NOT ACTIVE] `.agents/
|
|
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
|
|
13
|
-
- STEP 2: If
|
|
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
|
|
21
|
-
|
|
22
|
-
##
|
|
23
|
-
|
|
24
|
-
**Upon reading this file, IMMEDIATELY
|
|
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/
|
|
27
|
-
- `.agents/
|
|
28
|
-
- `.agents/
|
|
29
|
-
- `.agents/
|
|
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
|
|
31
|
+
3. Show evidence:
|
|
32
32
|
```
|
|
33
|
-
[
|
|
34
|
-
|
|
35
|
-
✓ BLOCKING READ:
|
|
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
|
|
42
|
+
**ENFORCEMENT:** Cannot proceed without Task Tracking evidence
|
|
43
43
|
|
|
44
44
|
**EVIDENCE REQUIRED:**
|
|
45
45
|
```
|
|
46
|
-
|
|
47
|
-
✓
|
|
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]
|
|
57
|
-
☐ [VERIFIED]
|
|
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/
|
|
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
|
-
**
|
|
6
|
-
1. [LOAD IF NOT ACTIVE] `.agents/rules/
|
|
7
|
-
2. [LOAD IF NOT ACTIVE] `.agents/
|
|
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/
|
|
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/
|
|
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
|
|
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
|
-
**
|
|
6
|
-
1. [VERIFY ACTIVE] `.agents/
|
|
7
|
-
2. [LOAD IF NOT ACTIVE] `.agents/rules/
|
|
8
|
-
3. [LOAD IF NOT ACTIVE] `.agents/
|
|
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
|
|
13
|
-
- STEP 3: If
|
|
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
|
|
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
|
-
##
|
|
18
|
+
## Task Tracking Requirement [MANDATORY]
|
|
19
19
|
|
|
20
|
-
**Upon reading this file, IMMEDIATELY
|
|
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/
|
|
23
|
-
- `.agents/
|
|
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
|
|
25
|
+
3. Show evidence:
|
|
26
26
|
```
|
|
27
|
-
[
|
|
28
|
-
|
|
29
|
-
✓ BLOCKING READ:
|
|
30
|
-
✓ BLOCKING READ:
|
|
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
|
|
34
|
+
**ENFORCEMENT:** Cannot proceed without Task Tracking evidence
|
|
35
35
|
|
|
36
36
|
**EVIDENCE REQUIRED:**
|
|
37
37
|
```
|
|
38
|
-
|
|
39
|
-
✓ metacognition.md - ACTIVE (from session setup)
|
|
40
|
-
✓
|
|
41
|
-
✓
|
|
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]
|
|
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
|
|
51
|
-
☐ [VERIFIED]
|
|
52
|
-
☐ [VERIFIED] Current task identified from
|
|
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
|
|
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
|
|
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
|
|
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/
|
|
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
|
|
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
|
-
**
|
|
6
|
-
1. [LOAD IF NOT ACTIVE] `.agents/
|
|
7
|
-
2. [LOAD IF NOT ACTIVE] `.agents/
|
|
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
|
|
11
|
-
- STEP 2: If
|
|
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
|
|
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
|
-
**
|
|
6
|
-
1. [VERIFY ACTIVE] `.agents/
|
|
7
|
-
2. [LOAD IF NOT ACTIVE] `.agents/
|
|
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
|
|
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
|
-
##
|
|
15
|
+
## Task Tracking Requirement [MANDATORY]
|
|
16
16
|
|
|
17
|
-
**Upon reading this file, IMMEDIATELY
|
|
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/
|
|
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
|
|
21
|
+
3. Show evidence:
|
|
22
22
|
```
|
|
23
|
-
[
|
|
24
|
-
|
|
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
|
|
29
|
+
**ENFORCEMENT:** Cannot proceed without Task Tracking evidence
|
|
30
30
|
|
|
31
31
|
**EVIDENCE REQUIRED:**
|
|
32
32
|
```
|
|
33
|
-
|
|
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]
|
|
43
|
-
☐ [VERIFIED]
|
|
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
|
-
**
|
|
6
|
-
1. [LOAD IF NOT ACTIVE] `.agents/rules/
|
|
7
|
-
2. [LOAD IF NOT ACTIVE] `.agents/
|
|
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
|
|
11
|
-
- STEP 2: If
|
|
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
|
|
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
|
-
##
|
|
18
|
+
## Task Tracking Requirement [MANDATORY]
|
|
19
19
|
|
|
20
|
-
**Upon reading this file, IMMEDIATELY
|
|
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/
|
|
23
|
-
- `.agents/
|
|
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
|
|
25
|
+
3. Show evidence:
|
|
26
26
|
```
|
|
27
|
-
[
|
|
28
|
-
|
|
29
|
-
✓ BLOCKING READ:
|
|
30
|
-
✓ BLOCKING READ:
|
|
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
|
|
34
|
+
**ENFORCEMENT:** Cannot proceed without Task Tracking evidence
|
|
35
35
|
|
|
36
36
|
**EVIDENCE REQUIRED:**
|
|
37
37
|
```
|
|
38
|
-
|
|
39
|
-
✓
|
|
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
|
-
□
|
|
47
|
-
□
|
|
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 (
|
|
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
|
|
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/
|
|
193
|
+
Reference `.agents/skills/testing/SKILL.md` for:
|
|
194
194
|
- Language-specific test commands
|
|
195
195
|
- Coverage tools
|
|
196
196
|
- Linting configuration
|