@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
@@ -21,9 +21,9 @@ These are non-negotiable. Violating any of these means the protocol has failed.
21
21
  5. You MUST generate a brief for the next agent.
22
22
  6. You MUST update `.project-memory-state.json` — you are the ONLY skill that writes to this file.
23
23
  7. You MUST NOT evaluate or critique phase outputs. Process and document, never judge.
24
- 8. You MUST NOT skip the user profile merge step during prompt→planning transitions.
24
+ 8. You MUST NOT skip the user profile merge step during prompt→outline transitions.
25
25
  9. You MUST suggest the correct next skill after completing the transition.
26
- 10. You MUST NOT modify prompt_brief.md, plan.md, design_spec_*.md, code_specs.md, or other phase output files — they are read-only inputs.
26
+ 10. You MUST NOT modify prompt_brief.md, outline.md, design_spec_*.md, code_specs.md, or other phase output files — they are read-only inputs.
27
27
  11. You MUST manage the design loop: track which items are designed, route to next item or to engineer when all are done.
28
28
 
29
29
  ## CONTEXT PATH RESOLUTION
@@ -45,9 +45,9 @@ Before ANY transition, resolve the active context:
45
45
 
46
46
  After resolving context_path, determine the workflow version:
47
47
 
48
- 1. Read `{context_path}plan.md` (if it exists)
49
- 2. IF plan contains a `### 6.5 Detail Assessment` section → **v9 mode**
50
- 3. IF plan contains a `Design Recommendations` section OR no plan exists yet → **v8 mode**
48
+ 1. Read `{context_path}outline.md` (if it exists)
49
+ 2. IF outline contains a `### 6.5 Detail Assessment` section → **v9 mode**
50
+ 3. IF outline contains a `Design Recommendations` section OR no outline exists yet → **v8 mode**
51
51
  4. Store the detected mode for use in transition detection below.
52
52
 
53
53
  ## PROTOCOL: COMPLETE FLOW
@@ -59,7 +59,7 @@ Step 2: Detect transition type from context_workflow
59
59
  Step 3: Read phase output files from {context_path}
60
60
  Step 4: Extract insights and structure findings
61
61
  Step 5: Update shared memory files (key_facts.md, decisions.md, issues.md)
62
- Step 6: Merge user profile learnings (prompt→planning only)
62
+ Step 6: Merge user profile learnings (prompt→outline only)
63
63
  Step 7: Generate brief for next agent at {context_path}
64
64
  Step 8: Update .project-memory-state.json (target active context object)
65
65
  Step 9: Report what was processed and suggest next skill
@@ -71,17 +71,17 @@ After resolving context_path, context_workflow, and mode:
71
71
 
72
72
  ```
73
73
  IF context_workflow.status == "prompt" AND workflow.prompt.completed == true
74
- AND workflow.planning.started == false:
75
- → TRANSITION: Prompt → Planning (Transition 1)
74
+ AND workflow.outline.started == false:
75
+ → TRANSITION: Prompt → Outline (Transition 1)
76
76
 
77
- IF context_workflow.status == "planning" AND workflow.planning.completed == true:
77
+ IF context_workflow.status == "outline" AND workflow.outline.completed == true:
78
78
  IF v9 mode AND NOT (workflow.detail exists AND workflow.detail.started == true):
79
79
  IF {context_path}team_assignment.json exists:
80
80
  → TRANSITION: Assemble → Detail (Transition 2.5v9)
81
81
  ELSE:
82
- → TRANSITION: Plan → Assemble (Transition 2v9)
82
+ → TRANSITION: Outline → Assemble (Transition 2v9)
83
83
  ELSE IF v8 mode AND workflow.design.started == false AND workflow.engineering.started == false:
84
- → TRANSITION: Planning → Design (Transition 2) OR Planning → Engineer (Transition 2B)
84
+ → TRANSITION: Outline → Design (Transition 2) OR Outline → Engineer (Transition 2B)
85
85
 
86
86
  IF v9 mode AND context_workflow.status == "detail":
87
87
  → Check workflow.detail.specialists array
@@ -118,20 +118,20 @@ IF no clear transition detected:
118
118
  → ASK USER: "Which phase just completed?" (use AskUserQuestion)
119
119
  ```
120
120
 
121
- ## STATE SCHEMA (v7.0)
121
+ ## STATE SCHEMA (v8.0)
122
122
 
123
123
  This is the authoritative schema for `.project-memory-state.json`:
