@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
@@ -1,118 +1,118 @@
1
- # Multi-Agent System & Project Memory
2
-
3
- ## Overview
4
-
5
- This project uses a multi-agent system coordinated by Intuition (`@tgoodington/intuition`), a Claude Code skill system. Twelve specialized skills handle prompt refinement, planning, design exploration, code engineering, and build execution, with memory maintained in `docs/project_notes/` for consistency across sessions.
6
-
7
- ## Workflow Skills
8
-
9
- ### Core Workflow (run in sequence with handoff between each)
10
-
11
- | Skill | Model | What it does |
12
- |-------|-------|-------------|
13
- | `/intuition-prompt` | opus | Transforms a rough vision into a planning-ready brief through focused iterative refinement |
14
- | `/intuition-plan` | opus | Strategic architect — maps stakeholders, explores components, evaluates options, creates executable blueprint |
15
- | `/intuition-design` | opus | Elaborates flagged plan items through ECD framework (Elements, Connections, Dynamics) |
16
- | `/intuition-engineer` | opus | Creates code-level specifications through codebase research and interactive dialogue → `code_specs.md` |
17
- | `/intuition-build` | sonnet | Delegates implementation to subagents, verifies outputs against code specs and acceptance criteria |
18
-
19
- ### Infrastructure
20
-
21
- | Skill | Model | What it does |
22
- |-------|-------|-------------|
23
- | `/intuition-start` | haiku | Loads project context, detects workflow phase, routes to correct next skill |
24
- | `/intuition-handoff` | haiku | Processes phase outputs, updates memory, generates briefs for the next phase |
25
- | `/intuition-initialize` | haiku | Sets up project memory infrastructure (run once per project) |
26
- | `/intuition-update` | haiku | Package update manager |
27
-
28
- ### Advisory
29
-
30
- | Skill | Model | What it does |
31
- |-------|-------|-------------|
32
- | `/intuition-debugger` | opus | Expert debugger — 5 diagnostic categories, causal chain analysis, post-completion only |
33
- | `/intuition-agent-advisor` | opus | Expert advisor on building custom Claude Code agents |
34
- | `/intuition-skill-guide` | opus | Expert advisor on building custom Claude Code skills |
35
-
36
- ## Model Strategy
37
-
38
- - **opus** — Complex multi-step reasoning: prompt refinement, planning, design exploration, code engineering, debugging, advisory
39
- - **sonnet** — Project management and delegation: build manager, broad research subagents
40
- - **haiku** — Focused simple tasks: start, handoff, state updates, narrow research subagents
41
-
42
- ## Workflow
43
-
44
- ### Trunk (first cycle)
45
-
46
- ```
47
- /intuition-prompt → handoff → /intuition-plan → handoff →
48
- [/intuition-design loop] → handoff → /intuition-engineer → handoff →
49
- /intuition-build → handoff → complete
50
- ```
51
-
52
- Each handoff transition:
53
- 1. Reads the previous phase's output
54
- 2. Updates shared memory files
55
- 3. Generates a fresh brief for the next phase
56
- 4. Updates `.project-memory-state.json`
57
- 5. Routes to the next skill (with `/clear` between phases)
58
-
59
- ### Branches (subsequent cycles)
60
-
61
- After trunk completes, run `/intuition-start` to:
62
- - **Create a branch** — new prompt→build cycle informed by trunk context
63
- - **Open the debugger** — investigate hard problems in any completed context
64
-
65
- Branches follow the same 5-phase workflow but read parent context for continuity.
66
-
67
- ### Design Loop (optional)
68
-
69
- The plan flags tasks requiring design exploration (Section 6.5). If design items exist:
70
- 1. Handoff generates a design brief for the first item
71
- 2. `/intuition-design` elaborates it using the ECD framework
72
- 3. Handoff checks for remaining items → loops back or advances to engineer
73
-
74
- ### Engineer → Build Split
75
-
76
- - **Engineer** (opus, interactive) determines the code-level HOW: reads codebase via research subagents, discusses decisions with you, produces `code_specs.md`
77
- - **Build** (sonnet, PM) implements against specs: delegates to Code Writer subagents, verifies with Code Reviewer, runs mandatory Security Expert review, produces `build_report.md`
78
- - Build makes NO engineering decisions — it matches output to specs
79
-
80
- ## Build Sub-Agents
81
-
82
- The build phase delegates to these task-based subagents via the Task tool:
83
-
84
- | Sub-Agent | Model | Purpose |
85
- |-----------|-------|---------|
86
- | Code Writer | sonnet | Implements features and fixes per code specs |
87
- | Code Reviewer | sonnet | Reviews quality, maintainability, adherence to specs |
88
- | Security Expert | sonnet | Scans for vulnerabilities (mandatory before completion) |
89
-
90
- ## Project Memory
91
-
92
- **Memory Files** (`docs/project_notes/`):
93
- - `bugs.md` — Bug log with solutions and prevention notes
94
- - `decisions.md` — Architectural Decision Records (ADRs)
95
- - `key_facts.md` — Project configuration, constants, URLs
96
- - `issues.md` — Work log with ticket references
97
-
98
- **Phase Output Files** (in `{context_path}/`):
99
- - `planning_brief.md` — Brief for planning (created by handoff)
100
- - `plan.md` — Structured plan with tasks, design recommendations
101
- - `design_brief.md` — Brief for current design item (created/updated by handoff)
102
- - `engineering_brief.md` — Brief for engineering (created by handoff)
103
- - `code_specs.md` — Code-level specifications (created by engineer)
104
- - `build_brief.md` — Brief for build (created by handoff)
105
- - `build_report.md` — Task outcomes, files modified (created by build)
106
-
107
- **How Skills Use Memory:**
108
- - Check `decisions.md` before proposing architectural changes
109
- - Search `bugs.md` for similar issues before debugging
110
- - Reference `key_facts.md` for project configuration
111
- - Log completed work in `issues.md`
112
-
113
- ## Coordination
114
-
115
- - All workflow skills route to `/intuition-handoff` between phases
116
- - Handoff is the ONLY skill that writes to `.project-memory-state.json`
117
- - `/clear` runs between phases to keep context clean (each skill reads from disk)
118
- - State tracks trunk, branches, and active context with per-context workflow pipelines
1
+ # Multi-Agent System & Project Memory
2
+
3
+ ## Overview
4
+
5
+ This project uses a multi-agent system coordinated by Intuition (`@tgoodington/intuition`), a Claude Code skill system. Twelve specialized skills handle prompt refinement, planning, design exploration, code engineering, and build execution, with memory maintained in `docs/project_notes/` for consistency across sessions.
6
+
7
+ ## Workflow Skills
8
+
9
+ ### Core Workflow (run in sequence with handoff between each)
10
+
11
+ | Skill | Model | What it does |
12
+ |-------|-------|-------------|
13
+ | `/intuition-prompt` | opus | Transforms a rough vision into a planning-ready brief through focused iterative refinement |
14
+ | `/intuition-outline` | opus | Strategic architect — maps stakeholders, explores components, evaluates options, creates executable blueprint |
15
+ | `/intuition-design` | opus | Elaborates flagged plan items through ECD framework (Elements, Connections, Dynamics) |
16
+ | `/intuition-engineer` | opus | Creates code-level specifications through codebase research and interactive dialogue → `code_specs.md` |
17
+ | `/intuition-build` | sonnet | Delegates implementation to subagents, verifies outputs against code specs and acceptance criteria |
18
+
19
+ ### Infrastructure
20
+
21
+ | Skill | Model | What it does |
22
+ |-------|-------|-------------|
23
+ | `/intuition-start` | haiku | Loads project context, detects workflow phase, routes to correct next skill |
24
+ | `/intuition-handoff` | haiku | Processes phase outputs, updates memory, generates briefs for the next phase |
25
+ | `/intuition-initialize` | haiku | Sets up project memory infrastructure (run once per project) |
26
+ | `/intuition-update` | haiku | Package update manager |
27
+
28
+ ### Advisory
29
+
30
+ | Skill | Model | What it does |
31
+ |-------|-------|-------------|
32
+ | `/intuition-debugger` | opus | Expert debugger — 5 diagnostic categories, causal chain analysis, post-completion only |
33
+ | `/intuition-agent-advisor` | opus | Expert advisor on building custom Claude Code agents |
34
+ | `/intuition-skill-guide` | opus | Expert advisor on building custom Claude Code skills |
35
+
36
+ ## Model Strategy
37
+
38
+ - **opus** — Complex multi-step reasoning: prompt refinement, planning, design exploration, code engineering, debugging, advisory
39
+ - **sonnet** — Project management and delegation: build manager, broad research subagents
40
+ - **haiku** — Focused simple tasks: start, handoff, state updates, narrow research subagents
41
+
42
+ ## Workflow
43
+
44
+ ### Trunk (first cycle)
45
+
46
+ ```
47
+ /intuition-prompt → handoff → /intuition-outline → handoff →
48
+ [/intuition-design loop] → handoff → /intuition-engineer → handoff →
49
+ /intuition-build → handoff → complete
50
+ ```
51
+
52
+ Each handoff transition:
53
+ 1. Reads the previous phase's output
54
+ 2. Updates shared memory files
55
+ 3. Generates a fresh brief for the next phase
56
+ 4. Updates `.project-memory-state.json`
57
+ 5. Routes to the next skill (with `/clear` between phases)
58
+
59
+ ### Branches (subsequent cycles)
60
+
61
+ After trunk completes, run `/intuition-start` to:
62
+ - **Create a branch** — new prompt→build cycle informed by trunk context
63
+ - **Open the debugger** — investigate hard problems in any completed context
64
+
65
+ Branches follow the same 5-phase workflow but read parent context for continuity.
66
+
67
+ ### Design Loop (optional)
68
+
69
+ The plan flags tasks requiring design exploration (Section 6.5). If design items exist:
70
+ 1. Handoff generates a design brief for the first item
71
+ 2. `/intuition-design` elaborates it using the ECD framework
72
+ 3. Handoff checks for remaining items → loops back or advances to engineer
73
+
74
+ ### Engineer → Build Split
75
+
76
+ - **Engineer** (opus, interactive) determines the code-level HOW: reads codebase via research subagents, discusses decisions with you, produces `code_specs.md`
77
+ - **Build** (sonnet, PM) implements against specs: delegates to Code Writer subagents, verifies with Code Reviewer, runs mandatory Security Expert review, produces `build_report.md`
78
+ - Build makes NO engineering decisions — it matches output to specs
79
+
80
+ ## Build Sub-Agents
81
+
82
+ The build phase delegates to these task-based subagents via the Task tool:
83
+
84
+ | Sub-Agent | Model | Purpose |
85
+ |-----------|-------|---------|
86
+ | Code Writer | sonnet | Implements features and fixes per code specs |
87
+ | Code Reviewer | sonnet | Reviews quality, maintainability, adherence to specs |
88
+ | Security Expert | sonnet | Scans for vulnerabilities (mandatory before completion) |
89
+
90
+ ## Project Memory
91
+
92
+ **Memory Files** (`docs/project_notes/`):
93
+ - `bugs.md` — Bug log with solutions and prevention notes
94
+ - `decisions.md` — Architectural Decision Records (ADRs)
95
+ - `key_facts.md` — Project configuration, constants, URLs
96
+ - `issues.md` — Work log with ticket references
97
+
98
+ **Phase Output Files** (in `{context_path}/`):
99
+ - `outline_brief.md` — Brief for outline (created by handoff)
100
+ - `outline.md` — Structured outline with tasks, design recommendations
101
+ - `design_brief.md` — Brief for current design item (created/updated by handoff)
102
+ - `engineering_brief.md` — Brief for engineering (created by handoff)
103
+ - `code_specs.md` — Code-level specifications (created by engineer)
104
+ - `build_brief.md` — Brief for build (created by handoff)
105
+ - `build_report.md` — Task outcomes, files modified (created by build)
106
+
107
+ **How Skills Use Memory:**
108
+ - Check `decisions.md` before proposing architectural changes
109
+ - Search `bugs.md` for similar issues before debugging
110
+ - Reference `key_facts.md` for project configuration
111
+ - Log completed work in `issues.md`
112
+
113
+ ## Coordination
114
+
115
+ - All workflow skills route to `/intuition-handoff` between phases
116
+ - Handoff is the ONLY skill that writes to `.project-memory-state.json`
117
+ - `/clear` runs between phases to keep context clean (each skill reads from disk)
118
+ - State tracks trunk, branches, and active context with per-context workflow pipelines
@@ -1,134 +1,134 @@
1
- ## Project Workflow and Memory System
2
-
3
- This project uses a five-phase workflow coordinated by the Intuition system, with institutional knowledge maintained in `docs/project_notes/` for consistency across sessions.
4
-
5
- ### Workflow Model
6
-
7
- The Intuition workflow uses a trunk-and-branch model:
8
- - **Trunk**: The first prompt→plan→design→engineer→build cycle. Represents the core vision.
9
- - **Branches**: Subsequent cycles that build on, extend, or diverge from trunk or other branches.
10
- - **Debugger**: Post-completion diagnostic specialist for hard problems.
11
-
12
- All phases: `/intuition-prompt` → `/intuition-handoff` → `/intuition-plan` → `/intuition-handoff` →
13
- `[/intuition-design loop]` → `/intuition-handoff` → `/intuition-engineer` → `/intuition-handoff` →
14
- `/intuition-build` → `/intuition-handoff` → complete
15
-
16
- After completion: `/intuition-start` to create branches or `/intuition-debugger` to debug issues.
17
-
18
- ### Workflow Phases
19
-
20
- The project follows a structured workflow with handoff transitions between phases:
21
-
22
- **Prompt** — `/intuition-prompt`
23
- - Transforms a rough vision into a precise, planning-ready brief
24
- - Framework: Capture → Refine → Reflect → Confirm
25
- - Output: Planning-ready brief (processed by Handoff into `planning_brief.md`)
26
-
27
- **Handoff** — `/intuition-handoff`
28
- - Processes phase outputs, updates memory files, generates brief for next phase
29
- - Runs between every phase transition
30
- - Manages the design loop (item-by-item design cycles)
31
- - ONLY component that writes to `.project-memory-state.json`
32
-
33
- **Planning** — `/intuition-plan`
34
- - Strategic synthesis and structured execution planning
35
- - Researches codebase, identifies patterns, creates detailed plan
36
- - Flags tasks requiring design exploration with rationale
37
- - Output: `plan.md` with tasks, dependencies, risks, design recommendations
38
-
39
- **Design** — `/intuition-design`
40
- - Detailed design exploration for flagged plan items
41
- - Framework: ECD (Elements, Connections, Dynamics)
42
- - Domain-agnostic: works for code, world building, UI, documents, or any creative/structural work
43
- - Runs once per flagged item in a loop managed by handoff
44
- - Output: Design specifications per item
45
-
46
- **Engineering** — `/intuition-engineer`
47
- - Creates code-level specifications through codebase research and interactive dialogue
48
- - Research subagents read codebase, engineer discusses decisions with user
49
- - Output: `code_specs.md` — determines the code-level HOW for every task
50
-
51
- **Build** — `/intuition-build`
52
- - Delegates implementation to subagents, verifies against code specs and acceptance criteria
53
- - Mandatory security review before completion
54
- - Makes NO engineering decisions — matches output to specs
55
- - Output: `build_report.md` — task outcomes, files modified, deviations from specs
56
-
57
- **Session Primer** — `/intuition-start`
58
- - Loads project context, detects workflow phase, suggests next step
59
- - Run at the start of any session to get oriented
60
-
61
- **Recommended Flow**: Prompt → Handoff → Plan → Handoff → [Design Loop] → Handoff → Engineer → Handoff → Build → Handoff → complete
62
-
63
- Run `/clear` before each phase skill. After completion, run `/intuition-start` to create a branch or invoke `/intuition-debugger` to debug issues.
64
-
65
- ### Memory Files
66
-
67
- **Core Memory Files** (initialized at setup):
68
- - **bugs.md** — Bug log with dates, solutions, and prevention notes
69
- - **decisions.md** — Architectural Decision Records (ADRs) with context and trade-offs
70
- - **key_facts.md** — Project configuration, credentials, ports, important URLs
71
- - **issues.md** — Work log with ticket IDs, descriptions, and URLs
72
- - **.project-memory-state.json** — Workflow phase tracking and session state
73
-
74
- **Phase Output Files** (created during workflow, in `{context_path}/`):
75
- - **planning_brief.md** — Brief for planning phase (created by Handoff)
76
- - **plan.md** — Structured project plan with design recommendations
77
- - **design_brief.md** — Brief for current design item (created/updated by Handoff)
78
- - **engineering_brief.md** — Brief for engineering phase (created by Handoff)
79
- - **code_specs.md** — Code-level specifications (created by Engineer)
80
- - **build_brief.md** — Brief for build phase (created by Handoff)
81
- - **build_report.md** — Task outcomes and files modified (created by Build)
82
-
83
- ### Memory-Aware Protocols
84
-
85
- **Before proposing architectural changes:**
86
- - Check `docs/project_notes/decisions.md` for existing decisions
87
- - Verify the proposed approach doesn't conflict with past choices
88
- - If it does conflict, acknowledge the existing decision and explain why a change is warranted
89
-
90
- **When encountering errors or bugs:**
91
- - Search `docs/project_notes/bugs.md` for similar issues
92
- - Apply known solutions if found
93
- - Document new bugs and solutions when resolved
94
-
95
- **When looking up project configuration:**
96
- - Check `docs/project_notes/key_facts.md` for credentials, ports, URLs, service accounts
97
- - Prefer documented facts over assumptions
98
-
99
- **When completing work on tickets:**
100
- - Log completed work in `docs/project_notes/issues.md`
101
- - Include ticket ID, date, brief description, and URL
102
-
103
- ### Style Guidelines for Memory Files
104
-
105
- - Prefer bullet lists over tables for simplicity
106
- - Keep entries concise (1-3 lines for descriptions)
107
- - Always include dates for temporal context
108
- - Include URLs for tickets, documentation, monitoring dashboards
109
-
110
- ### Smart Skill Suggestions
111
-
112
- **When prompt refinement is complete:**
113
- - "Prompt refinement looks complete! Use `/intuition-handoff` to process insights and prepare for planning."
114
-
115
- **When user suggests planning work:**
116
- - "This sounds like a good candidate for planning. Use `/intuition-handoff` to process the brief, then `/intuition-plan` to develop a structured approach."
117
-
118
- **When plan is ready and has design items:**
119
- - "The plan looks ready! Use `/intuition-handoff` to review design recommendations and start the design loop."
120
-
121
- **When design items are complete:**
122
- - "All design specs are done! Use `/intuition-handoff` to prepare the engineering brief."
123
-
124
- **When user is ready to engineer:**
125
- - "Engineering brief is ready! Use `/intuition-engineer` to create code specifications."
126
-
127
- **When engineering is complete:**
128
- - "Code specs are ready! Use `/intuition-handoff` to prepare the build brief."
129
-
130
- **When user is ready to build:**
131
- - "Build brief is ready! Use `/intuition-build` to kick off implementation."
132
-
133
- **When build is complete:**
134
- - "Workflow cycle complete! Use `/intuition-start` to create a branch for new work, or `/intuition-debugger` to debug any issues."
1
+ ## Project Workflow and Memory System
2
+
3
+ This project uses a five-phase workflow coordinated by the Intuition system, with institutional knowledge maintained in `docs/project_notes/` for consistency across sessions.
4
+
5
+ ### Workflow Model
6
+
7
+ The Intuition workflow uses a trunk-and-branch model:
8
+ - **Trunk**: The first prompt→plan→design→engineer→build cycle. Represents the core vision.
9
+ - **Branches**: Subsequent cycles that build on, extend, or diverge from trunk or other branches.
10
+ - **Debugger**: Post-completion diagnostic specialist for hard problems.
11
+
12
+ All phases: `/intuition-prompt` → `/intuition-handoff` → `/intuition-outline` → `/intuition-handoff` →
13
+ `[/intuition-design loop]` → `/intuition-handoff` → `/intuition-engineer` → `/intuition-handoff` →
14
+ `/intuition-build` → `/intuition-handoff` → complete
15
+
16
+ After completion: `/intuition-start` to create branches or `/intuition-debugger` to debug issues.
17
+
18
+ ### Workflow Phases
19
+
20
+ The project follows a structured workflow with handoff transitions between phases:
21
+
22
+ **Prompt** — `/intuition-prompt`
23
+ - Transforms a rough vision into a precise, planning-ready brief
24
+ - Framework: Capture → Refine → Reflect → Confirm
25
+ - Output: Planning-ready brief (processed by Handoff into `outline_brief.md`)
26
+
27
+ **Handoff** — `/intuition-handoff`
28
+ - Processes phase outputs, updates memory files, generates brief for next phase
29
+ - Runs between every phase transition
30
+ - Manages the design loop (item-by-item design cycles)
31
+ - ONLY component that writes to `.project-memory-state.json`
32
+
33
+ **Outline** — `/intuition-outline`
34
+ - Strategic synthesis and structured execution planning
35
+ - Researches codebase, identifies patterns, creates detailed plan
36
+ - Flags tasks requiring design exploration with rationale
37
+ - Output: `outline.md` with tasks, dependencies, risks, design recommendations
38
+
39
+ **Design** — `/intuition-design`
40
+ - Detailed design exploration for flagged plan items
41
+ - Framework: ECD (Elements, Connections, Dynamics)
42
+ - Domain-agnostic: works for code, world building, UI, documents, or any creative/structural work
43
+ - Runs once per flagged item in a loop managed by handoff
44
+ - Output: Design specifications per item
45
+
46
+ **Engineering** — `/intuition-engineer`
47
+ - Creates code-level specifications through codebase research and interactive dialogue
48
+ - Research subagents read codebase, engineer discusses decisions with user
49
+ - Output: `code_specs.md` — determines the code-level HOW for every task
50
+
51
+ **Build** — `/intuition-build`
52
+ - Delegates implementation to subagents, verifies against code specs and acceptance criteria
53
+ - Mandatory security review before completion
54
+ - Makes NO engineering decisions — matches output to specs
55
+ - Output: `build_report.md` — task outcomes, files modified, deviations from specs
56
+
57
+ **Session Primer** — `/intuition-start`
58
+ - Loads project context, detects workflow phase, suggests next step
59
+ - Run at the start of any session to get oriented
60
+
61
+ **Recommended Flow**: Prompt → Handoff → Plan → Handoff → [Design Loop] → Handoff → Engineer → Handoff → Build → Handoff → complete
62
+
63
+ Run `/clear` before each phase skill. After completion, run `/intuition-start` to create a branch or invoke `/intuition-debugger` to debug issues.
64
+
65
+ ### Memory Files
66
+
67
+ **Core Memory Files** (initialized at setup):
68
+ - **bugs.md** — Bug log with dates, solutions, and prevention notes
69
+ - **decisions.md** — Architectural Decision Records (ADRs) with context and trade-offs
70
+ - **key_facts.md** — Project configuration, credentials, ports, important URLs
71
+ - **issues.md** — Work log with ticket IDs, descriptions, and URLs
72
+ - **.project-memory-state.json** — Workflow phase tracking and session state
73
+
74
+ **Phase Output Files** (created during workflow, in `{context_path}/`):
75
+ - **outline_brief.md** — Brief for outline phase (created by Handoff)
76
+ - **outline.md** — Structured project outline with design recommendations
77
+ - **design_brief.md** — Brief for current design item (created/updated by Handoff)
78
+ - **engineering_brief.md** — Brief for engineering phase (created by Handoff)
79
+ - **code_specs.md** — Code-level specifications (created by Engineer)
80
+ - **build_brief.md** — Brief for build phase (created by Handoff)
81
+ - **build_report.md** — Task outcomes and files modified (created by Build)
82
+
83
+ ### Memory-Aware Protocols
84
+
85
+ **Before proposing architectural changes:**
86
+ - Check `docs/project_notes/decisions.md` for existing decisions
87
+ - Verify the proposed approach doesn't conflict with past choices
88
+ - If it does conflict, acknowledge the existing decision and explain why a change is warranted
89
+
90
+ **When encountering errors or bugs:**
91
+ - Search `docs/project_notes/bugs.md` for similar issues
92
+ - Apply known solutions if found
93
+ - Document new bugs and solutions when resolved
94
+
95
+ **When looking up project configuration:**
96
+ - Check `docs/project_notes/key_facts.md` for credentials, ports, URLs, service accounts
97
+ - Prefer documented facts over assumptions
98
+
99
+ **When completing work on tickets:**
100
+ - Log completed work in `docs/project_notes/issues.md`
101
+ - Include ticket ID, date, brief description, and URL
102
+
103
+ ### Style Guidelines for Memory Files
104
+
105
+ - Prefer bullet lists over tables for simplicity
106
+ - Keep entries concise (1-3 lines for descriptions)
107
+ - Always include dates for temporal context
108
+ - Include URLs for tickets, documentation, monitoring dashboards
109
+
110
+ ### Smart Skill Suggestions
111
+
112
+ **When prompt refinement is complete:**
113
+ - "Prompt refinement looks complete! Use `/intuition-handoff` to process insights and prepare for outline."
114
+
115
+ **When user suggests outline work:**
116
+ - "This sounds like a good candidate for planning. Use `/intuition-handoff` to process the brief, then `/intuition-outline` to develop a structured approach."
117
+
118
+ **When plan is ready and has design items:**
119
+ - "The plan looks ready! Use `/intuition-handoff` to review design recommendations and start the design loop."
120
+
121
+ **When design items are complete:**
122
+ - "All design specs are done! Use `/intuition-handoff` to prepare the engineering brief."
123
+
124
+ **When user is ready to engineer:**
125
+ - "Engineering brief is ready! Use `/intuition-engineer` to create code specifications."
126
+
127
+ **When engineering is complete:**
128
+ - "Code specs are ready! Use `/intuition-handoff` to prepare the build brief."
129
+
130
+ **When user is ready to build:**
131
+ - "Build brief is ready! Use `/intuition-build` to kick off implementation."
132
+
133
+ **When build is complete:**
134
+ - "Workflow cycle complete! Use `/intuition-start` to create a branch for new work, or `/intuition-debugger` to debug any issues."
@@ -5,7 +5,7 @@ A trunk-and-branch workflow system for Claude Code. Turns rough ideas into struc
5
5
  ## Workflow
