@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
|
@@ -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-
|
|
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-
|
|
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
|
-
- `
|
|
100
|
-
- `
|
|
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-
|
|
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 `
|
|
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
|
-
**
|
|
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: `
|
|
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
|
-
- **
|
|
76
|
-
- **
|
|
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
|
|
114
|
-
|
|
115
|
-
**When user suggests
|
|
116
|
-
- "This sounds like a good candidate for planning. Use `/intuition-handoff` to process the brief, then `/intuition-
|
|
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-
|
|
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-
|
|
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
|
|
46
|
-
4. `/intuition-
|
|
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": "
|
|
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
|
-
"
|
|
15
|
+
"outline": {
|
|
16
16
|
"started": false,
|
|
17
17
|
"completed": false,
|
|
18
18
|
"completed_at": null,
|