124
124
 
125
125
  ```json
126
126
  {
127
127
  "initialized": true,
128
- "version": "7.0",
128
+ "version": "8.0",
129
129
  "active_context": "trunk",
130
130
  "trunk": {
131
- "status": "none | prompt | planning | design | engineering | building | testing | detail | complete",
131
+ "status": "none | prompt | outline | design | engineering | building | testing | detail | complete",
132
132
  "workflow": {
133
133
  "prompt": { "started": false, "completed": false, "started_at": null, "completed_at": null, "output_files": [] },
134
- "planning": { "started": false, "completed": false, "completed_at": null, "approved": false },
134
+ "outline": { "started": false, "completed": false, "completed_at": null, "approved": false },
135
135
  "design": { "started": false, "completed": false, "completed_at": null, "items": [], "current_item": null },
136
136
  "engineering": { "started": false, "completed": false, "completed_at": null },
137
137
  "build": { "started": false, "completed": false, "completed_at": null },
@@ -189,6 +189,10 @@ Triggered when start routes to handoff with branch creation intent. User has pro
189
189
  5. **Write updated state**. Set `last_handoff_transition` to "branch_creation".
190
190
  6. **Route user**: "Branch **[display_name]** created. Run `/clear` then `/intuition-prompt` to define what this branch will accomplish."
191
191
 
192
+ ## V7 STATE MIGRATION
193
+
194
+ Fires when handoff detects `version == "7.0"`. For trunk and every branch: rename the `planning` key to `outline` in the `workflow` object (preserving all sub-fields: started, completed, completed_at, approved), and change any `status == "planning"` to `"outline"`. Set `version: "8.0"`, preserve all other fields, write state. Report: "Migrated state from v7.0 to v8.0 (renamed planning → outline)." Then continue with the original transition.
195
+
192
196
  ## V5 STATE MIGRATION
193
197
 
194
198
  Fires when handoff detects `version == "5.0"`. For trunk and every branch: if `workflow.detail` does not exist, add `"detail": { "started": false, "completed": false, "completed_at": null, "team_assignment": null, "specialists": [], "current_specialist": null, "execution_phase": 1 }` after `build` in the workflow object. Also add `"test": { "started": false, "completed": false, "completed_at": null, "skipped": false }` after `build`. Set `version: "7.0"`, preserve all other fields, write state. Report: "Migrated state from v5.0 to v7.0 (added detail phase + test phase)." Then continue with the original transition.
@@ -205,7 +209,7 @@ Fires when handoff detects `version == "4.0"` OR (`execution` phase exists but n
205
209
 
206
210
  Fires when handoff detects `version == "3.0"` OR missing `active_context`. Create `docs/project_notes/trunk/`. Move existing workflow artifacts (`prompt_brief.md`, `prompt_output.json`, `planning_brief.md`, `plan.md`, `design_brief.md`, `design_spec_*.md`, `execution_brief.md`, `.planning_research/`) from `docs/project_notes/` into `trunk/` — skip missing files. Restructure state: wrap existing `status` + `workflow` into `trunk` object, add `active_context: "trunk"`, `branches: {}`, rename `execution` → `build`, add `engineering` phase, set `version: "5.0"`. Preserve `initialized`, `last_handoff`, `last_handoff_transition`. Write state. Report what was migrated and confirm v5.0 upgrade. Leave shared files (`key_facts.md`, `decisions.md`, `issues.md`, `bugs.md`) at `docs/project_notes/`.
207
211
 
208
- ## TRANSITION 1: PROMPT → PLANNING
212
+ ## TRANSITION 1: PROMPT → OUTLINE
209
213
 
210
214
  Read `{context_path}prompt_brief.md` and `{context_path}prompt_output.json` (if exists — fall back to extracting from brief manually).
211
215
 
@@ -213,39 +217,39 @@ Read `{context_path}prompt_brief.md` and `{context_path}prompt_output.json` (if
213
217
 
214
218
  **User Profile Merge:** If `prompt_output.json` has `user_profile_learnings` AND `.claude/USER_PROFILE.json` exists: read profile, merge (null fields get new values, populated fields overwrite only if confidence "high"), save. Skip if no USER_PROFILE.json.
215
219
 
216
- **Generate Planning Brief:** Write `{context_path}planning_brief.md` with: Discovery Summary (1-2 paragraphs), Problem Statement, Goals & Success Criteria, Key Constraints, Architectural Context, Assumptions & Risks (with confidence levels), References (prompt_brief path, ADR numbers).
220
+ **Generate Outline Brief:** Write `{context_path}outline_brief.md` with: Discovery Summary (1-2 paragraphs), Problem Statement, Goals & Success Criteria, Key Constraints, Architectural Context, Assumptions & Risks (with confidence levels), References (prompt_brief path, ADR numbers).
217
221
 
218
- Update state: set `status` to `"planning"`, mark `prompt.completed = true` with timestamp, set `planning.started = true`. Route: "Prompt output processed. Planning brief saved to `{context_path}planning_brief.md`. Run `/clear` then `/intuition-plan` to create a structured plan."
222
+ Update state: set `status` to `"outline"`, mark `prompt.completed = true` with timestamp, set `outline.started = true`. Route: "Prompt output processed. Outline brief saved to `{context_path}outline_brief.md`. Run `/clear` then `/intuition-outline` to create a structured plan."
219
223
 
220
- ## TRANSITION 2: PLANNING → DESIGN (Initial Setup)
224
+ ## TRANSITION 2: OUTLINE → DESIGN (Initial Setup)
221
225
 
222
- v8 mode only. Read `{context_path}plan.md`. Find "Design Recommendations" section — extract items flagged for design with rationale and task numbers (if no section, assess tasks yourself). Extract: decisions → `decisions.md`, risks/dependencies → include in brief, planning work → `issues.md`.
226
+ v8 mode only. Read `{context_path}outline.md`. Find "Design Recommendations" section — extract items flagged for design with rationale and task numbers (if no section, assess tasks yourself). Extract: decisions → `decisions.md`, risks/dependencies → include in brief, outline work → `issues.md`.
223
227
 
224
228
  **Present to user** via AskUserQuestion (header: "Design Items"): list each flagged item with rationale. Options: "All recommended items need design" / "Some items — let me specify" / "None — skip design, go straight to engineering". If "Some," follow up. If "None," use Transition 2B.
225
229
 
226
230
  **Generate Design Brief:** Write `{context_path}design_brief.md` for FIRST item with: Current Item, Plan Context (1-2 paragraphs), Task Details (numbers, description, acceptance criteria, dependencies), Design Rationale, Constraints, Design Queue (all items with status), References.
227
231
 
228
- Update state: set `status` to `"design"`, mark `planning.completed = true` with timestamp and `approved = true`, set `design.started = true`, populate `design.items`, set `design.current_item` to first item (`"in_progress"`). Route: "Plan processed. Design brief prepared for **[First Item Name]**. Run `/clear` then `/intuition-design` to begin design exploration."
232
+ Update state: set `status` to `"design"`, mark `outline.completed = true` with timestamp and `approved = true`, set `design.started = true`, populate `design.items`, set `design.current_item` to first item (`"in_progress"`). Route: "Outline processed. Design brief prepared for **[First Item Name]**. Run `/clear` then `/intuition-design` to begin design exploration."
229
233
 
230
- ## TRANSITION 2B: PLANNING → ENGINEER (Skip Design)
234
+ ## TRANSITION 2B: OUTLINE → ENGINEER (Skip Design)
231
235
 
232
236
  v8 mode only. Used when user confirms NO items need design. Write `{context_path}engineering_brief.md` with: Plan Summary (1-2 paragraphs), Objective, Discovery Context, Task Summary, Known Risks, References.
233
237
 
234
- Update state: set `status` to `"engineering"`, mark `planning.completed = true` with timestamp and `approved = true`, set `design.started = false`, `design.completed = false`, `design.items = []`, set `engineering.started = true`. Route: "Plan processed. No design items flagged. Engineering brief saved to `{context_path}engineering_brief.md`. Run `/clear` then `/intuition-engineer` to create code specs."
238
+ Update state: set `status` to `"engineering"`, mark `outline.completed = true` with timestamp and `approved = true`, set `design.started = false`, `design.completed = false`, `design.items = []`, set `engineering.started = true`. Route: "Outline processed. No design items flagged. Engineering brief saved to `{context_path}engineering_brief.md`. Run `/clear` then `/intuition-engineer` to create code specs."
235
239
 
236
- ## TRANSITION 2v9: PLAN → ASSEMBLE
240
+ ## TRANSITION 2v9: OUTLINE → ASSEMBLE
237
241
 
238
- v9 mode only. Triggers when planning completes and the plan contains a `### 6.5 Detail Assessment` section.
242
+ v9 mode only. Triggers when outline completes and the plan contains a `### 6.5 Detail Assessment` section.
239
243
 
