@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.
Files changed (67) hide show
  1. package/README.md +9 -9
  2. package/docs/project_notes/.project-memory-state.json +100 -0
  3. package/docs/project_notes/branches/.gitkeep +0 -0
  4. package/docs/project_notes/bugs.md +41 -0
  5. package/docs/project_notes/decisions.md +147 -0
  6. package/docs/project_notes/issues.md +101 -0
  7. package/docs/project_notes/key_facts.md +88 -0
  8. package/docs/project_notes/trunk/.gitkeep +0 -0
  9. package/docs/project_notes/trunk/.planning_research/decision_file_naming.md +15 -0
  10. package/docs/project_notes/trunk/.planning_research/decisions_log.md +32 -0
  11. package/docs/project_notes/trunk/.planning_research/orientation.md +51 -0
  12. package/docs/project_notes/trunk/audit/plan-rename-hitlist.md +654 -0
  13. package/docs/project_notes/trunk/blueprint-conflicts.md +109 -0
  14. package/docs/project_notes/trunk/blueprints/database-architect.md +416 -0
  15. package/docs/project_notes/trunk/blueprints/devops-infrastructure.md +514 -0
  16. package/docs/project_notes/trunk/blueprints/technical-writer.md +788 -0
  17. package/docs/project_notes/trunk/build_brief.md +119 -0
  18. package/docs/project_notes/trunk/build_report.md +250 -0
  19. package/docs/project_notes/trunk/detail_brief.md +94 -0
  20. package/docs/project_notes/trunk/plan.md +182 -0
  21. package/docs/project_notes/trunk/planning_brief.md +96 -0
  22. package/docs/project_notes/trunk/prompt_brief.md +60 -0
  23. package/docs/project_notes/trunk/prompt_output.json +98 -0
  24. package/docs/project_notes/trunk/scratch/database-architect-decisions.json +72 -0
  25. package/docs/project_notes/trunk/scratch/database-architect-research-plan.md +10 -0
  26. package/docs/project_notes/trunk/scratch/database-architect-stage1.md +226 -0
  27. package/docs/project_notes/trunk/scratch/devops-infrastructure-decisions.json +71 -0
  28. package/docs/project_notes/trunk/scratch/devops-infrastructure-research-plan.md +7 -0
  29. package/docs/project_notes/trunk/scratch/devops-infrastructure-stage1.md +164 -0
  30. package/docs/project_notes/trunk/scratch/technical-writer-decisions.json +88 -0
  31. package/docs/project_notes/trunk/scratch/technical-writer-research-plan.md +7 -0
  32. package/docs/project_notes/trunk/scratch/technical-writer-stage1.md +266 -0
  33. package/docs/project_notes/trunk/team_assignment.json +108 -0
  34. package/docs/project_notes/trunk/test_brief.md +75 -0
  35. package/docs/project_notes/trunk/test_report.md +26 -0
  36. package/docs/project_notes/trunk/verification/devops-infrastructure-verification.md +172 -0
  37. package/docs/v9/decision-framework-direction.md +8 -8
  38. package/docs/v9/decision-framework-implementation.md +8 -8
  39. package/docs/v9/domain-adaptive-team-architecture.md +22 -22
  40. package/package.json +2 -2
  41. package/scripts/install-skills.js +9 -2
  42. package/scripts/uninstall-skills.js +4 -2
  43. package/skills/intuition-agent-advisor/SKILL.md +327 -327
  44. package/skills/intuition-assemble/SKILL.md +261 -261
  45. package/skills/intuition-build/SKILL.md +379 -379
  46. package/skills/intuition-debugger/SKILL.md +390 -390
  47. package/skills/intuition-design/SKILL.md +385 -385
  48. package/skills/intuition-detail/SKILL.md +377 -377
  49. package/skills/intuition-engineer/SKILL.md +307 -307
  50. package/skills/intuition-handoff/SKILL.md +51 -47
  51. package/skills/intuition-handoff/references/handoff_core.md +38 -38
  52. package/skills/intuition-initialize/SKILL.md +2 -2
  53. package/skills/intuition-initialize/references/agents_template.md +118 -118
  54. package/skills/intuition-initialize/references/claude_template.md +134 -134
  55. package/skills/intuition-initialize/references/intuition_readme_template.md +4 -4
  56. package/skills/intuition-initialize/references/state_template.json +2 -2
  57. package/skills/{intuition-plan → intuition-outline}/SKILL.md +561 -561
  58. package/skills/{intuition-plan → intuition-outline}/references/magellan_core.md +9 -9
  59. package/skills/{intuition-plan → intuition-outline}/references/templates/plan_template.md +1 -1
  60. package/skills/intuition-prompt/SKILL.md +374 -374
  61. package/skills/intuition-start/SKILL.md +8 -8
  62. package/skills/intuition-start/references/start_core.md +50 -50
  63. package/skills/intuition-test/SKILL.md +345 -345
  64. /package/skills/{intuition-plan → intuition-outline}/references/sub_agents.md +0 -0
  65. /package/skills/{intuition-plan → intuition-outline}/references/templates/confidence_scoring.md +0 -0
  66. /package/skills/{intuition-plan → intuition-outline}/references/templates/plan_format.md +0 -0
  67. /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