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
@@ -3,20 +3,20 @@
3
3
  ## Required Rules [MANDATORY - MUST BE ACTIVE]
4
4
 
5
5
  **RULE AVAILABILITY VERIFICATION:**
6
- 1. [VERIFY ACTIVE] `.agents/rules/core/metacognition.md` (loaded at session start)
7
- 2. [LOAD IF NOT ACTIVE] `.agents/context-maps/task-rule-matrix.yaml`
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-rule-matrix.yaml is active in working memory
12
- - STEP 3: If task-rule-matrix.yaml NOT active → Execute BLOCKING READ
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-rule-matrix.yaml - ACTIVE (loaded/verified)
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-rule-matrix.yaml` from `.agents/context-maps/`
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. [PLAN INJECTION] IMMEDIATELY inject all identified BLOCKING READs to work plan:
119
+ 6. [TASK TRACKING] IMMEDIATELY add all identified BLOCKING READs to your internal task management (Task List):
120
120
  ```
121
- [PLAN INJECTION FROM task-analysis - Rule Selection]
122
- Injected BLOCKING READs from rule selection:
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 work plan. Proceed? [Y/n]"
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 Plan Injection [BLOCKING - AUTOMATIC EXECUTION]
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. **[AUTOMATIC INJECTION]** Add ALL identified BLOCKING READs to work plan:
160
+ 2. **[ADD TO TASK LIST]** Add ALL identified BLOCKING READs to your internal task management (Task List):
161
161
  ```
162
- Plan Injection Required:
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 plan injection confirmation:
168
+ 3. **[EVIDENCE REQUIRED]** Show task tracking confirmation:
169
169
  ```