240
244
  ### Protocol
241
245
 
242
- 1. **Extract and structure** from plan.md: architectural decisions → `docs/project_notes/decisions.md`, risks/dependencies → note for brief, planning insights → `docs/project_notes/issues.md`.
243
- 2. **Update state**: Set `status` to `"planning"`, mark `planning.completed = true` with timestamp, `approved = true`.
244
- 3. **Route user**: "Plan processed. Run `/clear` then `/intuition-assemble` to build the specialist team and begin the detail phase."
246
+ 1. **Extract and structure** from outline.md: architectural decisions → `docs/project_notes/decisions.md`, risks/dependencies → note for brief, outline insights → `docs/project_notes/issues.md`.
247
+ 2. **Update state**: Set `status` to `"outline"`, mark `outline.completed = true` with timestamp, `approved = true`.
248
+ 3. **Route user**: "Outline processed. Run `/clear` then `/intuition-assemble` to build the specialist team and begin the detail phase."
245
249
 
246
250
  ## TRANSITION 2.5v9: ASSEMBLE → DETAIL
247
251
 
248
- v9 mode only. Triggers when planning is complete, `{context_path}team_assignment.json` exists, and detail has not started. This means assemble has finished and the team is ready.
252
+ v9 mode only. Triggers when outline is complete, `{context_path}team_assignment.json` exists, and detail has not started. This means assemble has finished and the team is ready.
249
253
 