6
6
 
7
7
  ```
8
- /intuition-prompt → /intuition-handoff → /intuition-plan → /intuition-handoff
8
+ /intuition-prompt → /intuition-handoff → /intuition-outline → /intuition-handoff
9
9
 
10
10
  [design loop, if needed]
11
11
 
@@ -28,7 +28,7 @@ The first prompt→build cycle is the **trunk**. After trunk completes, create *
28
28
  |-------|-------------|
29
29
  | `/intuition-start` | Detects where you left off, shows project status, routes to next step or branch creation |
30
30
  | `/intuition-prompt` | Sharpens a rough idea into a planning-ready brief through focused Q&A |
31
- | `/intuition-plan` | Builds a strategic blueprint with tasks, decisions, and design flags |
31
+ | `/intuition-outline` | Builds a strategic blueprint with tasks, decisions, and design flags |
32
32
  | `/intuition-design` | Elaborates flagged items through collaborative design exploration (ECD framework) |
33
33
  | `/intuition-engineer` | Creates code-level specifications through codebase research and interactive dialogue |
34
34
  | `/intuition-build` | Delegates implementation to subagents, verifies against code specs and acceptance criteria |
@@ -42,8 +42,8 @@ The first prompt→build cycle is the **trunk**. After trunk completes, create *
42
42
 
43
43
  1. `/intuition-start` — see where you are
44
44
  2. `/intuition-prompt` — describe what you want to build
45
- 3. `/intuition-handoff` — process and move to planning
46
- 4. `/intuition-plan` — create the blueprint
45
+ 3. `/intuition-handoff` — process and move to outline
46
+ 4. `/intuition-outline` — create the blueprint
47
47
  5. `/intuition-handoff` — review design flags, confirm items
48
48
  6. `/intuition-design` — elaborate each flagged item (repeat with handoff between)
49
49
  7. `/intuition-handoff` — prepare for engineering
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "initialized": true,
3
- "version": "7.0",
3
+ "version": "8.0",
4
4
  "active_context": "trunk",
5
5
  "trunk": {
6
6
  "status": "none",
@@ -12,7 +12,7 @@
12
12
  "completed_at": null,
13
13
  "output_files": []
14
14
  },
15
- "planning": {
15
+ "outline": {
16
16
  "started": false,
17
17
  "completed": false,
18
18
  "completed_at": null,