170
- [PLAN INJECTION COMPLETED]
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
- Injected to plan:
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 injected
183
- - Plan injection evidence shown above
184
- - Each BLOCKING READ as explicit task in work plan
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 plan = IMMEDIATE HALT
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
- **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`
8
- 3. [CONDITIONAL LOAD] `.agents/rules/contextual/architecture/implementation-approach.md` (if Medium scale 3+ files OR Large scale)
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 rules active before proceeding
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
- ## 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/core/documentation-criteria.md` (if not active)
23
- - `.agents/rules/contextual/architecture/implementation-approach.md` (if conditions met)
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 of injection:
25
+ 3. Show evidence:
26
26
  ```
27
- [PLAN INJECTION FROM technical-design.md]
28
- Injected to work plan:
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 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
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] Plan Injection completed (from task-analysis.md Step 8)
48
- ☐ [VERIFIED] Work plan contains "BLOCKING READ technical-design.md" item
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
- **RULE AVAILABILITY VERIFICATION:**
6
- 1. [LOAD IF NOT ACTIVE] `.agents/rules/core/documentation-criteria.md`
7
- 2. [CONDITIONAL LOAD] `.agents/rules/core/testing-strategy.md` (if reviewing Design Doc with test strategy)
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 rules active before proceeding
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/rules/core/documentation-criteria.md`
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
- **RULE AVAILABILITY VERIFICATION:**
6
- 1. [VERIFY ACTIVE] `.agents/rules/core/metacognition.md` (loaded at session start)
7
- 2. [LOAD IF NOT ACTIVE] `.agents/rules/language/rules.md`
8
- 3. [LOAD IF NOT ACTIVE] `.agents/rules/language/testing.md`
9
- 4. [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/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 language/rules.md is active in working memory
14
- - STEP 3: If language/rules.md NOT active → Execute BLOCKING READ
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 rules active before proceeding with work planning
20
-
21
- ## Plan Injection Requirement [MANDATORY]
22
-
23
- **Upon reading this file, IMMEDIATELY inject to work plan:**
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/language/rules.md` (if not active)
26
- - `.agents/rules/language/testing.md` (if not active)
27
- - `.agents/rules/core/documentation-criteria.md` (if not active)
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 of injection:
29
+ 3. Show evidence:
30
30
  ```
31
- [PLAN INJECTION FROM work-planning.md]
32
- Injected to work plan:
33
- ✓ BLOCKING READ: language/rules.md - development standards
34
- ✓ BLOCKING READ: language/testing.md - TDD process
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 Plan Injection evidence
39
+ **ENFORCEMENT:** Cannot proceed without Task Tracking evidence
40
40
 
41
41
  **EVIDENCE REQUIRED:**
42
42
  ```
43
- Rule Status Verification:
44
- ✓ metacognition.md - ACTIVE (from session setup)
45
- language/rules.md - ACTIVE (loaded/verified)
46
- language/testing.md - ACTIVE (loaded/verified)
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] Plan Injection completed (from work-planning.md Plan Injection Requirement)
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] Work plan contains ALL BLOCKING READs from this file
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 work plan, execute metacognition assessment:
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 work plans with decomposed tasks.
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 work plan with:
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 language/testing.md standards)
152
+ - [ ] Quality checks pass with 0 errors (per testing/SKILL.md standards)
153
153
  - [ ] Changes committed to git
154
- - [ ] Task checkbox marked [x] in work plan
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 PLAN INJECTION]** Confirm work plan contains ALL required BLOCKING READs for this phase
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]** Plan Injection from prd-creation.md completed
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 Plan Injection verified
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 PLAN INJECTION]** Confirm work plan contains ALL required BLOCKING READs for this phase
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 Plan Injection verification for ALL BLOCKING READs
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 plans depend on these test specifications to map implementation units to concrete verification points.
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 PLAN INJECTION]** Confirm work plan contains ALL required BLOCKING READs for this phase
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]** Plan Injection from acceptance-test-generation.md completed
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 Plan Injection verified
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 PLAN INJECTION]** Confirm work plan contains ALL required BLOCKING READs for this phase
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]** Plan Injection from work-planning.md completed
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 work plan creation until work-planning.md confirmed active and Plan Injection verified
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 plan document EXISTS at `docs/plans/YYYYMMDD-{type}-{description}.md`
223
- 2. **[VERIFY INJECTION]** Plan MUST contain ALL BLOCKING READs identified in task-analysis Step 8:
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 Plan Injection]"
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 plan: [count] items
236
- Plan Injection Status: [COMPLETE/INCOMPLETE]
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 PLAN INJECTION] Confirm work plan contains ALL required BLOCKING READs for this phase
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] Plan Injection from implementation.md completed
253
+ 5. [VERIFY] Task Tracking from implementation.md completed
254
254
  6. [CONFIRM] Entry gates in implementation.md are satisfied
255
- 7. [VERIFY] Work plan document EXISTS and has been APPROVED
256
- 8. [CONFIRM] Current task identified from work plan
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 work plan:
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 tracking
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 work plan document
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 task tracking
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 PLAN INJECTION]** Confirm work plan contains ALL required BLOCKING READs for this phase
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]** Plan Injection from quality-assurance.md completed
299
- 6. **[CONFIRM]** All implementation tasks marked complete in work plan
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 Plan Injection verified
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/rule files - no exceptions**
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/rules/core/metacognition.md` → Keep active entire session
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
- **ALWAYS start here for any user request:**
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/rules
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 Rules section in each task definition
55
+ - Follow Required Skills section in each task definition
51
56
 
52
- ### Rule Application
53
- **Apply rules based on task type from task-analysis:**
54
- - Rules are loaded progressively as needed
55
- - Each task definition specifies its required rules
56
- - Unload task-specific rules after completion
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 rules
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 rules progressively, not all at once
101
- - Unload task-specific rules after completion
102
- - Keep only frequently-used rules loaded
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 rules are loaded
110
- 3. Look for anti-patterns in ai-development-guide.md
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-rule-matrix.yaml: Task-to-rule mappings
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 rules upfront** → Load progressively based on task needs
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
- 6. **Assuming workflow is always needed** → Small tasks can use direct task definitions
148
- 7. **Premature workflow selection** → Let task-analysis determine the approach
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
- - Rules actually used vs loaded
147
+ - Skills actually used vs loaded
155
148
  - Quality checks passing rate (should be 100%)
156
149
  - Appropriate path selection (direct vs workflow)