250
254
  ### Protocol
251
255
 
@@ -275,18 +279,18 @@ v9 mode only. Triggers when planning is complete, `{context_path}team_assignment
275
279
  - **Dependencies**: {from plan}
276
280
 
277
281
  ## Known Research
278
- {Extract from plan.md the sections relevant to THIS specialist's domain and assigned tasks:}
282
+ {Extract from outline.md the sections relevant to THIS specialist's domain and assigned tasks:}
279
283
  {- Section 2 (Discovery Summary) — full content, always include}
280
284
  {- Section 4 (Risk Analysis) — risks relevant to this specialist's tasks}
281
285
  {- Section 7 (Architectural Decisions) — decisions touching this specialist's domain}
282
- {- Any other plan sections that contain research findings relevant to the assigned tasks}
283
- {Omit sections with no relevance to this specialist. If the plan has no research relevant to this specialist, write "No prior research overlaps with this specialist's domain."}
286
+ {- Any other outline sections that contain research findings relevant to the assigned tasks}
287
+ {Omit sections with no relevance to this specialist. If the outline has no research relevant to this specialist, write "No prior research overlaps with this specialist's domain."}
284
288
 
285
289
  ## Prior Blueprints
286
290
  None (first specialist in execution order)
287
291
 
288
- ## Plan Context
289
- {Relevant content from plan.md Section 10, if present}
292
+ ## Outline Context
293
+ {Relevant content from outline.md Section 10, if present}
290
294
 
291
295
  ## Detail Queue
292
296
  {All specialists with status:}
@@ -328,11 +332,11 @@ v9 mode only. Triggers when the current specialist's blueprint is complete and m
328
332
 
329
333
  5. **Generate detail brief for next specialist**: Overwrite `{context_path}/detail_brief.md` with:
330
334
  - **Current Specialist**: name, display_name, domain (from next specialist's profile)
331
- - **Assigned Tasks**: task details from plan
335
+ - **Assigned Tasks**: task details from outline
332
336
  - **Specialist Profile Path**: absolute path to the next specialist's profile
333
- - **Known Research**: same extraction as Transition 2.5v9 — plan sections relevant to this specialist's domain and tasks (Section 2 always, Sections 4/7 filtered by relevance). Omit sections with no relevance.
337
+ - **Known Research**: same extraction as Transition 2.5v9 — outline sections relevant to this specialist's domain and tasks (Section 2 always, Sections 4/7 filtered by relevance). Omit sections with no relevance.
334
338
  - **Prior Blueprints**: paths to ALL completed blueprints in `{context_path}/blueprints/` (the next specialist may need to reference them)
335
- - **Plan Context**: section 10 content
339
+ - **Outline Context**: section 10 content
336
340
  - **Detail Queue**: all specialists with status (completed/in_progress/pending)
337
341
 
338
342
  6. **Update state**: Set `detail.current_specialist` to next specialist name, mark next specialist `status: "in_progress"`, `stage: "stage1"`. Update `detail.execution_phase` if advanced.
@@ -376,23 +380,23 @@ v9 mode only. Triggers when ALL specialists in `detail.specialists` have `status
376
380
 
