@tgoodington/intuition 9.2.0 → 9.2.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/README.md +9 -9
- package/docs/project_notes/.project-memory-state.json +100 -0
- package/docs/project_notes/branches/.gitkeep +0 -0
- package/docs/project_notes/bugs.md +41 -0
- package/docs/project_notes/decisions.md +147 -0
- package/docs/project_notes/issues.md +101 -0
- package/docs/project_notes/key_facts.md +88 -0
- package/docs/project_notes/trunk/.gitkeep +0 -0
- package/docs/project_notes/trunk/.planning_research/decision_file_naming.md +15 -0
- package/docs/project_notes/trunk/.planning_research/decisions_log.md +32 -0
- package/docs/project_notes/trunk/.planning_research/orientation.md +51 -0
- package/docs/project_notes/trunk/audit/plan-rename-hitlist.md +654 -0
- package/docs/project_notes/trunk/blueprint-conflicts.md +109 -0
- package/docs/project_notes/trunk/blueprints/database-architect.md +416 -0
- package/docs/project_notes/trunk/blueprints/devops-infrastructure.md +514 -0
- package/docs/project_notes/trunk/blueprints/technical-writer.md +788 -0
- package/docs/project_notes/trunk/build_brief.md +119 -0
- package/docs/project_notes/trunk/build_report.md +250 -0
- package/docs/project_notes/trunk/detail_brief.md +94 -0
- package/docs/project_notes/trunk/plan.md +182 -0
- package/docs/project_notes/trunk/planning_brief.md +96 -0
- package/docs/project_notes/trunk/prompt_brief.md +60 -0
- package/docs/project_notes/trunk/prompt_output.json +98 -0
- package/docs/project_notes/trunk/scratch/database-architect-decisions.json +72 -0
- package/docs/project_notes/trunk/scratch/database-architect-research-plan.md +10 -0
- package/docs/project_notes/trunk/scratch/database-architect-stage1.md +226 -0
- package/docs/project_notes/trunk/scratch/devops-infrastructure-decisions.json +71 -0
- package/docs/project_notes/trunk/scratch/devops-infrastructure-research-plan.md +7 -0
- package/docs/project_notes/trunk/scratch/devops-infrastructure-stage1.md +164 -0
- package/docs/project_notes/trunk/scratch/technical-writer-decisions.json +88 -0
- package/docs/project_notes/trunk/scratch/technical-writer-research-plan.md +7 -0
- package/docs/project_notes/trunk/scratch/technical-writer-stage1.md +266 -0
- package/docs/project_notes/trunk/team_assignment.json +108 -0
- package/docs/project_notes/trunk/test_brief.md +75 -0
- package/docs/project_notes/trunk/test_report.md +26 -0
- package/docs/project_notes/trunk/verification/devops-infrastructure-verification.md +172 -0
- package/docs/v9/decision-framework-direction.md +8 -8
- package/docs/v9/decision-framework-implementation.md +8 -8
- package/docs/v9/domain-adaptive-team-architecture.md +22 -22
- package/package.json +2 -2
- package/scripts/install-skills.js +9 -2
- package/scripts/uninstall-skills.js +4 -2
- package/skills/intuition-agent-advisor/SKILL.md +327 -327
- package/skills/intuition-assemble/SKILL.md +261 -261
- package/skills/intuition-build/SKILL.md +379 -379
- package/skills/intuition-debugger/SKILL.md +390 -390
- package/skills/intuition-design/SKILL.md +385 -385
- package/skills/intuition-detail/SKILL.md +377 -377
- package/skills/intuition-engineer/SKILL.md +307 -307
- package/skills/intuition-handoff/SKILL.md +51 -47
- package/skills/intuition-handoff/references/handoff_core.md +38 -38
- package/skills/intuition-initialize/SKILL.md +2 -2
- package/skills/intuition-initialize/references/agents_template.md +118 -118
- package/skills/intuition-initialize/references/claude_template.md +134 -134
- package/skills/intuition-initialize/references/intuition_readme_template.md +4 -4
- package/skills/intuition-initialize/references/state_template.json +2 -2
- package/skills/{intuition-plan → intuition-outline}/SKILL.md +561 -561
- package/skills/{intuition-plan → intuition-outline}/references/magellan_core.md +9 -9
- package/skills/{intuition-plan → intuition-outline}/references/templates/plan_template.md +1 -1
- package/skills/intuition-prompt/SKILL.md +374 -374
- package/skills/intuition-start/SKILL.md +8 -8
- package/skills/intuition-start/references/start_core.md +50 -50
- package/skills/intuition-test/SKILL.md +345 -345
- /package/skills/{intuition-plan → intuition-outline}/references/sub_agents.md +0 -0
- /package/skills/{intuition-plan → intuition-outline}/references/templates/confidence_scoring.md +0 -0
- /package/skills/{intuition-plan → intuition-outline}/references/templates/plan_format.md +0 -0
- /package/skills/{intuition-plan → intuition-outline}/references/templates/planning_process.md +0 -0
|
@@ -0,0 +1,514 @@
|
|
|
1
|
+
# DevOps Infrastructure Blueprint
|
|
2
|
+
|
|
3
|
+
> Specialist: devops-infrastructure
|
|
4
|
+
> Tasks: T1 (Audit), T6 (Scripts + Package Config), T8 (Verification Sweep)
|
|
5
|
+
> Decision Policy: aggressive
|
|
6
|
+
> Generated: 2026-03-04
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## 1. Task Reference
|
|
11
|
+
|
|
12
|
+
### T1: Audit all phase-name references (Light)
|
|
13
|
+
- **Acceptance Criteria**:
|
|
14
|
+
1. A complete hit list exists covering all files with phase-name "plan" references
|
|
15
|
+
2. Each hit is categorized as phase-name (rename) or generic English (keep)
|
|
16
|
+
3. Hit list is grouped by file for easy task-by-task tracking
|
|
17
|
+
- **Dependencies**: None
|
|
18
|
+
- **Scope**: All files in `skills/`, `scripts/`, `docs/`, `memory/`, `package.json`, `*.txt`, `*.md` at root
|
|
19
|
+
|
|
20
|
+
### T6: Update scripts and package config (Light)
|
|
21
|
+
- **Acceptance Criteria**:
|
|
22
|
+
1. `scripts/install-skills.js` references `intuition-outline` (not `intuition-plan`)
|
|
23
|
+
2. `scripts/uninstall-skills.js` references `intuition-outline` (not `intuition-plan`)
|
|
24
|
+
3. `package.json` contains no "plan" phase-name references
|
|
25
|
+
4. Legacy cleanup in install script handles removal of old `intuition-plan` from `~/.claude/skills/`
|
|
26
|
+
- **Dependencies**: T2 (technical-writer must complete skill content rename first)
|
|
27
|
+
|
|
28
|
+
### T8: Verification sweep (Standard)
|
|
29
|
+
- **Acceptance Criteria**:
|
|
30
|
+
1. Grep for phase-name "plan" patterns returns zero hits across the entire codebase
|
|
31
|
+
2. `skills/intuition-outline/SKILL.md` exists with correct frontmatter
|
|
32
|
+
3. Install script skill list includes `intuition-outline` and not `intuition-plan`
|
|
33
|
+
4. v7->v8 migration handler correctly renames `planning` -> `outline` in a sample state object
|
|
34
|
+
5. Verification report documents all checks performed and results
|
|
35
|
+
- **Dependencies**: T2, T3, T4, T5, T6, T7 (all prior tasks must be complete)
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 2. Research Findings
|
|
40
|
+
|
|
41
|
+
### Script Architecture (confirmed via file reads)
|
|
42
|
+
|
|
43
|
+
**`scripts/install-skills.js`** (216 lines):
|
|
44
|
+
- **Skill list array**: Lines 44-60. `'intuition-plan'` at line 48.
|
|
45
|
+
- **Legacy cleanup block**: Lines 98-110. Two existing entries:
|
|
46
|
+
- `intuition-discovery` (removed in v6.0) at lines 98-103
|
|
47
|
+
- `intuition-execute` (removed in v8.0) at lines 105-110
|
|
48
|
+
- Pattern: `const oldXxxDest = path.join(claudeSkillsDir, 'skill-name'); if (fs.existsSync(oldXxxDest)) { fs.rmSync(oldXxxDest, { recursive: true, force: true }); log(...); }`
|
|
49
|
+
- **Help text**: Line 188: `/intuition-plan` with description "Strategic planning (ARCH protocol + design flagging)"
|
|
50
|
+
|
|
51
|
+
**`scripts/uninstall-skills.js`** (99 lines):
|
|
52
|
+
- **Active skill list**: Lines 44-59. `'intuition-plan'` at line 48.
|
|
53
|
+
- **Legacy entries**: Lines 60-63. Two existing entries:
|
|
54
|
+
- `intuition-execute` (v8.0) at line 61
|
|
55
|
+
- `intuition-discovery` (v6.0) at line 63
|
|
56
|
+
- **Structure**: Single flat array containing both active and legacy skills, separated by comments.
|
|
57
|
+
|
|
58
|
+
**`package.json`** (39 lines):
|
|
59
|
+
- **Description** (line 4): Contains "prompt, plan, assemble specialist teams" -- the word "plan" here is a phase-name reference in the workflow enumeration.
|
|
60
|
+
- **Keywords** (line 8): Contains "planning" -- this is generic English describing the package's purpose (the tool helps users do planning activities). NOT a phase-name reference.
|
|
61
|
+
|
|
62
|
+
### CI/CD and Deployment Infrastructure
|
|
63
|
+
- **Platform**: npm (postinstall/preuninstall hooks)
|
|
64
|
+
- **Deployment mechanism**: `npm install -g` triggers `scripts/install-skills.js` via postinstall hook
|
|
65
|
+
- **Removal mechanism**: `npm uninstall -g` triggers `scripts/uninstall-skills.js` via preuninstall hook
|
|
66
|
+
- **No Docker, Kubernetes, Terraform, or cloud provider configs** -- this is a local CLI tool deployed via npm
|
|
67
|
+
|
|
68
|
+
### Codebase Blast Radius Summary
|
|
69
|
+
- ~177 lines across ~39 files contain "plan" references
|
|
70
|
+
- ~165 instances are phase-name references requiring rename
|
|
71
|
+
- ~12 instances are generic English that must be preserved
|
|
72
|
+
- Specialists and producers: zero phase-name references (confirmed clean)
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## 3. Approach
|
|
77
|
+
|
|
78
|
+
### Strategy
|
|
79
|
+
This is a pure rename refactor with zero behavioral changes. The devops-infrastructure scope covers three concerns:
|
|
80
|
+
|
|
81
|
+
1. **T1 -- Audit**: Produce a comprehensive, categorized hit list of all "plan" references across the codebase using a defined set of grep patterns and disambiguation rules. This hit list serves as the authoritative work manifest for all other tasks.
|
|
82
|
+
|
|
83
|
+
2. **T6 -- Script and config updates**: Apply precise, line-level edits to `install-skills.js`, `uninstall-skills.js`, and `package.json` to rename the active skill entry and add legacy cleanup/removal entries.
|
|
84
|
+
|
|
85
|
+
3. **T8 -- Verification**: Execute a multi-phase verification protocol that confirms zero stale references remain, structural integrity is maintained, and migration handlers function correctly.
|
|
86
|
+
|
|
87
|
+
### Infrastructure Philosophy
|
|
88
|
+
- **Legacy cleanup is mandatory**: Users upgrading via `npm update` must have stale `intuition-plan` folders removed automatically. The existing pattern (fs.existsSync + fs.rmSync) is proven and must be followed exactly.
|
|
89
|
+
- **Uninstall must be comprehensive**: The uninstall script must remove both the new name (active users) and the old name (partially-migrated users).
|
|
90
|
+
- **Package metadata accuracy**: npm registry-facing description must reflect current phase naming. Keywords remain unchanged (generic English).
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## 4. Decisions Made
|
|
95
|
+
|
|
96
|
+
### A1: Legacy cleanup ordering is correct
|
|
97
|
+
- **Status**: Accepted (assumption confirmed)
|
|
98
|
+
- **Basis**: Stage 1 research confirmed legacy cleanup runs at lines 98-110, before skill deployment at lines 127-138. This means old `intuition-plan` will be removed before new `intuition-outline` is deployed. No ordering change needed.
|
|
99
|
+
|
|
100
|
+
### A2: Package.json keywords "planning" is generic English
|
|
101
|
+
- **Status**: Accepted (assumption confirmed)
|
|
102
|
+
- **Basis**: The keyword "planning" at line 8 describes the package's functional purpose (it helps users plan projects). It is not a reference to the internal phase name. Compare with the description at line 4 where "plan" appears in a workflow enumeration ("prompt, plan, assemble") -- that IS a phase-name reference.
|
|
103
|
+
- **Action**: Keywords array left unchanged; description updated.
|
|
104
|
+
|
|
105
|
+
### A3: Debugger "plan diverged from intent" is a phase-name reference
|
|
106
|
+
- **Status**: Accepted (assumption confirmed)
|
|
107
|
+
- **Basis**: The debugger phrase refers to the `plan.md` output artifact diverging from user intent. Since `plan.md` is being renamed to `outline.md`, this reference must update to "outline diverged from intent."
|
|
108
|
+
- **Scope note**: This change falls under T3 (technical-writer), not T6 (devops-infrastructure). Documented here for cross-task awareness.
|
|
109
|
+
|
|
110
|
+
### D1: Version annotation for legacy cleanup comment
|
|
111
|
+
- **Tier**: SILENT
|
|
112
|
+
- **Chosen**: v9.1 annotation
|
|
113
|
+
- **Alternatives considered**: (a) No version annotation, (b) v9.2 annotation matching current package.json version
|
|
114
|
+
- **Rationale**: The rename refactor was designed as part of v9.1. Using v9.1 is consistent with the design decision epoch, not the release version. This matches the existing pattern where v6.0 and v8.0 annotations in the legacy cleanup block refer to the version that introduced the change.
|
|
115
|
+
|
|
116
|
+
### D2: Uninstall script legacy entry placement
|
|
117
|
+
- **Tier**: SILENT
|
|
118
|
+
- **Chosen**: Add `'intuition-plan'` to existing legacy section in the `skillsToRemove` array
|
|
119
|
+
- **Alternatives considered**: (a) Separate legacy cleanup block with conditional logic (like install script), (b) Comment-separated section
|
|
120
|
+
- **Rationale**: The uninstall script uses a flat array pattern where legacy entries are appended with version comments. Adding to this existing pattern is consistent and minimal. The uninstall script does not need conditional logic because `removeDir` already handles non-existent directories gracefully (returns false).
|
|
121
|
+
|
|
122
|
+
### D3: Package.json description wording
|
|
123
|
+
- **Tier**: SILENT
|
|
124
|
+
- **Chosen**: Replace "plan" with "outline" in the phase enumeration
|
|
125
|
+
- **Alternatives considered**: (a) Rewrite entire description, (b) Remove phase enumeration entirely
|
|
126
|
+
- **Rationale**: Minimal change. The description's structure "prompt, plan, assemble..." is a clear phase enumeration. Changing only the phase name to "outline" preserves the description's structure and meaning.
|
|
127
|
+
|
|
128
|
+
### D4: Help text update in install script
|
|
129
|
+
- **Tier**: SILENT
|
|
130
|
+
- **Chosen**: Update both the skill name and the description text
|
|
131
|
+
- **Alternatives considered**: (a) Update name only, keep old description, (b) Remove description entirely
|
|
132
|
+
- **Rationale**: The help text at line 188 has two components: the slash command name (`/intuition-plan`) and the description ("Strategic planning (ARCH protocol + design flagging)"). The name must change to `/intuition-outline`. The description should change from "Strategic planning" to "Strategic outline" to match the rename. The parenthetical "(ARCH protocol + design flagging)" remains accurate regardless of naming.
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## 5. Deliverable Specification
|
|
137
|
+
|
|
138
|
+
### T1: Audit Hit List
|
|
139
|
+
|
|
140
|
+
The producer must generate a markdown document containing the complete categorized hit list.
|
|
141
|
+
|
|
142
|
+
#### Grep Pattern Set
|
|
143
|
+
|
|
144
|
+
Run each pattern across the full codebase, excluding `node_modules/`, `.git/`, `specialists/`, `producers/`:
|
|
145
|
+
|
|
146
|
+
| # | Pattern | Target |
|
|
147
|
+
|---|---------|--------|
|
|
148
|
+
| 1 | `intuition-plan` | Skill name references (folders, routing, slash commands) |
|
|
149
|
+
| 2 | `planning_brief` | Output file name references |
|
|
150
|
+
| 3 | `plan\.md` | Output artifact file references (escaped dot) |
|
|
151
|
+
| 4 | `\.planning_research` | Research directory references |
|
|
152
|
+
| 5 | `"planning"` | JSON key/status value references |
|
|
153
|
+
| 6 | `planning phase` | Prose phase-name references (case-insensitive) |
|
|
154
|
+
| 7 | `planning →\|→ planning\|→planning\|planning→` | Workflow diagram references |
|
|
155
|
+
|
|
156
|
+
#### Disambiguation Rules
|
|
157
|
+
|
|
158
|
+
Each hit is categorized using these rules:
|
|
159
|
+
|
|
160
|
+
**RENAME** (phase-name reference) if the hit matches ANY of:
|
|
161
|
+
- `/intuition-plan` (skill folder, slash command, routing target)
|
|
162
|
+
- `planning_brief.md` (output artifact filename)
|
|
163
|
+
- `plan.md` when referring to the plan skill's output artifact
|
|
164
|
+
- `.planning_research/` (research directory)
|
|
165
|
+
- `"planning"` as a JSON key or status value in state management
|
|
166
|
+
- `planning phase` when referring to the workflow phase by name
|
|
167
|
+
- `planning →` or `→ planning` in workflow transition diagrams
|
|
168
|
+
- `status == "planning"` or equivalent status checks
|
|
169
|
+
|
|
170
|
+
**KEEP** (generic English) if the hit matches ANY of:
|
|
171
|
+
- "research plan" (a plan for conducting research, not the phase)
|
|
172
|
+
- "ARCH planning" (ARCH is a framework name, "planning" is the activity)
|
|
173
|
+
- "planning context" (when meaning research context, not the phase)
|
|
174
|
+
- "action plan" (generic English phrase)
|
|
175
|
+
- "continue planning" (activity verb, not phase name)
|
|
176
|
+
- "planning" in `package.json` keywords array (generic functional descriptor)
|
|
177
|
+
|
|
178
|
+
**BORDERLINE** handling:
|
|
179
|
+
- `package.json` keywords "planning" -> KEEP (rationale: per A2, generic English)
|
|
180
|
+
- `intuition-debugger/SKILL.md` "plan diverged from intent" -> RENAME (rationale: per A3, refers to `plan.md` artifact)
|
|
181
|
+
|
|
182
|
+
#### Output Format
|
|
183
|
+
|
|
184
|
+
Markdown table grouped by file:
|
|
185
|
+
|
|
186
|
+
```markdown
|
|
187
|
+
### `path/to/file.ext`
|
|
188
|
+
|
|
189
|
+
| Line | Content (truncated) | Category | Notes |
|
|
190
|
+
|------|---------------------|----------|-------|
|
|
191
|
+
| 48 | `'intuition-plan',` | RENAME | Skill list array entry |
|
|
192
|
+
| ... | ... | ... | ... |
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
Write to: `docs/project_notes/trunk/audit/plan-rename-hitlist.md`
|
|
196
|
+
|
|
197
|
+
### T6: Script and Package Config Updates
|
|
198
|
+
|
|
199
|
+
#### File 1: `scripts/install-skills.js`
|
|
200
|
+
|
|
201
|
+
**Change 1 -- Skill list array (line 48)**:
|
|
202
|
+
- Old: ` 'intuition-plan',`
|
|
203
|
+
- New: ` 'intuition-outline',`
|
|
204
|
+
|
|
205
|
+
**Change 2 -- Legacy cleanup block (insert after line 110, before line 112)**:
|
|
206
|
+
|
|
207
|
+
Insert the following block between the existing `intuition-execute` cleanup (ending line 110) and the specialist/producer directory setup comment (line 112):
|
|
208
|
+
|
|
209
|
+
```javascript
|
|
210
|
+
|
|
211
|
+
// Remove old plan skill if it exists (renamed to outline in v9.1)
|
|
212
|
+
const oldPlanDest = path.join(claudeSkillsDir, 'intuition-plan');
|
|
213
|
+
if (fs.existsSync(oldPlanDest)) {
|
|
214
|
+
fs.rmSync(oldPlanDest, { recursive: true, force: true });
|
|
215
|
+
log(`Removed old /intuition-plan skill (renamed to /intuition-outline in v9.1)`);
|
|
216
|
+
}
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
This follows the exact pattern established by `intuition-discovery` (lines 98-103) and `intuition-execute` (lines 105-110):
|
|
220
|
+
1. Comment with version annotation (per D1: v9.1)
|
|
221
|
+
2. `const` declaration with `path.join(claudeSkillsDir, 'old-name')`
|
|
222
|
+
3. `if (fs.existsSync(...))` guard
|
|
223
|
+
4. `fs.rmSync(...)` with `{ recursive: true, force: true }`
|
|
224
|
+
5. `log(...)` with explanation including old and new names
|
|
225
|
+
|
|
226
|
+
**Change 3 -- Help text (line 188)**:
|
|
227
|
+
- Old: `` log(` /intuition-plan - Strategic planning (ARCH protocol + design flagging)`);``
|
|
228
|
+
- New: `` log(` /intuition-outline - Strategic outline (ARCH protocol + design flagging)`);``
|
|
229
|
+
|
|
230
|
+
Note: The alignment spacing changes from 11 spaces (after "plan") to 8 spaces (after "outline") to maintain column alignment with other help text entries. The dash column is at position 30 in all help text lines.
|
|
231
|
+
|
|
232
|
+
#### File 2: `scripts/uninstall-skills.js`
|
|
233
|
+
|
|
234
|
+
**Change 1 -- Active skill list (line 48)**:
|
|
235
|
+
- Old: ` 'intuition-plan',`
|
|
236
|
+
- New: ` 'intuition-outline',`
|
|
237
|
+
|
|
238
|
+
**Change 2 -- Legacy entries (insert after line 63, before the closing `];` at line 64)**:
|
|
239
|
+
|
|
240
|
+
Add `'intuition-plan'` to the legacy section. The resulting legacy section should read:
|
|
241
|
+
|
|
242
|
+
```javascript
|
|
243
|
+
// Legacy skills (removed in v8.0)
|
|
244
|
+
'intuition-execute',
|
|
245
|
+
// Legacy skills (removed in v6.0)
|
|
246
|
+
'intuition-discovery',
|
|
247
|
+
// Legacy skills (renamed in v9.1)
|
|
248
|
+
'intuition-plan'
|
|
249
|
+
];
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
Per D2: follows the existing flat-array pattern with version-annotated comments.
|
|
253
|
+
|
|
254
|
+
#### File 3: `package.json`
|
|
255
|
+
|
|
256
|
+
**Change 1 -- Description (line 4)**:
|
|
257
|
+
- Old: `"description": "Domain-adaptive workflow system for Claude Code: prompt, plan, assemble specialist teams, detail with domain experts, build with format producers, test code output. Supports v8 compat (design, engineer, build) and v9 specialist workflows with 14 domain specialists and 6 format producers.",`
|
|
258
|
+
- New: `"description": "Domain-adaptive workflow system for Claude Code: prompt, outline, assemble specialist teams, detail with domain experts, build with format producers, test code output. Supports v8 compat (design, engineer, build) and v9 specialist workflows with 14 domain specialists and 6 format producers.",`
|
|
259
|
+
|
|
260
|
+
Single word change: "plan" -> "outline" in the phase enumeration (per D3).
|
|
261
|
+
|
|
262
|
+
**No change to keywords**: "planning" at line 8 is generic English (per A2, D3).
|
|
263
|
+
|
|
264
|
+
### T8: Verification Protocol
|
|
265
|
+
|
|
266
|
+
#### Phase 1 -- Zero Stale References
|
|
267
|
+
|
|
268
|
+
Re-run the exact grep pattern set from T1 across the full codebase (excluding `node_modules/`, `.git/`, `specialists/`, `producers/`):
|
|
269
|
+
|
|
270
|
+
| # | Pattern | Expected Result |
|
|
271
|
+
|---|---------|-----------------|
|
|
272
|
+
| 1 | `intuition-plan` | Zero hits (all renamed to `intuition-outline`) |
|
|
273
|
+
| 2 | `planning_brief` | Zero hits (all renamed to `outline_brief`) |
|
|
274
|
+
| 3 | `plan\.md` (as output artifact) | Zero hits after filtering generic English (all renamed to `outline.md`) |
|
|
275
|
+
| 4 | `\.planning_research` | Zero hits (all renamed to `.outline_research`) |
|
|
276
|
+
| 5 | `"planning"` (as JSON key/status) | Zero hits after filtering generic English |
|
|
277
|
+
| 6 | `planning phase` (as workflow phase name) | Zero hits after filtering generic English |
|
|
278
|
+
| 7 | Workflow diagram arrows with `planning` | Zero hits |
|
|
279
|
+
|
|
280
|
+
For each hit found: cross-reference against the T1 hit list. If the hit was categorized as KEEP, it is expected and passes. If it was categorized as RENAME, it indicates incomplete work -- FAIL.
|
|
281
|
+
|
|
282
|
+
#### Phase 2 -- Structural Verification
|
|
283
|
+
|
|
284
|
+
| Check | Command/Method | Expected |
|
|
285
|
+
|-------|---------------|----------|
|
|
286
|
+
| S1 | `ls skills/intuition-outline/SKILL.md` | File exists |
|
|
287
|
+
| S2 | Read frontmatter of `skills/intuition-outline/SKILL.md` | Contains correct skill name |
|
|
288
|
+
| S3 | `ls skills/intuition-plan/` | Directory does NOT exist |
|
|
289
|
+
| S4 | Read `scripts/install-skills.js` skill list | Contains `'intuition-outline'`, does NOT contain `'intuition-plan'` |
|
|
290
|
+
| S5 | Read `scripts/uninstall-skills.js` active list | Contains `'intuition-outline'`, does NOT contain active `'intuition-plan'` |
|
|
291
|
+
| S6 | Read `scripts/install-skills.js` legacy block | Contains `intuition-plan` removal block |
|
|
292
|
+
| S7 | Read `scripts/uninstall-skills.js` legacy section | Contains `'intuition-plan'` in legacy entries |
|
|
293
|
+
|
|
294
|
+
#### Phase 3 -- Migration Handler Validation
|
|
295
|
+
|
|
296
|
+
Create a minimal test JSON fixture representing a v7 state object with `"planning"` as a status value and as a pipeline key. Run the v7->v8 migration handler against it. Verify:
|
|
297
|
+
- Status value `"planning"` is transformed to `"outline"`
|
|
298
|
+
- Pipeline key `"planning"` is transformed to `"outline"`
|
|
299
|
+
- All other fields are unchanged
|
|
300
|
+
|
|
301
|
+
Test fixture:
|
|
302
|
+
```json
|
|
303
|
+
{
|
|
304
|
+
"schema_version": "7.0",
|
|
305
|
+
"active_context": {
|
|
306
|
+
"status": "planning",
|
|
307
|
+
"workflow_pipeline": {
|
|
308
|
+
"planning": { "status": "in_progress" }
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
Expected output after migration:
|
|
315
|
+
```json
|
|
316
|
+
{
|
|
317
|
+
"schema_version": "8.0",
|
|
318
|
+
"active_context": {
|
|
319
|
+
"status": "outline",
|
|
320
|
+
"workflow_pipeline": {
|
|
321
|
+
"outline": { "status": "in_progress" }
|
|
322
|
+
}
|
|
323
|
+
}
|
|
324
|
+
}
|
|
325
|
+
```
|
|
326
|
+
|
|
327
|
+
#### Phase 4 -- Cross-Reference Integrity
|
|
328
|
+
|
|
329
|
+
For each skill that produces or consumes outline artifacts, verify filename consistency:
|
|
330
|
+
|
|
331
|
+
| Artifact | Producer Skill | Consumer Skills | Expected Name |
|
|
332
|
+
|----------|---------------|-----------------|---------------|
|
|
333
|
+
| Outline document | intuition-outline | intuition-handoff, intuition-detail, intuition-build, intuition-start | `outline.md` |
|
|
334
|
+
| Outline brief | intuition-handoff | intuition-outline | `outline_brief.md` |
|
|
335
|
+
| Research directory | intuition-outline | (internal only) | `.outline_research/` |
|
|
336
|
+
|
|
337
|
+
For each row: grep the producer skill for the artifact name, grep each consumer skill for the same name. All must match exactly.
|
|
338
|
+
|
|
339
|
+
#### Output Format
|
|
340
|
+
|
|
341
|
+
Write verification report to: `docs/project_notes/trunk/verification/devops-infrastructure-verification.md`
|
|
342
|
+
|
|
343
|
+
Format:
|
|
344
|
+
```markdown
|
|
345
|
+
# DevOps Infrastructure Verification Report
|
|
346
|
+
|
|
347
|
+
## Phase 1: Zero Stale References
|
|
348
|
+
| Pattern | Hits Found | Expected Hits | Status |
|
|
349
|
+
|---------|-----------|---------------|--------|
|
|
350
|
+
| ... | ... | ... | PASS/FAIL |
|
|
351
|
+
|
|
352
|
+
## Phase 2: Structural Verification
|
|
353
|
+
| Check | Result | Status |
|
|
354
|
+
|-------|--------|--------|
|
|
355
|
+
| S1 | ... | PASS/FAIL |
|
|
356
|
+
|
|
357
|
+
## Phase 3: Migration Handler
|
|
358
|
+
| Test | Input | Expected | Actual | Status |
|
|
359
|
+
|------|-------|----------|--------|--------|
|
|
360
|
+
| ... | ... | ... | ... | PASS/FAIL |
|
|
361
|
+
|
|
362
|
+
## Phase 4: Cross-Reference Integrity
|
|
363
|
+
| Artifact | Producer Match | Consumer Matches | Status |
|
|
364
|
+
|----------|---------------|-----------------|--------|
|
|
365
|
+
| ... | ... | ... | PASS/FAIL |
|
|
366
|
+
|
|
367
|
+
## Summary
|
|
368
|
+
- Total checks: N
|
|
369
|
+
- Passed: N
|
|
370
|
+
- Failed: N
|
|
371
|
+
- Overall: PASS/FAIL
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
---
|
|
375
|
+
|
|
376
|
+
## 6. Acceptance Mapping
|
|
377
|
+
|
|
378
|
+
### T1 Acceptance Criteria
|
|
379
|
+
|
|
380
|
+
| Criterion | Satisfied By |
|
|
381
|
+
|-----------|-------------|
|
|
382
|
+
| AC1: Complete hit list covering all files | Grep pattern set (7 patterns) run across full codebase scope. Patterns derived from Stage 1 research blast radius analysis of ~177 lines across ~39 files. |
|
|
383
|
+
| AC2: Each hit categorized | Disambiguation rules (RENAME/KEEP/BORDERLINE) applied per hit with documented rationale. Rules derived from Stage 1 confirmed patterns. |
|
|
384
|
+
| AC3: Hit list grouped by file | Output format specification requires markdown tables grouped by file path. |
|
|
385
|
+
|
|
386
|
+
### T6 Acceptance Criteria
|
|
387
|
+
|
|
388
|
+
| Criterion | Satisfied By |
|
|
389
|
+
|-----------|-------------|
|
|
390
|
+
| AC1: install-skills.js references `intuition-outline` | Change 1: Line 48 `'intuition-plan'` -> `'intuition-outline'` in skill list array |
|
|
391
|
+
| AC2: uninstall-skills.js references `intuition-outline` | Change 1: Line 48 `'intuition-plan'` -> `'intuition-outline'` in active skill list |
|
|
392
|
+
| AC3: package.json no plan phase-name refs | Change 1: Description "plan" -> "outline" in phase enumeration. Keywords "planning" preserved (generic English per A2). |
|
|
393
|
+
| AC4: Legacy cleanup handles old `intuition-plan` | Change 2 in install-skills.js: New legacy cleanup block following established pattern (fs.existsSync + fs.rmSync). Change 2 in uninstall-skills.js: `'intuition-plan'` added to legacy entries. |
|
|
394
|
+
|
|
395
|
+
### T8 Acceptance Criteria
|
|
396
|
+
|
|
397
|
+
| Criterion | Satisfied By |
|
|
398
|
+
|-----------|-------------|
|
|
399
|
+
| AC1: Grep returns zero phase-name hits | Phase 1 of verification protocol: all 7 patterns re-run, cross-referenced against T1 hit list |
|
|
400
|
+
| AC2: `intuition-outline/SKILL.md` exists | Phase 2 checks S1 and S2 |
|
|
401
|
+
| AC3: Install script correct | Phase 2 checks S4 and S6 |
|
|
402
|
+
| AC4: Migration handler correct | Phase 3: test fixture run through v7->v8 migration handler |
|
|
403
|
+
| AC5: Verification report documents all | Output format specification with PASS/FAIL for every check |
|
|
404
|
+
|
|
405
|
+
---
|
|
406
|
+
|
|
407
|
+
## 7. Integration Points
|
|
408
|
+
|
|
409
|
+
### Files Modified by T6
|
|
410
|
+
|
|
411
|
+
| File | Absolute Path | Lines Affected |
|
|
412
|
+
|------|--------------|----------------|
|
|
413
|
+
| Install script | `scripts/install-skills.js` | Line 48 (skill list), Lines 111-116 (new legacy block, inserted), Line 188 (help text) |
|
|
414
|
+
| Uninstall script | `scripts/uninstall-skills.js` | Line 48 (active list), Lines 64-65 (new legacy entry, inserted) |
|
|
415
|
+
| Package manifest | `package.json` | Line 4 (description) |
|
|
416
|
+
|
|
417
|
+
### Files Produced by T1
|
|
418
|
+
|
|
419
|
+
| File | Path | Purpose |
|
|
420
|
+
|------|------|---------|
|
|
421
|
+
| Audit hit list | `docs/project_notes/trunk/audit/plan-rename-hitlist.md` | Authoritative reference for all rename tasks |
|
|
422
|
+
|
|
423
|
+
### Files Produced by T8
|
|
424
|
+
|
|
425
|
+
| File | Path | Purpose |
|
|
426
|
+
|------|------|---------|
|
|
427
|
+
| Verification report | `docs/project_notes/trunk/verification/devops-infrastructure-verification.md` | Final quality gate documentation |
|
|
428
|
+
|
|
429
|
+
### Cross-Task Dependencies
|
|
430
|
+
|
|
431
|
+
| This Task | Depends On | Artifact Consumed |
|
|
432
|
+
|-----------|-----------|-------------------|
|
|
433
|
+
| T6 | T2 (technical-writer) | Skill folder must already be renamed to `skills/intuition-outline/` before install script references it |
|
|
434
|
+
| T8 | All (T1-T7) | All rename work must be complete before verification sweep can produce meaningful results |
|
|
435
|
+
|
|
436
|
+
### State Schema Integration
|
|
437
|
+
|
|
438
|
+
The v7->v8 state migration handler in `skills/intuition-handoff/SKILL.md` (or its reference files) must transform:
|
|
439
|
+
- Status value: `"planning"` -> `"outline"`
|
|
440
|
+
- Pipeline key: `"planning"` -> `"outline"`
|
|
441
|
+
|
|
442
|
+
This migration handler is NOT written by T6 (devops-infrastructure). It is written by another task (likely T4 or T5). T8 verifies it works correctly.
|
|
443
|
+
|
|
444
|
+
---
|
|
445
|
+
|
|
446
|
+
## 8. Open Items
|
|
447
|
+
|
|
448
|
+
| ID | Type | Description |
|
|
449
|
+
|----|------|-------------|
|
|
450
|
+
| V1 | [VERIFY] | At build time for T6, confirm the exact line numbers in `install-skills.js` and `uninstall-skills.js` have not shifted due to prior task edits. Use content matching (not line numbers) for edit operations. |
|
|
451
|
+
| V2 | [VERIFY] | At build time for T8, confirm the migration handler file path. Stage 1 research indicates it is in `skills/intuition-handoff/SKILL.md` or `skills/intuition-handoff/references/handoff_core.md`. The verification protocol must locate the actual handler before testing. |
|
|
452
|
+
| V3 | [VERIFY] | At build time for T6 help text change, verify column alignment against surrounding help text lines to maintain consistent formatting. |
|
|
453
|
+
|
|
454
|
+
No unresolved design questions remain. All decisions recorded in Section 4.
|
|
455
|
+
|
|
456
|
+
---
|
|
457
|
+
|
|
458
|
+
## 9. Producer Handoff
|
|
459
|
+
|
|
460
|
+
### T1: Audit Hit List
|
|
461
|
+
|
|
462
|
+
- **Producer**: code-writer
|
|
463
|
+
- **Output format**: Markdown document
|
|
464
|
+
- **Filename**: `docs/project_notes/trunk/audit/plan-rename-hitlist.md`
|
|
465
|
+
- **Target line count**: 200-300 lines (depends on actual hit count)
|
|
466
|
+
- **Instruction tone**: Methodical, exhaustive. Run every grep pattern. Categorize every hit. Do not skip files. Do not guess categories -- apply the disambiguation rules literally.
|
|
467
|
+
|
|
468
|
+
**Content blocks in order**:
|
|
469
|
+
1. Header with generation metadata (date, patterns used, scope)
|
|
470
|
+
2. Summary counts (total hits, RENAME count, KEEP count)
|
|
471
|
+
3. Per-file tables (alphabetical by path), each with Line/Content/Category/Notes columns
|
|
472
|
+
4. Borderline cases section with explicit rationale for each
|
|
473
|
+
|
|
474
|
+
### T6: Script and Package Config Updates
|
|
475
|
+
|
|
476
|
+
- **Producer**: code-writer
|
|
477
|
+
- **Output format**: Direct file edits (JavaScript, JSON)
|
|
478
|
+
- **Filenames in edit order**:
|
|
479
|
+
1. `scripts/install-skills.js` (3 edits)
|
|
480
|
+
2. `scripts/uninstall-skills.js` (2 edits)
|
|
481
|
+
3. `package.json` (1 edit)
|
|
482
|
+
- **Target line count**: Net +6 lines in install-skills.js (legacy block insertion), +2 lines in uninstall-skills.js (legacy entry), 0 net in package.json
|
|
483
|
+
- **Instruction tone**: Precise, mechanical. Match existing code patterns exactly. Use content matching for edit anchors (not line numbers, per V1). Preserve existing indentation, spacing, and comment style.
|
|
484
|
+
|
|
485
|
+
**Content blocks per file**:
|
|
486
|
+
|
|
487
|
+
`scripts/install-skills.js`:
|
|
488
|
+
1. Edit skill list array: `'intuition-plan'` -> `'intuition-outline'`
|
|
489
|
+
2. Insert legacy cleanup block after `intuition-execute` block (match pattern of lines 105-110)
|
|
490
|
+
3. Edit help text line: update skill name and description, maintain column alignment
|
|
491
|
+
|
|
492
|
+
`scripts/uninstall-skills.js`:
|
|
493
|
+
1. Edit active skill list: `'intuition-plan'` -> `'intuition-outline'`
|
|
494
|
+
2. Insert legacy entry with version comment before closing `];`
|
|
495
|
+
|
|
496
|
+
`package.json`:
|
|
497
|
+
1. Edit description: `plan` -> `outline` in phase enumeration
|
|
498
|
+
|
|
499
|
+
### T8: Verification Sweep
|
|
500
|
+
|
|
501
|
+
- **Producer**: code-writer
|
|
502
|
+
- **Output format**: Executable verification script + markdown report
|
|
503
|
+
- **Filenames in creation order**:
|
|
504
|
+
1. Verification commands (executed inline, not a separate script file)
|
|
505
|
+
2. `docs/project_notes/trunk/verification/devops-infrastructure-verification.md` (report)
|
|
506
|
+
- **Target line count**: Report 80-120 lines
|
|
507
|
+
- **Instruction tone**: Systematic, binary. Every check produces PASS or FAIL. No subjective assessments. If a check fails, document exactly what was found and what was expected.
|
|
508
|
+
|
|
509
|
+
**Content blocks in order**:
|
|
510
|
+
1. Run Phase 1 grep patterns, record results
|
|
511
|
+
2. Run Phase 2 structural checks, record results
|
|
512
|
+
3. Run Phase 3 migration handler test (if handler file is locatable), record results
|
|
513
|
+
4. Run Phase 4 cross-reference checks, record results
|
|
514
|
+
5. Write verification report with all results in specified format
|