@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
|
@@ -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→
|
|
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,
|
|
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}
|
|
49
|
-
2. IF
|
|
50
|
-
3. IF
|
|
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→
|
|
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.
|
|
75
|
-
→ TRANSITION: Prompt →
|
|
74
|
+
AND workflow.outline.started == false:
|
|
75
|
+
→ TRANSITION: Prompt → Outline (Transition 1)
|
|
76
76
|
|
|
77
|
-
IF context_workflow.status == "
|
|
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:
|
|
82
|
+
→ TRANSITION: Outline → Assemble (Transition 2v9)
|
|
83
83
|
ELSE IF v8 mode AND workflow.design.started == false AND workflow.engineering.started == false:
|
|
84
|
-
→ TRANSITION:
|
|
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 (
|
|
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": "
|
|
128
|
+
"version": "8.0",
|
|
129
129
|
"active_context": "trunk",
|
|
130
130
|
"trunk": {
|
|
131
|
-
"status": "none | prompt |
|
|
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
|
-
"
|
|
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 →
|
|
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
|
|
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 `"
|
|
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:
|
|
224
|
+
## TRANSITION 2: OUTLINE → DESIGN (Initial Setup)
|
|
221
225
|
|
|
222
|
-
v8 mode only. Read `{context_path}
|
|
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 `
|
|
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:
|
|
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 `
|
|
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:
|
|
240
|
+
## TRANSITION 2v9: OUTLINE → ASSEMBLE
|
|
237
241
|
|
|
238
|
-
v9 mode only. Triggers when
|
|
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
|
|
243
|
-
2. **Update state**: Set `status` to `"
|
|
244
|
-
3. **Route user**: "
|
|
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
|
|
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
|
|
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
|
|
283
|
-
{Omit sections with no relevance to this specialist. If the
|
|
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
|
-
##
|
|
289
|
-
{Relevant content from
|
|
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
|
|
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 —
|
|
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
|
-
- **
|
|
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),
|
|
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 `
|
|
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:
|
|
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 `
|
|
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:
|
|
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
|
|
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
|
|
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
|
|
503
|
-
- **
|
|
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
|
|
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 →
|
|
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 →
|
|
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.
|
|
79
|
-
→ TRANSITION: Discovery →
|
|
78
|
+
AND workflow.outline.started == false:
|
|
79
|
+
→ TRANSITION: Discovery → Outline
|
|
80
80
|
|
|
81
|
-
IF workflow.
|
|
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 "
|
|
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
|
-
"
|
|
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 →
|
|
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
|
|
244
|
+
Create a brief that synthesizes discovery for outline. Structure:
|
|
245
245
|
|
|
246
246
|
```markdown
|
|
247
|
-
#
|
|
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
|
|
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
|
|
278
|
+
[Any observations that might help outline]
|
|
279
279
|
```
|
|
280
280
|
|
|
281
|
-
**Store as:** `docs/project_notes/
|
|
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": "
|
|
288
|
+
"status": "outline",
|
|
289
289
|
"discovery": {
|
|
290
290
|
"completed": true,
|
|
291
291
|
"completed_at": "2025-02-02T..."
|
|
292
292
|
},
|
|
293
|
-
"
|
|
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
|
|
305
|
-
at docs/project_notes/
|
|
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
|
|
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:
|
|
313
|
+
## Transition 2: Outline → Execution
|
|
314
314
|
|
|
315
315
|
### Step 1: Read Output
|
|
316
316
|
|
|
317
317
|
```
|
|
318
|
-
|
|
319
|
-
└─ Structured
|
|
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 `
|
|
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
|
|
346
|
-
- Link to
|
|
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
|
-
- **
|
|
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
|
|
361
|
-
- Add ADRs for decisions made during
|
|
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,
|
|
365
|
-
- bugs.md (execution finds bugs, not
|
|
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
|
|
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
|
-
"
|
|
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
|
-
"
|
|
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
|
-
- **
|
|
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
|
|
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
|
|
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
|
|
569
|
-
Ready to
|
|
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→
|
|
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": "
|
|
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
|
-
"
|
|
137
|
+
"outline": {
|
|
138
138
|
"started": false,
|
|
139
139
|
"completed": false,
|
|
140
140
|
"completed_at": null,
|