377
381
  v8 mode only. Read `{context_path}design_spec_[completed_item].md` and current state. Extract from completed spec: decisions → `decisions.md`, key facts → `key_facts.md`, design work → `issues.md`. Find next `"pending"` item in `design.items`. If none remain, proceed to Transition 4.
378
382
 
379
- Overwrite `{context_path}design_brief.md` for the next item with: Current Item (name + description), Plan Context, Task Details, Design Rationale, Prior Design Context, Constraints (updated with prior decisions), Design Queue (completed/current/pending), References (plan path, completed spec paths).
383
+ Overwrite `{context_path}design_brief.md` for the next item with: Current Item (name + description), Outline Context, Task Details, Design Rationale, Prior Design Context, Constraints (updated with prior decisions), Design Queue (completed/current/pending), References (outline path, completed spec paths).
380
384
 
381
385
  Update state: mark completed item `"completed"` with `spec_file`, mark next item `"in_progress"`, set `design.current_item`. Route: "[Previous Item] design complete. Design brief updated for **[Next Item Name]** ([N] of [total], [remaining] remaining). Run `/clear` then `/intuition-design` to continue."
382
386
 
383
387
  ## TRANSITION 4: DESIGN → ENGINEER
384
388
 
385
- v8 mode only. Triggers when ALL design items are `"completed"` or `"skipped"`. Read all `{context_path}design_spec_*.md` and `plan.md`. Extract from specs: decisions → `decisions.md`, key facts → `key_facts.md`, design work → `issues.md`.
389
+ v8 mode only. Triggers when ALL design items are `"completed"` or `"skipped"`. Read all `{context_path}design_spec_*.md` and `outline.md`. Extract from specs: decisions → `decisions.md`, key facts → `key_facts.md`, design work → `issues.md`.
386
390
 
387
- Write `{context_path}engineering_brief.md` with: Plan Summary (1-2 paragraphs), Objective, Discovery Context, Design Specifications (list each spec; include "Engineer MUST read these specs before creating code specs for flagged tasks"), Task Summary (mark tasks with design specs), Known Risks, References (plan, discovery, design spec paths).
391
+ Write `{context_path}engineering_brief.md` with: Outline Summary (1-2 paragraphs), Objective, Discovery Context, Design Specifications (list each spec; include "Engineer MUST read these specs before creating code specs for flagged tasks"), Task Summary (mark tasks with design specs), Known Risks, References (outline, discovery, design spec paths).
388
392
 
389
393
  Update state: set `status` to `"engineering"`, mark `design.completed = true` with timestamp, set `engineering.started = true`. Route: "All design specs processed. Engineering brief saved to `{context_path}engineering_brief.md`. Run `/clear` then `/intuition-engineer` to create code specs."
390
394
 
391
395
  ## TRANSITION 5: ENGINEER → BUILD
392
396
 
393
- Read `{context_path}code_specs.md` and `plan.md`. Extract: engineering decisions → `decisions.md`, implementation approach facts → `key_facts.md`.
397
+ Read `{context_path}code_specs.md` and `outline.md`. Extract: engineering decisions → `decisions.md`, implementation approach facts → `key_facts.md`.
394
398
 
395
- Write `{context_path}build_brief.md` with: Plan Summary (1-2 paragraphs), Objective, Code Specs Summary (task count, key decisions — 1 line each), Required User Steps, Quality Gates (security review, tests, code review), Known Risks, References (plan, code_specs, design spec paths if any).
399
+ Write `{context_path}build_brief.md` with: Outline Summary (1-2 paragraphs), Objective, Code Specs Summary (task count, key decisions — 1 line each), Required User Steps, Quality Gates (security review, tests, code review), Known Risks, References (outline, code_specs, design spec paths if any).
396
400
 
397
401
  Update state: set `status` to `"building"`, mark `engineering.completed = true` with timestamp, set `build.started = true`. Route: "Code specs processed. Build brief saved to `{context_path}build_brief.md`. Run `/clear` then `/intuition-build` to begin implementation."
398
402
 
