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.
- 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 +26 -33
- 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
|
@@ -3,20 +3,20 @@
|
|
|
3
3
|
## Required Rules [MANDATORY - MUST BE ACTIVE]
|
|
4
4
|
|
|
5
5
|
**RULE AVAILABILITY VERIFICATION:**
|
|
6
|
-
1. [VERIFY ACTIVE] `.agents/
|
|
7
|
-
2. [LOAD IF NOT ACTIVE] `.agents/context-maps/task-
|
|
6
|
+
1. [VERIFY ACTIVE] `.agents/skills/metacognition/SKILL.md` (loaded at session start)
|
|
7
|
+
2. [LOAD IF NOT ACTIVE] `.agents/context-maps/task-skills-matrix.yaml`
|
|
8
8
|
|
|
9
9
|
**LOADING PROTOCOL:**
|
|
10
10
|
- STEP 1: VERIFY metacognition.md is active from initial session setup
|
|
11
|
-
- STEP 2: CHECK if task-
|
|
12
|
-
- STEP 3: If task-
|
|
11
|
+
- STEP 2: CHECK if task-skills-matrix.yaml is active in working memory
|
|
12
|
+
- STEP 3: If task-skills-matrix.yaml NOT active → Execute BLOCKING READ
|
|
13
13
|
- STEP 4: CONFIRM all rules active before proceeding with task analysis
|
|
14
14
|
|
|
15
15
|
**EVIDENCE REQUIRED:**
|
|
16
16
|
```
|
|
17
17
|
Rule Status Verification:
|
|
18
18
|
✓ metacognition.md - ACTIVE (from session setup)
|
|
19
|
-
✓ task-
|
|
19
|
+
✓ task-skills-matrix.yaml - ACTIVE (loaded/verified)
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
## Purpose
|
|
@@ -103,7 +103,7 @@ Count affected components:
|
|
|
103
103
|
### Step 4: Execute Rule Selection [BLOCKING CHECKPOINT]
|
|
104
104
|
|
|
105
105
|
**EXECUTION GATES - System HALTS if any step skipped:**
|
|
106
|
-
1. [BLOCKING READ] `task-
|
|
106
|
+
1. [BLOCKING READ] `task-skills-matrix.yaml` from `.agents/context-maps/`
|
|
107
107
|
2. [MANDATORY MATCHING] Task type + scale against matrix
|
|
108
108
|
3. [CLASSIFICATION OUTPUT]:
|
|
109
109
|
- Required rules: IMMEDIATE BLOCKING READ
|
|
@@ -116,10 +116,10 @@ Count affected components:
|
|
|
116
116
|
✓ [filepath] - [reason for loading]
|
|
117
117
|
✓ [filepath] - [applied to which aspect]
|
|
118
118
|
```
|
|
119
|
-
6. [
|
|
119
|
+
6. [TASK TRACKING] IMMEDIATELY add all identified BLOCKING READs to your internal task management (Task List):
|
|
120
120
|
```
|
|
121
|
-
[
|
|
122
|
-
|
|
121
|
+
[BLOCKING READs FROM task-analysis - Rule Selection]
|
|
122
|
+
Added to Task List:
|
|
123
123
|
✓ [filepath] - required rule
|
|
124
124
|
✓ [filepath] - conditional rule (condition met)
|
|
125
125
|
```
|
|
@@ -144,11 +144,11 @@ Determine what's needed:
|
|
|
144
144
|
Based on scale and complexity:
|
|
145
145
|
- **Small Scale (1-2 files)**: Direct task execution, no workflow needed
|
|
146
146
|
- **Medium/Large Scale (3+ files)**: RECOMMEND agentic-coding.md workflow
|
|
147
|
-
- Ask: "This task would benefit from a structured workflow with design document and
|
|
147
|
+
- Ask: "This task would benefit from a structured workflow with design document and Work Plan. Proceed? [Y/n]"
|
|
148
148
|
- If YES: Load and follow agentic-coding.md
|
|
149
149
|
- If NO: Execute individual task definitions directly
|
|
150
150
|
|
|
151
|
-
### Step 8: Mandatory
|
|
151
|
+
### Step 8: Mandatory Task Tracking [BLOCKING - AUTOMATIC EXECUTION]
|
|
152
152
|
|
|
153
153
|
**FOR ALL TASKS WITH BLOCKING READ REQUIREMENTS:**
|
|
154
154
|
|
|
@@ -157,34 +157,34 @@ Based on scale and complexity:
|
|
|
157
157
|
- From task definitions to be executed
|
|
158
158
|
- From rules that will be loaded
|
|
159
159
|
|
|
160
|
-
2. **[
|
|
160
|
+
2. **[ADD TO TASK LIST]** Add ALL identified BLOCKING READs to your internal task management (Task List):
|
|
161
161
|
```
|
|
162
|
-
|
|
162
|
+
Task List - BLOCKING READs:
|
|
163
163
|
□ BLOCKING READ: [file path] - [reason/phase]
|
|
164
164
|
□ BLOCKING READ: [file path] - [reason/phase]
|
|
165
165
|
□ Rule Status Verification after each BLOCKING READ
|
|
166
166
|
```
|
|
167
167
|
|
|
168
|
-
3. **[EVIDENCE REQUIRED]** Show
|
|
168
|
+
3. **[EVIDENCE REQUIRED]** Show task tracking confirmation:
|
|
169
169
|
```
|
|
170
|
-
[
|
|
170
|
+
[TASK TRACKING COMPLETED]
|
|
171
171
|
Identified BLOCKING READs from:
|
|
172
172
|
✓ Workflow phases: [list files]
|
|
173
173
|
✓ Task definitions: [list files]
|
|
174
174
|
✓ Required rules: [list files]
|
|
175
175
|
|
|
176
|
-
|
|
176
|
+
Added to Task List:
|
|
177
177
|
✓ Total BLOCKING READs: [count]
|
|
178
178
|
✓ Verification gates: [count]
|
|
179
179
|
```
|
|
180
180
|
|
|
181
181
|
4. **[ENFORCEMENT]** CANNOT proceed without:
|
|
182
|
-
- ALL BLOCKING READs identified and
|
|
183
|
-
-
|
|
184
|
-
- Each BLOCKING READ as explicit
|
|
182
|
+
- ALL BLOCKING READs identified and added to Task List
|
|
183
|
+
- Task tracking evidence shown above
|
|
184
|
+
- Each BLOCKING READ as explicit item in Task List
|
|
185
185
|
|
|
186
186
|
**VIOLATION HANDLING:**
|
|
187
|
-
- Missing any BLOCKING READ from
|
|
187
|
+
- Missing any BLOCKING READ from Task List = IMMEDIATE HALT
|
|
188
188
|
- Skipping any BLOCKING READ during execution = CRITICAL ERROR
|
|
189
189
|
- Proceeding without verification = RETURN TO TASK ANALYSIS
|
|
190
190
|
|
|
@@ -2,50 +2,50 @@
|
|
|
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/
|
|
8
|
-
3. [CONDITIONAL LOAD] `.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
|
+
3. [CONDITIONAL LOAD] `.agents/skills/implementation-approach/SKILL.md` (if Medium scale 3+ files OR Large scale)
|
|
9
9
|
|
|
10
10
|
**LOADING PROTOCOL:**
|
|
11
|
-
- STEP 1: VERIFY metacognition.md is active from initial session setup
|
|
12
|
-
- STEP 2: CHECK if documentation-criteria.md is active in working memory
|
|
13
|
-
- STEP 3: If documentation-criteria.md NOT active → Execute BLOCKING READ
|
|
14
|
-
- STEP 4: EVALUATE conditions for implementation-approach.md (Medium/Large scale: 3+ files)
|
|
15
|
-
- STEP 5: If conditions met AND implementation-approach.md NOT active → Execute BLOCKING READ
|
|
16
|
-
- STEP 6: CONFIRM all required
|
|
11
|
+
- STEP 1: VERIFY metacognition/SKILL.md is active from initial session setup
|
|
12
|
+
- STEP 2: CHECK if documentation-criteria/SKILL.md is active in working memory
|
|
13
|
+
- STEP 3: If documentation-criteria/SKILL.md NOT active → Execute BLOCKING READ
|
|
14
|
+
- STEP 4: EVALUATE conditions for implementation-approach/SKILL.md (Medium/Large scale: 3+ files)
|
|
15
|
+
- STEP 5: If conditions met AND implementation-approach/SKILL.md NOT active → Execute BLOCKING READ
|
|
16
|
+
- STEP 6: CONFIRM all required skills active before proceeding
|
|
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/
|
|
23
|
-
- `.agents/
|
|
22
|
+
- `.agents/skills/documentation-criteria/SKILL.md` (if not active)
|
|
23
|
+
- `.agents/skills/implementation-approach/SKILL.md` (if conditions met)
|
|
24
24
|
2. Mark each with "[From technical-design.md]" source tag
|
|
25
|
-
3. Show evidence
|
|
25
|
+
3. Show evidence:
|
|
26
26
|
```
|
|
27
|
-
[
|
|
28
|
-
|
|
29
|
-
✓ BLOCKING READ: documentation-criteria.md - ADR/Design Doc criteria
|
|
30
|
-
✓ BLOCKING READ: implementation-approach.md - strategy selection (if applicable)
|
|
27
|
+
[TASK TRACKING FROM technical-design.md]
|
|
28
|
+
Added to Task List:
|
|
29
|
+
✓ BLOCKING READ: documentation-criteria/SKILL.md - ADR/Design Doc criteria
|
|
30
|
+
✓ BLOCKING READ: implementation-approach/SKILL.md - strategy selection (if applicable)
|
|
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
|
|
40
|
-
✓ documentation-criteria.md - ACTIVE
|
|
41
|
-
✓ implementation-approach.md - [ACTIVE/NOT NEEDED]
|
|
38
|
+
Skill Status Verification:
|
|
39
|
+
✓ metacognition/SKILL.md - ACTIVE
|
|
40
|
+
✓ documentation-criteria/SKILL.md - ACTIVE
|
|
41
|
+
✓ implementation-approach/SKILL.md - [ACTIVE/NOT NEEDED]
|
|
42
42
|
```
|
|
43
43
|
|
|
44
44
|
## Phase Entry Gate [BLOCKING - SYSTEM HALT IF VIOLATED]
|
|
45
45
|
|
|
46
46
|
**CHECKPOINT: System CANNOT proceed until ALL boxes checked:**
|
|
47
|
-
☐ [VERIFIED]
|
|
48
|
-
☐ [VERIFIED]
|
|
47
|
+
☐ [VERIFIED] Task Tracking completed (from task-analysis.md Step 8)
|
|
48
|
+
☐ [VERIFIED] Task List contains "BLOCKING READ technical-design.md" item
|
|
49
49
|
☐ [VERIFIED] Project structure confirmed
|
|
50
50
|
☐ [VERIFIED] PRD reviewed (if exists) with requirements understood
|
|
51
51
|
☐ [VERIFIED] Related design documents investigation COMPLETED with evidence
|
|
@@ -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. [CONDITIONAL LOAD] `.agents/
|
|
5
|
+
**SKILL AVAILABILITY VERIFICATION:**
|
|
6
|
+
1. [LOAD IF NOT ACTIVE] `.agents/skills/documentation-criteria/SKILL.md`
|
|
7
|
+
2. [CONDITIONAL LOAD] `.agents/skills/testing-strategy/SKILL.md` (if reviewing Design Doc with test strategy)
|
|
8
8
|
|
|
9
9
|
**LOADING PROTOCOL:**
|
|
10
|
-
- STEP 1: CHECK if documentation-criteria.md is active in working memory
|
|
11
|
-
- STEP 2: If documentation-criteria.md NOT active → Execute BLOCKING READ
|
|
12
|
-
- STEP 3: EVALUATE if testing-strategy.md needed (Design Doc with test strategy section)
|
|
10
|
+
- STEP 1: CHECK if documentation-criteria/SKILL.md is active in working memory
|
|
11
|
+
- STEP 2: If documentation-criteria/SKILL.md NOT active → Execute BLOCKING READ
|
|
12
|
+
- STEP 3: EVALUATE if testing-strategy/SKILL.md needed (Design Doc with test strategy section)
|
|
13
13
|
- STEP 4: If needed AND 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
|
|
|
@@ -56,7 +56,7 @@ Confirm document type and determine validation baseline:
|
|
|
56
56
|
- Default templates by type:
|
|
57
57
|
- Design Doc → `.agents/tasks/technical-design.md`
|
|
58
58
|
- ADR → ADR section in `.agents/tasks/technical-design.md`
|
|
59
|
-
- PRD → PRD section in `.agents/
|
|
59
|
+
- PRD → PRD section in `.agents/skills/documentation-criteria/SKILL.md`
|
|
60
60
|
|
|
61
61
|
### Stage 2: Structure Compliance Check
|
|
62
62
|
|
|
@@ -2,65 +2,65 @@
|
|
|
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/
|
|
9
|
-
4. [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/coding-rules/SKILL.md`
|
|
8
|
+
3. [LOAD IF NOT ACTIVE] `.agents/skills/testing/SKILL.md`
|
|
9
|
+
4. [LOAD IF NOT ACTIVE] `.agents/skills/documentation-criteria/SKILL.md`
|
|
10
10
|
|
|
11
11
|
**LOADING PROTOCOL:**
|
|
12
|
-
- STEP 1: VERIFY metacognition.md is active from initial session setup
|
|
13
|
-
- STEP 2: CHECK if
|
|
14
|
-
- STEP 3: If
|
|
15
|
-
- STEP 4: CHECK if testing.md is active in working memory
|
|
16
|
-
- STEP 5: If testing.md NOT active → Execute BLOCKING READ
|
|
17
|
-
- STEP 6: CHECK if documentation-criteria.md is active in working memory
|
|
18
|
-
- STEP 7: If documentation-criteria.md NOT active → Execute BLOCKING READ
|
|
19
|
-
- STEP 8: CONFIRM all
|
|
20
|
-
|
|
21
|
-
##
|
|
22
|
-
|
|
23
|
-
**Upon reading this file, IMMEDIATELY
|
|
12
|
+
- STEP 1: VERIFY metacognition/SKILL.md is active from initial session setup
|
|
13
|
+
- STEP 2: CHECK if coding-rules/SKILL.md is active in working memory
|
|
14
|
+
- STEP 3: If coding-rules/SKILL.md NOT active → Execute BLOCKING READ
|
|
15
|
+
- STEP 4: CHECK if testing/SKILL.md is active in working memory
|
|
16
|
+
- STEP 5: If testing/SKILL.md NOT active → Execute BLOCKING READ
|
|
17
|
+
- STEP 6: CHECK if documentation-criteria/SKILL.md is active in working memory
|
|
18
|
+
- STEP 7: If documentation-criteria/SKILL.md NOT active → Execute BLOCKING READ
|
|
19
|
+
- STEP 8: CONFIRM all skills active before proceeding with work planning
|
|
20
|
+
|
|
21
|
+
## Task Tracking Requirement [MANDATORY]
|
|
22
|
+
|
|
23
|
+
**Upon reading this file, IMMEDIATELY add to your internal task management (Task List):**
|
|
24
24
|
1. All BLOCKING READs identified in Loading Protocol above:
|
|
25
|
-
- `.agents/rules/
|
|
26
|
-
- `.agents/
|
|
27
|
-
- `.agents/
|
|
25
|
+
- `.agents/skills/coding-rules/SKILL.md` (if not active)
|
|
26
|
+
- `.agents/skills/testing/SKILL.md` (if not active)
|
|
27
|
+
- `.agents/skills/documentation-criteria/SKILL.md` (if not active)
|
|
28
28
|
2. Mark each with "[From work-planning.md]" source tag
|
|
29
|
-
3. Show evidence
|
|
29
|
+
3. Show evidence:
|
|
30
30
|
```
|
|
31
|
-
[
|
|
32
|
-
|
|
33
|
-
✓ BLOCKING READ:
|
|
34
|
-
✓ BLOCKING READ:
|
|
35
|
-
✓ BLOCKING READ: documentation-criteria.md - documentation standards
|
|
31
|
+
[TASK TRACKING FROM work-planning.md]
|
|
32
|
+
Added to Task List:
|
|
33
|
+
✓ BLOCKING READ: coding-rules/SKILL.md - development standards
|
|
34
|
+
✓ BLOCKING READ: testing/SKILL.md - TDD process
|
|
35
|
+
✓ BLOCKING READ: documentation-criteria/SKILL.md - documentation standards
|
|
36
36
|
Status: VERIFIED
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
**ENFORCEMENT:** Cannot proceed without
|
|
39
|
+
**ENFORCEMENT:** Cannot proceed without Task Tracking evidence
|
|
40
40
|
|
|
41
41
|
**EVIDENCE REQUIRED:**
|
|
42
42
|
```
|
|
43
|
-
|
|
44
|
-
✓ metacognition.md - ACTIVE (from session setup)
|
|
45
|
-
✓
|
|
46
|
-
✓
|
|
47
|
-
✓ documentation-criteria.md - ACTIVE (loaded/verified)
|
|
43
|
+
Skill Status Verification:
|
|
44
|
+
✓ metacognition/SKILL.md - ACTIVE (from session setup)
|
|
45
|
+
✓ coding-rules/SKILL.md - ACTIVE (loaded/verified)
|
|
46
|
+
✓ testing/SKILL.md - ACTIVE (loaded/verified)
|
|
47
|
+
✓ documentation-criteria/SKILL.md - ACTIVE (loaded/verified)
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
## Phase Entry Gate [BLOCKING - SYSTEM HALT IF VIOLATED]
|
|
51
51
|
|
|
52
52
|
**CHECKPOINT: System CANNOT proceed until ALL boxes checked:**
|
|
53
53
|
☐ [VERIFIED] THIS FILE (`work-planning.md`) has been READ and is active
|
|
54
|
-
☐ [VERIFIED]
|
|
54
|
+
☐ [VERIFIED] Task Tracking completed (from work-planning.md Task Tracking Requirement)
|
|
55
55
|
☐ [VERIFIED] All required rules listed above are LOADED and active
|
|
56
|
-
☐ [VERIFIED]
|
|
56
|
+
☐ [VERIFIED] Task List contains ALL BLOCKING READs from this file
|
|
57
57
|
☐ [VERIFIED] Design document EXISTS at `docs/design/[feature]-design.md`
|
|
58
58
|
☐ [VERIFIED] User has APPROVED the design
|
|
59
59
|
☐ [VERIFIED] Test skeletons exist (if applicable for test-driven approach)
|
|
60
60
|
☐ [VERIFIED] SESSION_BASELINE_DATE established and active
|
|
61
61
|
|
|
62
62
|
**METACOGNITION GATE [MANDATORY]:**
|
|
63
|
-
BEFORE creating
|
|
63
|
+
BEFORE creating Work Plan document, execute metacognition assessment:
|
|
64
64
|
- Understand the design intent and goals
|
|
65
65
|
- Verify task decomposition strategy aligns with 1-commit principle
|
|
66
66
|
- Confirm dependencies are logical and achievable
|
|
@@ -71,7 +71,7 @@ IF attempting to skip → CRITICAL ERROR
|
|
|
71
71
|
|
|
72
72
|
## Purpose
|
|
73
73
|
|
|
74
|
-
Create
|
|
74
|
+
Create Work Plan documents with decomposed tasks.
|
|
75
75
|
|
|
76
76
|
## When to Use
|
|
77
77
|
|
|
@@ -95,7 +95,7 @@ Create work plans with decomposed tasks.
|
|
|
95
95
|
|
|
96
96
|
### 1. Plan Structure
|
|
97
97
|
|
|
98
|
-
Create
|
|
98
|
+
Create Work Plan document with:
|
|
99
99
|
- **Overview**: What's being built/changed
|
|
100
100
|
- **Phases**: Logical groupings of work
|
|
101
101
|
- **Tasks**: Individual implementation units
|
|
@@ -149,9 +149,9 @@ Create work plan with:
|
|
|
149
149
|
|
|
150
150
|
### Exit Conditions
|
|
151
151
|
- [ ] Test passes
|
|
152
|
-
- [ ] Quality checks pass with 0 errors (per
|
|
152
|
+
- [ ] Quality checks pass with 0 errors (per testing/SKILL.md standards)
|
|
153
153
|
- [ ] Changes committed to git
|
|
154
|
-
- [ ] Task checkbox marked [x] in
|
|
154
|
+
- [ ] Task checkbox marked [x] in Work Plan document
|
|
155
155
|
|
|
156
156
|
### Dependencies
|
|
157
157
|
- Depends on: Task [X]
|
|
@@ -11,15 +11,15 @@ Execute phases sequentially. For Large scale (6+ files), include PRD phase.
|
|
|
11
11
|
## Phase 0: PRD Creation (Large scale only)
|
|
12
12
|
|
|
13
13
|
### Pre-Phase Gates [BLOCKING - CANNOT PROCEED WITHOUT]:
|
|
14
|
-
1. **[VERIFY
|
|
14
|
+
1. **[VERIFY TASK TRACKING]** Confirm Task List contains ALL required BLOCKING READs for this phase
|
|
15
15
|
- If missing any: HALT - Return to task-analysis.md Step 8
|
|
16
16
|
2. **[BLOCKING READ]** Execute Read on `.agents/tasks/prd-creation.md`
|
|
17
17
|
3. **[VERIFY]** prd-creation.md is ACTIVE in working memory
|
|
18
18
|
4. **[VERIFY]** All rules required by prd-creation.md are LOADED (per its Required Rules section)
|
|
19
|
-
5. **[VERIFY]**
|
|
19
|
+
5. **[VERIFY]** Task Tracking from prd-creation.md completed
|
|
20
20
|
6. **[CONFIRM]** Entry gates in prd-creation.md are satisfied
|
|
21
21
|
|
|
22
|
-
**ENFORCEMENT**: NO requirements work until prd-creation.md confirmed active and
|
|
22
|
+
**ENFORCEMENT**: NO requirements work until prd-creation.md confirmed active and Task Tracking verified
|
|
23
23
|
|
|
24
24
|
### Internal Checklist:
|
|
25
25
|
```
|
|
@@ -67,7 +67,7 @@ Execute phases sequentially. For Large scale (6+ files), include PRD phase.
|
|
|
67
67
|
## Phase 2: Technical Design
|
|
68
68
|
|
|
69
69
|
### Pre-Phase Gates [BLOCKING - CANNOT PROCEED WITHOUT]:
|
|
70
|
-
1. **[VERIFY
|
|
70
|
+
1. **[VERIFY TASK TRACKING]** Confirm Task List contains ALL required BLOCKING READs for this phase
|
|
71
71
|
- If missing any: HALT - Return to task-analysis.md Step 8
|
|
72
72
|
2. **[BLOCKING READ]** Execute Read on `.agents/tasks/technical-design.md`
|
|
73
73
|
3. **[VERIFY]** technical-design.md is ACTIVE in working memory
|
|
@@ -76,7 +76,7 @@ Execute phases sequentially. For Large scale (6+ files), include PRD phase.
|
|
|
76
76
|
|
|
77
77
|
**ENFORCEMENT**:
|
|
78
78
|
- NO design work until technical-design.md confirmed active
|
|
79
|
-
- NO proceeding without
|
|
79
|
+
- NO proceeding without Task Tracking verification for ALL BLOCKING READs
|
|
80
80
|
|
|
81
81
|
### Pre-Design Requirements:
|
|
82
82
|
```
|
|
@@ -126,19 +126,19 @@ Execute phases sequentially. For Large scale (6+ files), include PRD phase.
|
|
|
126
126
|
|
|
127
127
|
## Phase 3: Acceptance Test Generation
|
|
128
128
|
|
|
129
|
-
**PHASE ORDERING RATIONALE**: Test skeletons MUST be generated BEFORE work planning. Test structures define verification boundaries that determine task decomposition granularity. Work
|
|
129
|
+
**PHASE ORDERING RATIONALE**: Test skeletons MUST be generated BEFORE work planning. Test structures define verification boundaries that determine task decomposition granularity. Work Plan documents depend on these test specifications to map implementation units to concrete verification points.
|
|
130
130
|
|
|
131
131
|
### Pre-Phase Gates [BLOCKING - CANNOT PROCEED WITHOUT]:
|
|
132
|
-
1. **[VERIFY
|
|
132
|
+
1. **[VERIFY TASK TRACKING]** Confirm Task List contains ALL required BLOCKING READs for this phase
|
|
133
133
|
- If missing any: HALT - Return to task-analysis.md Step 8
|
|
134
134
|
2. **[BLOCKING READ]** Execute Read on `.agents/tasks/acceptance-test-generation.md`
|
|
135
135
|
3. **[VERIFY]** acceptance-test-generation.md is ACTIVE in working memory
|
|
136
136
|
4. **[VERIFY]** All rules required by acceptance-test-generation.md are LOADED (per its Required Rules section)
|
|
137
|
-
5. **[VERIFY]**
|
|
137
|
+
5. **[VERIFY]** Task Tracking from acceptance-test-generation.md completed
|
|
138
138
|
6. **[CONFIRM]** Entry gates in acceptance-test-generation.md are satisfied
|
|
139
139
|
7. **[VERIFY]** Design document EXISTS and contains Acceptance Criteria section
|
|
140
140
|
|
|
141
|
-
**ENFORCEMENT**: NO test generation until acceptance-test-generation.md confirmed active and
|
|
141
|
+
**ENFORCEMENT**: NO test generation until acceptance-test-generation.md confirmed active and Task Tracking verified
|
|
142
142
|
|
|
143
143
|
### Internal Checklist:
|
|
144
144
|
```
|
|
@@ -184,17 +184,17 @@ Execute phases sequentially. For Large scale (6+ files), include PRD phase.
|
|
|
184
184
|
**PHASE DEPENDENCY**: This phase REQUIRES completed test skeletons from Phase 3. Task decomposition uses test verification points as boundaries for work units. Each implementation task maps to specific test cases for validation.
|
|
185
185
|
|
|
186
186
|
### Pre-Phase Gates [BLOCKING - CANNOT PROCEED WITHOUT]:
|
|
187
|
-
1. **[VERIFY
|
|
187
|
+
1. **[VERIFY TASK TRACKING]** Confirm Task List contains ALL required BLOCKING READs for this phase
|
|
188
188
|
- If missing any: HALT - Return to task-analysis.md Step 8
|
|
189
189
|
2. **[BLOCKING READ]** Execute Read on `.agents/tasks/work-planning.md`
|
|
190
190
|
3. **[VERIFY]** work-planning.md is ACTIVE in working memory
|
|
191
191
|
4. **[VERIFY]** All rules required by work-planning.md are LOADED (per its Required Rules section)
|
|
192
|
-
5. **[VERIFY]**
|
|
192
|
+
5. **[VERIFY]** Task Tracking from work-planning.md completed
|
|
193
193
|
6. **[CONFIRM]** Entry gates in work-planning.md are satisfied
|
|
194
194
|
7. **[VERIFY]** Design document APPROVED by user
|
|
195
195
|
8. **[VERIFY]** Test skeletons from Phase 3 EXIST in test directories
|
|
196
196
|
|
|
197
|
-
**ENFORCEMENT**: NO
|
|
197
|
+
**ENFORCEMENT**: NO Work Plan document creation until work-planning.md confirmed active and Task Tracking verified
|
|
198
198
|
|
|
199
199
|
### Internal Checklist:
|
|
200
200
|
```
|
|
@@ -219,21 +219,21 @@ Execute phases sequentially. For Large scale (6+ files), include PRD phase.
|
|
|
219
219
|
|
|
220
220
|
### STOP POINT: Work Plan Approval [BLOCKING GATE]
|
|
221
221
|
**SYSTEM HALT - CANNOT WRITE CODE WITHOUT:**
|
|
222
|
-
1. Work
|
|
223
|
-
2. **[VERIFY
|
|
222
|
+
1. Work Plan document EXISTS at `docs/plans/YYYYMMDD-{type}-{description}.md`
|
|
223
|
+
2. **[VERIFY TASK LIST]** Task List MUST contain ALL BLOCKING READs identified in task-analysis Step 8:
|
|
224
224
|
- Every BLOCKING READ from workflow phases
|
|
225
225
|
- Every BLOCKING READ from task definitions
|
|
226
226
|
- Every BLOCKING READ from required rules
|
|
227
|
-
- Each marked with source: "[From
|
|
227
|
+
- Each marked with source: "[From Task Tracking]"
|
|
228
228
|
3. Each task has MEASURABLE completion criteria
|
|
229
229
|
4. User EXPLICITLY approves plan
|
|
230
230
|
|
|
231
231
|
**GATE VERIFICATION:**
|
|
232
232
|
```
|
|
233
|
-
Plan Location: docs/plans/[filename].md
|
|
233
|
+
Work Plan Location: docs/plans/[filename].md
|
|
234
234
|
Task Count: [N] tasks defined
|
|
235
|
-
BLOCKING READs in
|
|
236
|
-
|
|
235
|
+
BLOCKING READs in Task List: [count] items
|
|
236
|
+
Task Tracking Status: [COMPLETE/INCOMPLETE]
|
|
237
237
|
User Approval: [AWAITING/RECEIVED]
|
|
238
238
|
```
|
|
239
239
|
|
|
@@ -245,15 +245,15 @@ User Approval: [AWAITING/RECEIVED]
|
|
|
245
245
|
|
|
246
246
|
### Pre-Implementation Gates [BLOCKING - CANNOT START WITHOUT]:
|
|
247
247
|
```
|
|
248
|
-
1. [VERIFY
|
|
248
|
+
1. [VERIFY TASK TRACKING] Confirm Task List contains ALL required BLOCKING READs for this phase
|
|
249
249
|
- If missing any: HALT - Return to task-analysis.md Step 8
|
|
250
250
|
2. [BLOCKING READ] Execute Read on `.agents/tasks/implementation.md`
|
|
251
251
|
3. [VERIFY] implementation.md is ACTIVE in working memory
|
|
252
252
|
4. [VERIFY] All rules required by implementation.md are LOADED (per its Required Rules section)
|
|
253
|
-
5. [VERIFY]
|
|
253
|
+
5. [VERIFY] Task Tracking from implementation.md completed
|
|
254
254
|
6. [CONFIRM] Entry gates in implementation.md are satisfied
|
|
255
|
-
7. [VERIFY] Work
|
|
256
|
-
8. [CONFIRM] Current task identified from
|
|
255
|
+
7. [VERIFY] Work Plan document EXISTS and has been APPROVED
|
|
256
|
+
8. [CONFIRM] Current task identified from Work Plan document
|
|
257
257
|
```
|
|
258
258
|
|
|
259
259
|
**CRITICAL ENFORCEMENT**:
|
|
@@ -263,16 +263,16 @@ User Approval: [AWAITING/RECEIVED]
|
|
|
263
263
|
|
|
264
264
|
### Execution Pattern [ENFORCED SEQUENCE]:
|
|
265
265
|
```
|
|
266
|
-
For each task in
|
|
266
|
+
For each task in Work Plan document:
|
|
267
267
|
1. [METACOGNITION PRE] Execute "When Starting Work" checklist from metacognition protocol
|
|
268
|
-
2. [TRACKING] Mark task as in_progress in task
|
|
268
|
+
2. [TRACKING] Mark task as in_progress in your internal task management (Task List)
|
|
269
269
|
3. [IMPLEMENT] Write code following ALL loaded rules (TDD: RED-GREEN-REFACTOR)
|
|
270
270
|
4. [VERIFY] Run ALL quality check commands - MUST have 0 errors
|
|
271
271
|
5. [COMMIT] Git commit with descriptive message for this task
|
|
272
|
-
6. [UPDATE] Mark task checkbox complete [x] in
|
|
272
|
+
6. [UPDATE] Mark task checkbox complete [x] in Work Plan document
|
|
273
273
|
7. [GATE CHECK] ALL completion criteria must pass
|
|
274
274
|
8. [METACOGNITION POST] Execute "After Completion" checklist
|
|
275
|
-
9. [TRACKING] Mark task complete in
|
|
275
|
+
9. [TRACKING] Mark task complete in Task List
|
|
276
276
|
10. [CHECKPOINT] Cannot start next task until all steps complete
|
|
277
277
|
```
|
|
278
278
|
|
|
@@ -290,15 +290,15 @@ For each task in work plan:
|
|
|
290
290
|
## Phase 6: Quality Assurance
|
|
291
291
|
|
|
292
292
|
### Pre-Phase Gates [BLOCKING - CANNOT PROCEED WITHOUT]:
|
|
293
|
-
1. **[VERIFY
|
|
293
|
+
1. **[VERIFY TASK TRACKING]** Confirm Task List contains ALL required BLOCKING READs for this phase
|
|
294
294
|
- If missing any: HALT - Return to task-analysis.md Step 8
|
|
295
295
|
2. **[BLOCKING READ]** Execute Read on `.agents/tasks/quality-assurance.md`
|
|
296
296
|
3. **[VERIFY]** quality-assurance.md is ACTIVE in working memory
|
|
297
297
|
4. **[VERIFY]** All rules required by quality-assurance.md are LOADED (per its Required Rules section)
|
|
298
|
-
5. **[VERIFY]**
|
|
299
|
-
6. **[CONFIRM]** All implementation tasks marked complete in
|
|
298
|
+
5. **[VERIFY]** Task Tracking from quality-assurance.md completed
|
|
299
|
+
6. **[CONFIRM]** All implementation tasks marked complete in Work Plan document
|
|
300
300
|
|
|
301
|
-
**ENFORCEMENT**: NO quality checks until quality-assurance.md confirmed active and
|
|
301
|
+
**ENFORCEMENT**: NO quality checks until quality-assurance.md confirmed active and Task Tracking verified
|
|
302
302
|
|
|
303
303
|
### Internal Checklist:
|
|
304
304
|
```
|
package/AGENTS.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
## ABSOLUTE PRINCIPLES
|
|
4
4
|
|
|
5
|
-
1. **EXECUTE all rules and requirements in task/
|
|
5
|
+
1. **EXECUTE all rules and requirements in task/skill files - no exceptions**
|
|
6
6
|
2. **COMPLETE all entry and exit conditions for every task**
|
|
7
7
|
3. **STOP at gates - proceed only when conditions are met**
|
|
8
8
|
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
|
|
11
11
|
**Complete before any other operation:**
|
|
12
12
|
1. Execute `date` command → Store as SESSION_BASELINE_DATE
|
|
13
|
-
2. Apply `.agents/
|
|
13
|
+
2. Apply `.agents/skills/metacognition/SKILL.md` → Keep active entire session
|
|
14
14
|
3. Use SESSION_BASELINE_DATE for all date references (WebSearch, docs, etc.)
|
|
15
15
|
4. Verify project structure with `ls -la`
|
|
16
16
|
|
|
@@ -20,7 +20,12 @@
|
|
|
20
20
|
|
|
21
21
|
## Task Analysis - Required First Step
|
|
22
22
|
|
|
23
|
-
**
|
|
23
|
+
**Early Exit Check (BEFORE loading task-analysis.md):**
|
|
24
|
+
Does this task require reading code files to decide HOW to execute it?
|
|
25
|
+
- **NO** → Execute directly, skip task-analysis.md
|
|
26
|
+
- **YES** → Load and follow task-analysis.md
|
|
27
|
+
|
|
28
|
+
**If not early exit, start here for any user request:**
|
|
24
29
|
1. Apply `.agents/tasks/task-analysis.md`
|
|
25
30
|
2. Follow its output to select the appropriate path:
|
|
26
31
|
|
|
@@ -39,7 +44,7 @@
|
|
|
39
44
|
### Plan Injection [MANDATORY ENFORCEMENT]
|
|
40
45
|
**All tasks require Plan Injection for BLOCKING READs:**
|
|
41
46
|
- Task-analysis.md Step 8 scans and identifies ALL BLOCKING READ requirements
|
|
42
|
-
- Work plans MUST contain every BLOCKING READ from workflow/tasks/
|
|
47
|
+
- Work plans MUST contain every BLOCKING READ from workflow/tasks/skills
|
|
43
48
|
- Each phase verifies its BLOCKING READs are in the plan
|
|
44
49
|
- Gates verify Plan Injection evidence before proceeding
|
|
45
50
|
- Missing ANY BLOCKING READ = IMMEDIATE HALT
|
|
@@ -47,13 +52,13 @@
|
|
|
47
52
|
### Task Definition Loading
|
|
48
53
|
**Task definitions define WHAT to build - never skip them:**
|
|
49
54
|
- Verify entry gates before proceeding
|
|
50
|
-
- Follow Required
|
|
55
|
+
- Follow Required Skills section in each task definition
|
|
51
56
|
|
|
52
|
-
###
|
|
53
|
-
**Apply
|
|
54
|
-
-
|
|
55
|
-
- Each task definition specifies its required
|
|
56
|
-
- Unload task-specific
|
|
57
|
+
### Skill Application
|
|
58
|
+
**Apply skills based on task type from task-analysis:**
|
|
59
|
+
- Skills are loaded progressively as needed
|
|
60
|
+
- Each task definition specifies its required skills
|
|
61
|
+
- Unload task-specific skills after completion
|
|
57
62
|
|
|
58
63
|
### Quality Standards
|
|
59
64
|
**Before marking any task complete:**
|
|
@@ -82,7 +87,7 @@ Common approval points:
|
|
|
82
87
|
**Universal quality requirements:**
|
|
83
88
|
- Follow TDD process for all code changes
|
|
84
89
|
- All quality checks must pass with 0 errors
|
|
85
|
-
- Follow standards defined in language-specific
|
|
90
|
+
- Follow standards defined in language-specific skills
|
|
86
91
|
- Each task definition specifies its quality gates
|
|
87
92
|
|
|
88
93
|
## Metacognition Checkpoints
|
|
@@ -97,17 +102,17 @@ Perform self-assessment at these mandatory points:
|
|
|
97
102
|
## Context Management
|
|
98
103
|
|
|
99
104
|
**Guidelines**:
|
|
100
|
-
- Load
|
|
101
|
-
- Unload task-specific
|
|
102
|
-
- Keep only frequently-used
|
|
105
|
+
- Load skills progressively, not all at once
|
|
106
|
+
- Unload task-specific skills after completion
|
|
107
|
+
- Keep only frequently-used skills loaded
|
|
103
108
|
- If context feels constrained, ask user for cleanup guidance
|
|
104
109
|
|
|
105
110
|
## Error Recovery
|
|
106
111
|
|
|
107
112
|
When stuck or encountering errors:
|
|
108
113
|
1. Re-read current task definition
|
|
109
|
-
2. Check if required
|
|
110
|
-
3. Look for anti-patterns in ai-development-guide
|
|
114
|
+
2. Check if required skills are loaded
|
|
115
|
+
3. Look for anti-patterns in ai-development-guide skill
|
|
111
116
|
4. If unable to resolve, ask user for clarification
|
|
112
117
|
|
|
113
118
|
## File Organization
|
|
@@ -124,33 +129,21 @@ When stuck or encountering errors:
|
|
|
124
129
|
- agentic-coding.md: Medium/Large scale workflow
|
|
125
130
|
|
|
126
131
|
**Context Maps** (.agents/context-maps/):
|
|
127
|
-
- task-
|
|
128
|
-
|
|
129
|
-
**Core Rules** (.agents/rules/core/):
|
|
130
|
-
- metacognition.md: Self-assessment
|
|
131
|
-
- ai-development-guide.md: Anti-patterns
|
|
132
|
-
- documentation-criteria.md: Documentation criteria
|
|
133
|
-
|
|
134
|
-
**Language Rules** (.agents/rules/language/):
|
|
135
|
-
- rules.md: Development rules
|
|
136
|
-
- testing.md: Testing standards
|
|
137
|
-
|
|
138
|
-
**Contextual Rules** (.agents/rules/contextual/):
|
|
139
|
-
- architecture/: Implementation approaches
|
|
132
|
+
- task-skills-matrix.yaml: Task-to-skill mappings
|
|
140
133
|
|
|
141
134
|
## Anti-Patterns to Avoid
|
|
142
135
|
|
|
143
136
|
1. **Skipping task-analysis.md** → ALWAYS start with task analysis
|
|
144
|
-
2. **Loading all
|
|
137
|
+
2. **Loading all skills upfront** → Load progressively based on task needs
|
|
145
138
|
3. **Ignoring task entry/exit conditions** → Verify gates at each step
|
|
146
139
|
4. **Working without task definitions** → Task definitions define WHAT to build
|
|
147
|
-
|
|
148
|
-
|
|
140
|
+
5. **Assuming workflow is always needed** → Small tasks can use direct task definitions
|
|
141
|
+
6. **Premature workflow selection** → Let task-analysis determine the approach
|
|
149
142
|
|
|
150
143
|
## Success Metrics
|
|
151
144
|
|
|
152
145
|
Track internally:
|
|
153
146
|
- Task completion rate
|
|
154
|
-
-
|
|
147
|
+
- Skills actually used vs loaded
|
|
155
148
|
- Quality checks passing rate (should be 100%)
|
|
156
149
|
- Appropriate path selection (direct vs workflow)
|