@@ -423,7 +427,7 @@ v9 mode only. Triggers when build completes and `team_assignment.json` contains
423
427
  - **Output files**: [from build_report]
424
428
 
425
429
  ## Acceptance Criteria
426
- [For each code-writer task, extract acceptance criteria from plan.md]
430
+ [For each code-writer task, extract acceptance criteria from outline.md]
427
431
 
428
432
  ## Decision Log References
429
433
  - Specialist decision logs: [paths to {context_path}/scratch/*-decisions.json]
@@ -495,14 +499,14 @@ All shared memory files live at `docs/project_notes/` (never context_path).
495
499
 
496
500
  - **Missing prompt_output.json**: Extract insights from prompt_brief.md manually.
497
501
  - **Poor output quality**: Process as-is. Note concerns in brief. Do NOT fix outputs.
498
- - **New constraints from planning**: Update key_facts.md, create ADR if architectural.
502
+ - **New constraints from outline**: Update key_facts.md, create ADR if architectural.
499
503
  - **Interrupted handoff**: Check what's updated, continue from there, don't duplicate.
500
504
  - **Corrupted state**: Infer phase from existing files. Ask user to confirm.
501
505
  - **Design item skipped mid-loop**: Mark as `"skipped"`, proceed to next. Note in engineering brief.
502
- - **No Design Recommendations in plan**: Present tasks to user, ask if any need design. If none, use 2B.
503
- - **Plan revision after design started**: Alert user. Ask whether to continue or re-evaluate.
506
+ - **No Design Recommendations in outline**: Present tasks to user, ask if any need design. If none, use 2B.
507
+ - **Outline revision after design started**: Alert user. Ask whether to continue or re-evaluate.
504
508
  - **Missing code_specs.md at Transition 5**: Tell user to run `/intuition-engineer` first.
505
- - **v9 plan detected but no assemble run yet**: Route to `/intuition-assemble`.
509
+ - **v9 outline detected but no assemble run yet**: Route to `/intuition-assemble`.
506
510
  - **v9 specialist dependency blueprint missing**: Skip to next eligible specialist. If none are eligible, halt and ask user.
507
511
  - **v9 conflict detection finds issues**: Present all conflicts, ask user to resolve before build. Do not auto-resolve.
508
512
  - **v9 completeness gate fails**: Report exact failures per blueprint. User must fix blueprints (re-run detail) before build.
@@ -8,7 +8,7 @@ Each phase produces valuable output. Your job is to:
8
8
  1. Extract the valuable insights from that output
9
9
  2. Document them properly in project memory
10
10
  3. Prepare the next agent with fresh, relevant context
11
- 4. Maintain the flow from discovery → planning → execution
11
+ 4. Maintain the flow from discovery → outline → execution
12
12
 
13
13
  You're the administrative glue that keeps the symphony coordinated.
14
14
 
@@ -16,7 +16,7 @@ You're the administrative glue that keeps the symphony coordinated.
16
16
 
17
17
  As part of every handoff, extract user profile learnings and update the global user profile:
18
18
 
19
- ### Discovery → Planning Handoff (User Profile Focus)
19
+ ### Discovery → Outline Handoff (User Profile Focus)
20
20
 
21
21
  **From prompt_output.json**, extract `user_profile_learnings`:
22
22
 
@@ -75,10 +75,10 @@ When invoked, determine which transition is happening:
75
75
 
76
76
  ```
77
77
  IF workflow.discovery.completed == true
78
- AND workflow.planning.started == false:
79
- → TRANSITION: Discovery → Planning
78
+ AND workflow.outline.started == false:
79
+ → TRANSITION: Discovery → Outline
80
80
 
81
- IF workflow.planning.completed == true
81
+ IF workflow.outline.completed == true
82
82
  AND workflow.execution.started == false:
83
83
  → TRANSITION: Planning → Execution
84
84
 
@@ -91,14 +91,14 @@ Check `.project-memory-state.json` to determine current state:
91
91
  ```json
92
92
  {
93
93
  "workflow": {
94
- "status": "discovery", // or "planning", "executing"
94
+ "status": "discovery", // or "outline", "executing"
95
95
  "discovery": {
96
96
  "started": true,
97
97
  "completed": true,
98
98
  "completed_at": "2025-02-02T...",
99
99
  "output_files": ["prompt_brief.md", "prompt_output.json"]
100
100
  },
101
- "planning": {
101
+ "outline": {
102
102
  "started": false,
103
103
  "completed": false
104
104
  }
@@ -106,7 +106,7 @@ Check `.project-memory-state.json` to determine current state:
106
106
  }
107
107
  ```
108
108
 
109
- ## Transition 1: Discovery → Planning
109
+ ## Transition 1: Discovery → Outline
110
110
 
111
111
  ### Step 1: Read Outputs
112
112
 
@@ -241,10 +241,10 @@ Example:
241
241
 
242
242
  ### Step 4: Generate Brief for Magellan
243
243
 
244
- Create a brief that synthesizes discovery for planning. Structure:
244
+ Create a brief that synthesizes discovery for outline. Structure:
245
245
 
246
246
  ```markdown
247
- # Planning Brief: [Problem Title]
247
+ # Outline Brief: [Problem Title]
248
248
 
249
249
  ## Discovery Summary
250
250
  [1-2 paragraph summary of what was discovered]
@@ -268,29 +268,29 @@ Create a brief that synthesizes discovery for planning. Structure:
268
268
 
269
269
  ## Assumptions & Risks
270
270
  - Assumption: [X] - Confidence: High/Medium/Low
271
- - Risk: [Y] - Should be explored during planning
271
+ - Risk: [Y] - Should be explored during outline
272
272
 
273
273
  ## References
274
274
  - Discovery Brief: docs/project_notes/prompt_brief.md
275
275
  - Relevant Decisions: ADR-001, ADR-002
276
276
 
277
277
  ## Notes for Planner
278
- [Any observations that might help planning]
278
+ [Any observations that might help outline]
279
279
  ```
280
280
 
281
- **Store as:** `docs/project_notes/planning_brief.md`
281
+ **Store as:** `docs/project_notes/outline_brief.md`
282
282
 
283
283
  ### Step 5: Update Workflow State
284
284
 
285
285
  ```json
286
286
  {
287
287
  "workflow": {
288
- "status": "planning",
288
+ "status": "outline",
289
289
  "discovery": {
290
290
  "completed": true,
291
291
  "completed_at": "2025-02-02T..."
292
292
  },
293
- "planning": {
293
+ "outline": {
294
294
  "started": true,
295
295
  "started_at": "2025-02-02T..."
296
296
  }
@@ -301,27 +301,27 @@ Create a brief that synthesizes discovery for planning. Structure:
301
301
  ### Step 6: Suggest Next Step
302
302
 
303
303
  ```
304
- "Discovery is now part of project memory. I've created a planning brief
305
- at docs/project_notes/planning_brief.md.
304
+ "Discovery is now part of project memory. I've created an outline brief
305
+ at docs/project_notes/outline_brief.md.
306
306
 
307
- Ready to create a plan? Run /intuition-plan to have Magellan synthesize
307
+ Ready to create an outline? Run /intuition-outline to have Magellan synthesize
308
308
  this discovery into a structured approach."
309
309
  ```
310
310
 
311
311
  ---
312
312
 
313
- ## Transition 2: Planning → Execution
313
+ ## Transition 2: Outline → Execution
314
314
 
315
315
  ### Step 1: Read Output
316
316
 
317
317
  ```
318
- plan.md (from Magellan)
319
- └─ Structured plan with tasks, dependencies, risks
318
+ outline.md (from Magellan)
319
+ └─ Structured outline with tasks, dependencies, risks
320
320
  ```
321
321
 
322
322
  ### Step 2: Extract Relevant Info
323
323
 
324
- From `plan.md`, identify:
324
+ From `outline.md`, identify:
325
325
 
326
326
  **Key Task Information:**
327
327
  - Task list and structure
@@ -342,8 +342,8 @@ From `plan.md`, identify:
342
342
  ### Step 3: Update Memory Files
343
343
 
344
344
  **Update issues.md:**
345
- - Log the planning work
346
- - Link to plan.md
345
+ - Log the outline work
346
+ - Link to outline.md
347
347
 
348
348
  Example:
349
349
  ```markdown
@@ -352,17 +352,17 @@ Example:
352
352
  - **Status**: Planned
353
353
  - **Description**: Structured plan for implementing JWT-based user
354
354
  authentication across API and frontend
355
- - **Plan**: docs/project_notes/plan.md
355
+ - **Outline**: docs/project_notes/outline.md
356
356
  - **Tasks**: 8 tasks identified, ready for execution
357
357
  ```
358
358
 
359
359
  **Update decisions.md (if needed):**
360
- - If planning revealed new architectural choices
361
- - Add ADRs for decisions made during planning
360
+ - If outline revealed new architectural choices
361
+ - Add ADRs for decisions made during outline
362
362
 
363
363
  **Do NOT modify:**
364
- - key_facts.md (facts don't change, planning doesn't discover new facts)
365
- - bugs.md (execution finds bugs, not planning)
364
+ - key_facts.md (facts don't change, outline doesn't discover new facts)
365
+ - bugs.md (execution finds bugs, not outline)
366
366
 
367
367
  ### Step 4: Generate Brief for Faraday
368
368
 
@@ -405,7 +405,7 @@ Create a brief for execution. Structure:
405
405
  [Reference to existing ADRs that matter for execution]
406
406
 
407
407
  ## References
408
- - Full Plan: docs/project_notes/plan.md
408
+ - Full Outline: docs/project_notes/outline.md
409
409
  - Discovery Brief: docs/project_notes/prompt_brief.md
410
410
  - Relevant Decisions: ADR-001, ADR-002, ...
411
411
 
@@ -421,7 +421,7 @@ Create a brief for execution. Structure:
421
421
  {
422
422
  "workflow": {
423
423
  "status": "executing",
424
- "planning": {
424
+ "outline": {
425
425
  "completed": true,
426
426
  "completed_at": "2025-02-02T..."
427
427
  },
@@ -436,7 +436,7 @@ Create a brief for execution. Structure:
436
436
  ### Step 6: Suggest Next Step
437
437
 
438
438
  ```
439
- "Planning is now in project memory. I've created an execution brief
439
+ "Outline is now in project memory. I've created an execution brief
440
440
  at docs/project_notes/execution_brief.md with everything Faraday needs.
441
441
 
442
442
  Ready to execute? Run /intuition-execute to have Faraday coordinate
@@ -497,7 +497,7 @@ implementation."
497
497
  - **Status**: Completed | In Progress | Blocked
498
498
  - **Description**: [1-2 line summary]
499
499
  - **Discovery Brief**: [link] (if from discovery)
500
- - **Plan**: [link] (if from planning)
500
+ - **Outline**: [link] (if from outline)
501
501
  - **URL**: [link to ticket if external]
502
502
  - **Notes**: [any relevant context]
503
503
  ```
@@ -526,12 +526,12 @@ implementation."
526
526
  4. User can request re-discovery if needed
527
527
  ```
528
528
 
529
- ### What if planning revealed new constraints?
529
+ ### What if outline revealed new constraints?
530
530
 
531
531
  ```
532
532
  1. Update key_facts.md with new constraints
533
533
  2. Create ADR if it represents architectural choice
534
- 3. Note in issues.md that planning revealed this
534
+ 3. Note in issues.md that outline revealed this
535
535
  4. Include in execution brief for Faraday's awareness
536
536
  ```
537
537
 
@@ -565,8 +565,8 @@ Example:
565
565
  ✓ decisions.md: Added ADR-005 on database strategy
566
566
  ✓ issues.md: Logged discovery work completed
567
567
 
568
- I've created planning_brief.md with everything Magellan needs.
569
- Ready to plan? Run /intuition-plan"
568
+ I've created outline_brief.md with everything Magellan needs.
569
+ Ready to outline? Run /intuition-outline"
570
570
  ```
571
571
 
572
572
  ---
@@ -575,7 +575,7 @@ Ready to plan? Run /intuition-plan"
575
575
 
576
576
  Before completing handoff:
577
577
 
578
- - [ ] Detected correct transition (Discovery→Planning or Planning→Execution)
578
+ - [ ] Detected correct transition (Discovery→Outline or Outline→Execution)
579
579
  - [ ] Read all necessary output files
580
580
  - [ ] Extracted insights without losing information
581
581
  - [ ] Updated memory files with proper formatting
@@ -122,7 +122,7 @@ The state file uses the v7.0 schema:
122
122
  ```json
123
123
  {
124
124
  "initialized": true,
125
- "version": "7.0",
125
+ "version": "8.0",
126
126
  "active_context": "trunk",
127
127
  "trunk": {
128
128
  "status": "none",
@@ -134,7 +134,7 @@ The state file uses the v7.0 schema:
134
134
  "completed_at": null,
135
135
  "output_files": []
136
136
  },
137
- "planning": {
137
+ "outline": {
138
138
  "started": false,
139
139
  "completed": false,
140
140
  "completed_at": null,