@tgoodington/intuition 11.4.0 → 11.5.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/package.json +1 -2
- package/skills/intuition-enuncia-compose/SKILL.md +5 -10
- package/skills/intuition-enuncia-design/SKILL.md +0 -4
- package/skills/intuition-enuncia-discovery/SKILL.md +1 -7
- package/skills/intuition-enuncia-execute/SKILL.md +0 -4
- package/skills/intuition-enuncia-handoff/SKILL.md +0 -4
- package/skills/intuition-enuncia-initialize/references/claude_template.md +20 -0
- package/skills/intuition-enuncia-start/SKILL.md +0 -4
- package/skills/intuition-enuncia-verify/SKILL.md +0 -4
- package/docs/archive/ARCHITECTURE_OVERVIEW.txt +0 -405
- package/docs/archive/INSTALLATION.md +0 -431
- package/docs/archive/PROJECT_CONTEXT.md +0 -361
- package/docs/archive/QUICK_TEST_CHECKLIST.md +0 -467
- package/docs/archive/SKILL_INTERACTION_GUIDE.md +0 -993
- package/docs/archive/TESTING_README.md +0 -215
- package/docs/archive/TESTING_SUMMARY.md +0 -781
- package/docs/archive/WALDO_V3_COMPLETE_DOCUMENTATION.md +0 -538
- package/docs/archive/WALDO_V3_DESIGN_SUMMARY.md +0 -449
- package/docs/archive/intuition-architecture.md +0 -342
- package/docs/archive/intuition-workflow.md +0 -210
- package/docs/archive/intuition_design_skill_spec.md +0 -219
- package/docs/archive/v7_design_spec.md +0 -1111
- package/docs/archive/v7_plan.md +0 -339
- package/docs/archive/v9-design/decision-framework-direction.md +0 -142
- package/docs/archive/v9-design/decision-framework-implementation.md +0 -114
- package/docs/archive/v9-design/domain-adaptive-team-architecture.md +0 -1016
- package/docs/archive/v9-test/SESSION_SUMMARY.md +0 -117
- package/docs/archive/v9-test/TEST_PLAN.md +0 -119
- package/docs/archive/v9-test/blueprints/legal-analyst.md +0 -166
- package/docs/archive/v9-test/output/07_cover_letter.md +0 -41
- package/docs/archive/v9-test/phase2/mock_plan.md +0 -89
- package/docs/archive/v9-test/phase2/producers.json +0 -32
- package/docs/archive/v9-test/phase2/specialists/database-architect.specialist.md +0 -10
- package/docs/archive/v9-test/phase2/specialists/financial-analyst.specialist.md +0 -10
- package/docs/archive/v9-test/phase2/specialists/legal-analyst.specialist.md +0 -10
- package/docs/archive/v9-test/phase2/specialists/technical-writer.specialist.md +0 -10
- package/docs/archive/v9-test/phase2/team_assignment.json +0 -61
- package/docs/archive/v9-test/phase3/blueprints/legal-analyst.md +0 -840
- package/docs/archive/v9-test/phase3/legal-analyst-full.specialist.md +0 -111
- package/docs/archive/v9-test/phase3/project_context/nh_landlord_tenant_notes.md +0 -35
- package/docs/archive/v9-test/phase3/project_context/property_facts.md +0 -32
- package/docs/archive/v9-test/phase3b/blueprints/legal-analyst.md +0 -1715
- package/docs/archive/v9-test/phase3b/legal-analyst.specialist.md +0 -153
- package/docs/archive/v9-test/phase3b/scratch/legal-analyst-stage1.md +0 -270
- package/docs/archive/v9-test/phase4/TEST_PLAN.md +0 -32
- package/docs/archive/v9-test/phase4/blueprints/financial-analyst-T2.md +0 -538
- package/docs/archive/v9-test/phase4/blueprints/legal-analyst-T4.md +0 -253
- package/docs/archive/v9-test/phase4/cross-blueprint-check.md +0 -280
- package/docs/archive/v9-test/phase4/scratch/financial-analyst-T2-stage1.md +0 -67
- package/docs/archive/v9-test/phase4/scratch/legal-analyst-T4-stage1.md +0 -54
- package/docs/archive/v9-test/phase4/specialists/financial-analyst.specialist.md +0 -156
- package/docs/archive/v9-test/phase4/specialists/legal-analyst.specialist.md +0 -153
- package/docs/archive/v9-test/phase5/TEST_PLAN.md +0 -35
- package/docs/archive/v9-test/phase5/blueprints/code-architect-hw-vetter.md +0 -375
- package/docs/archive/v9-test/phase5/output/04_compliance_checklist.md +0 -149
- package/docs/archive/v9-test/phase5/output/hardware-vetter-SKILL-v2.md +0 -561
- package/docs/archive/v9-test/phase5/output/hardware-vetter-SKILL.md +0 -459
- package/docs/archive/v9-test/phase5/producers/code-writer.producer.md +0 -49
- package/docs/archive/v9-test/phase5/producers/document-writer.producer.md +0 -62
- package/docs/archive/v9-test/phase5/regression-comparison-v2.md +0 -60
- package/docs/archive/v9-test/phase5/regression-comparison.md +0 -197
- package/docs/archive/v9-test/phase5/review-5A-specialist.md +0 -213
- package/docs/archive/v9-test/phase5/specialist-test/TEST_PLAN.md +0 -60
- package/docs/archive/v9-test/phase5/specialist-test/blueprint-comparison.md +0 -252
- package/docs/archive/v9-test/phase5/specialist-test/blueprints/code-architect-hw-vetter.md +0 -916
- package/docs/archive/v9-test/phase5/specialist-test/scratch/code-architect-stage1.md +0 -427
- package/docs/archive/v9-test/phase5/specialists/code-architect.specialist.md +0 -168
- package/docs/archive/v9-test/phase5b/TEST_PLAN.md +0 -219
- package/docs/archive/v9-test/phase5b/blueprints/5B-10-stage2-with-decisions.md +0 -286
- package/docs/archive/v9-test/phase5b/decisions/5B-2-accept-all-decisions.json +0 -68
- package/docs/archive/v9-test/phase5b/decisions/5B-3-promote-decisions.json +0 -70
- package/docs/archive/v9-test/phase5b/decisions/5B-4-individual-decisions.json +0 -68
- package/docs/archive/v9-test/phase5b/decisions/5B-5-triage-decisions.json +0 -110
- package/docs/archive/v9-test/phase5b/decisions/5B-6-fallback-decisions.json +0 -40
- package/docs/archive/v9-test/phase5b/decisions/5B-8-partial-decisions.json +0 -46
- package/docs/archive/v9-test/phase5b/decisions/5B-9-complete-decisions.json +0 -54
- package/docs/archive/v9-test/phase5b/scratch/code-architect-stage1.md +0 -133
- package/docs/archive/v9-test/phase5b/specialists/code-architect.specialist.md +0 -202
- package/docs/archive/v9-test/phase5b/stage1-many-decisions.md +0 -139
- package/docs/archive/v9-test/phase5b/stage1-no-assumptions.md +0 -70
- package/docs/archive/v9-test/phase5b/stage1-with-assumptions.md +0 -86
- package/docs/archive/v9-test/phase5b/test-5B-1-results.md +0 -157
- package/docs/archive/v9-test/phase5b/test-5B-10-results.md +0 -130
- package/docs/archive/v9-test/phase5b/test-5B-2-results.md +0 -75
- package/docs/archive/v9-test/phase5b/test-5B-3-results.md +0 -104
- package/docs/archive/v9-test/phase5b/test-5B-4-results.md +0 -114
- package/docs/archive/v9-test/phase5b/test-5B-5-results.md +0 -126
- package/docs/archive/v9-test/phase5b/test-5B-6-results.md +0 -60
- package/docs/archive/v9-test/phase5b/test-5B-7-results.md +0 -141
- package/docs/archive/v9-test/phase5b/test-5B-8-results.md +0 -115
- package/docs/archive/v9-test/phase5b/test-5B-9-results.md +0 -76
- package/docs/archive/v9-test/producers/document-writer.producer.md +0 -62
- package/docs/archive/v9-test/specialists/legal-analyst.specialist.md +0 -58
- package/docs/project_notes/.project-memory-state.json +0 -100
- package/docs/project_notes/archive/trunk-v9.2-complete/.gitkeep +0 -0
- package/docs/project_notes/archive/trunk-v9.2-complete/.planning_research/decision_file_naming.md +0 -15
- package/docs/project_notes/archive/trunk-v9.2-complete/.planning_research/decisions_log.md +0 -32
- package/docs/project_notes/archive/trunk-v9.2-complete/.planning_research/orientation.md +0 -51
- package/docs/project_notes/archive/trunk-v9.2-complete/audit/plan-rename-hitlist.md +0 -654
- package/docs/project_notes/archive/trunk-v9.2-complete/blueprint-conflicts.md +0 -109
- package/docs/project_notes/archive/trunk-v9.2-complete/blueprints/database-architect.md +0 -416
- package/docs/project_notes/archive/trunk-v9.2-complete/blueprints/devops-infrastructure.md +0 -514
- package/docs/project_notes/archive/trunk-v9.2-complete/blueprints/technical-writer.md +0 -788
- package/docs/project_notes/archive/trunk-v9.2-complete/build_brief.md +0 -119
- package/docs/project_notes/archive/trunk-v9.2-complete/build_report.md +0 -250
- package/docs/project_notes/archive/trunk-v9.2-complete/detail_brief.md +0 -94
- package/docs/project_notes/archive/trunk-v9.2-complete/plan.md +0 -182
- package/docs/project_notes/archive/trunk-v9.2-complete/planning_brief.md +0 -96
- package/docs/project_notes/archive/trunk-v9.2-complete/prompt_brief.md +0 -60
- package/docs/project_notes/archive/trunk-v9.2-complete/prompt_output.json +0 -98
- package/docs/project_notes/archive/trunk-v9.2-complete/scratch/database-architect-decisions.json +0 -72
- package/docs/project_notes/archive/trunk-v9.2-complete/scratch/database-architect-research-plan.md +0 -10
- package/docs/project_notes/archive/trunk-v9.2-complete/scratch/database-architect-stage1.md +0 -226
- package/docs/project_notes/archive/trunk-v9.2-complete/scratch/devops-infrastructure-decisions.json +0 -71
- package/docs/project_notes/archive/trunk-v9.2-complete/scratch/devops-infrastructure-research-plan.md +0 -7
- package/docs/project_notes/archive/trunk-v9.2-complete/scratch/devops-infrastructure-stage1.md +0 -164
- package/docs/project_notes/archive/trunk-v9.2-complete/scratch/technical-writer-decisions.json +0 -88
- package/docs/project_notes/archive/trunk-v9.2-complete/scratch/technical-writer-research-plan.md +0 -7
- package/docs/project_notes/archive/trunk-v9.2-complete/scratch/technical-writer-stage1.md +0 -266
- package/docs/project_notes/archive/trunk-v9.2-complete/team_assignment.json +0 -108
- package/docs/project_notes/archive/trunk-v9.2-complete/test_brief.md +0 -75
- package/docs/project_notes/archive/trunk-v9.2-complete/test_report.md +0 -26
- package/docs/project_notes/archive/trunk-v9.2-complete/verification/devops-infrastructure-verification.md +0 -172
- package/docs/project_notes/branches/.gitkeep +0 -0
- package/docs/project_notes/bugs.md +0 -41
- package/docs/project_notes/decisions.md +0 -147
- package/docs/project_notes/issues.md +0 -101
- package/docs/project_notes/key_facts.md +0 -88
- package/docs/project_notes/trunk/.gitkeep +0 -0
- package/docs/project_notes/trunk/discovery_brief.md +0 -40
- package/docs/project_notes/v9.2-optimization-plan.md +0 -193
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tgoodington/intuition",
|
|
3
|
-
"version": "11.
|
|
3
|
+
"version": "11.5.1",
|
|
4
4
|
"description": "Domain-adaptive workflow system for Claude Code. Includes the Enuncia pipeline (discovery, compose, design, execute, verify) and the classic pipeline (prompt, outline, assemble, detail, build, test, implement).",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"claude-code",
|
|
@@ -30,7 +30,6 @@
|
|
|
30
30
|
"specialists/",
|
|
31
31
|
"producers/",
|
|
32
32
|
"scripts/",
|
|
33
|
-
"docs/",
|
|
34
33
|
"README.md",
|
|
35
34
|
"LICENSE"
|
|
36
35
|
],
|
|
@@ -8,10 +8,6 @@ allowed-tools: Read, Write, Glob, Grep, Task, Bash
|
|
|
8
8
|
|
|
9
9
|
# Outline Protocol
|
|
10
10
|
|
|
11
|
-
## PROJECT GOAL
|
|
12
|
-
|
|
13
|
-
Deliver something to the user through an experience that places them as creative director, offloading technical implementation to Claude, that satisfies their needs and desires.
|
|
14
|
-
|
|
15
11
|
## SKILL GOAL
|
|
16
12
|
|
|
17
13
|
Take the discovery foundation and determine what needs to exist from each stakeholder's perspective (experience slices), then decompose into tasks that the design phase can build technical specs from. Produce the first draft of the project map — a living document that tracks how the pieces connect and evolves through each downstream phase.
|
|
@@ -24,12 +20,11 @@ You are a decomposition thinker. You see a vision and ask "what needs to be true
|
|
|
24
20
|
2. You MUST read `{context_path}/discovery_brief.md`. If missing, stop: "No discovery brief found. Run `/intuition-enuncia-discovery` first."
|
|
25
21
|
3. During dialogue, you MUST ask questions as plain text. AskUserQuestion is ONLY for the approval gate at the end.
|
|
26
22
|
4. You MUST NOT make technical decisions. Architecture, technology choices, and implementation approaches belong to specialists.
|
|
27
|
-
5. You MUST
|
|
28
|
-
6. You MUST
|
|
29
|
-
7. You MUST
|
|
30
|
-
8. You MUST
|
|
31
|
-
9. You MUST
|
|
32
|
-
10. You MUST reference the discovery brief's North Star when evaluating whether experience slices are complete — if a slice doesn't serve the North Star, it doesn't belong.
|
|
23
|
+
5. You MUST produce experience slices that are stakeholder-perspective-in, not component-out.
|
|
24
|
+
6. You MUST decompose tasks until each one passes the producer-ready test (see SIZING CHECK). There is no "Deep" or "Standard" — every task should be light enough to build directly.
|
|
25
|
+
7. You MUST write `tasks.json`, `docs/project_notes/project_map.md`, and update state before routing.
|
|
26
|
+
8. You MUST route to `/intuition-enuncia-design`. NEVER to `/intuition-enuncia-handoff`.
|
|
27
|
+
9. You MUST reference the discovery brief's North Star when evaluating whether experience slices are complete — if a slice doesn't serve the North Star, it doesn't belong.
|
|
33
28
|
|
|
34
29
|
## CONTEXT PATH RESOLUTION
|
|
35
30
|
|
|
@@ -8,10 +8,6 @@ allowed-tools: Read, Write, Glob, Grep, Task, Bash
|
|
|
8
8
|
|
|
9
9
|
# Design Protocol
|
|
10
10
|
|
|
11
|
-
## PROJECT GOAL
|
|
12
|
-
|
|
13
|
-
Deliver something to the user through an experience that places them as creative director, offloading technical implementation to Claude, that satisfies their needs and desires.
|
|
14
|
-
|
|
15
11
|
## SKILL GOAL
|
|
16
12
|
|
|
17
13
|
Take the outline's experience slices and tasks and determine how they get built. Research the codebase and technical landscape, make design decisions, write specs detailed enough for producers to execute, and surface decisions to the user per their decision posture. Update the project map to reflect the real architecture.
|
|
@@ -8,18 +8,12 @@ allowed-tools: Read, Write, Glob, Grep, Task
|
|
|
8
8
|
|
|
9
9
|
# Discovery Protocol
|
|
10
10
|
|
|
11
|
-
## PROJECT GOAL
|
|
12
|
-
|
|
13
|
-
Deliver something to the user through an experience that places them as creative director, offloading technical implementation to Claude, that satisfies their needs and desires.
|
|
14
|
-
|
|
15
11
|
## SKILL GOAL
|
|
16
12
|
|
|
17
13
|
Understand the who, what, where, and why of the project to create a foundational document that all other skills orient from and verify against.
|
|
18
14
|
|
|
19
15
|
You help users figure out what they're building. You do this through focused conversation across four dimensions — Who, Where, What, Why — producing a foundational brief that every downstream skill will reference as its source of truth.
|
|
20
16
|
|
|
21
|
-
You are a sharp collaborator. You listen carefully, confirm what's clear, push back when something seems incomplete or inconsistent, and help the user think when they're uncertain. You never flatter, never pad, never ask questions you already know the answer to.
|
|
22
|
-
|
|
23
17
|
## CRITICAL RULES
|
|
24
18
|
|
|
25
19
|
1. You MUST ask exactly ONE question per turn. No exceptions.
|
|
@@ -27,7 +21,7 @@ You are a sharp collaborator. You listen carefully, confirm what's clear, push b
|
|
|
27
21
|
3. AskUserQuestion is ONLY used for the Confirm step and Decision Posture — the two approval gates at the end.
|
|
28
22
|
4. Every question MUST target one of the four dimensions: Who, Where, What, or Why.
|
|
29
23
|
5. You MUST NOT ask implementation-level questions. "How should the database handle X" is too detailed. "What should users be able to do" is right.
|
|
30
|
-
6. You MUST NOT
|
|
24
|
+
6. You MUST NOT restate what the user just said back to them — only recap when you are sharpening or reframing their words into something more precise.
|
|
31
25
|
7. You MUST NOT ask about motivations, feelings, or personal drivers. Ask about the project, not the person.
|
|
32
26
|
8. You MUST read `.project-memory-state.json` to determine the active context path before writing any files.
|
|
33
27
|
9. You MUST write `discovery_brief.md` when formalizing.
|
|
@@ -8,10 +8,6 @@ allowed-tools: Read, Write, Glob, Grep, Task, TaskCreate, TaskUpdate, TaskList,
|
|
|
8
8
|
|
|
9
9
|
# Execute Protocol
|
|
10
10
|
|
|
11
|
-
## PROJECT GOAL
|
|
12
|
-
|
|
13
|
-
Deliver something to the user through an experience that places them as creative director, offloading technical implementation to Claude, that satisfies their needs and desires.
|
|
14
|
-
|
|
15
11
|
## SKILL GOAL
|
|
16
12
|
|
|
17
13
|
Execute the design specs. Delegate production to the right producers, verify what's built matches both the specs and the discovery foundation, and surface problems honestly. You are the execution arm — you don't make design decisions, you carry them out and verify the results.
|
|
@@ -8,10 +8,6 @@ allowed-tools: Read, Write, Glob, Grep, Bash
|
|
|
8
8
|
|
|
9
9
|
# Handoff Protocol (Enuncia Pipeline)
|
|
10
10
|
|
|
11
|
-
## PROJECT GOAL
|
|
12
|
-
|
|
13
|
-
Deliver something to the user through an experience that places them as creative director, offloading technical implementation to Claude, that satisfies their needs and desires.
|
|
14
|
-
|
|
15
11
|
## SKILL GOAL
|
|
16
12
|
|
|
17
13
|
Create and register new branches. In the Enuncia pipeline, each skill handles its own state transitions — handoff exists only for branch creation.
|
|
@@ -1,3 +1,23 @@
|
|
|
1
|
+
## Project Goal
|
|
2
|
+
|
|
3
|
+
Deliver something the user actually wants, through a process where:
|
|
4
|
+
|
|
5
|
+
- **The user directs.** They decide what gets built, how it should feel, and whether it's right. Product decisions are theirs.
|
|
6
|
+
- **Claude implements.** Claude handles the technical work — architecture, code, configuration. Claude surfaces tradeoffs and options, but never makes product decisions unilaterally.
|
|
7
|
+
- **The result satisfies the user's real needs and desires** — not what's easiest to build, not what Claude assumes they want.
|
|
8
|
+
|
|
9
|
+
This goal holds whether or not a skill is active. Every skill in the Enuncia pipeline is one step toward it.
|
|
10
|
+
|
|
11
|
+
## How to Interact
|
|
12
|
+
|
|
13
|
+
The user is the director. You are the implementer. This holds in every conversation, skill-active or not.
|
|
14
|
+
|
|
15
|
+
- **Offer options, don't decide.** When the user faces a choice that shapes the product, surface the tradeoffs and let them pick.
|
|
16
|
+
- **Be a sharp collaborator.** Listen carefully. Confirm what's clear. Push back when something seems incomplete or inconsistent. Help them think when they're uncertain.
|
|
17
|
+
- **Never flatter, never pad, never restate what they just said.** Show you heard them through substance, not echo.
|
|
18
|
+
- **When a request is ambiguous, ask — don't guess.** One question at a time.
|
|
19
|
+
- **Flag goal conflicts.** If a request would compromise the director experience or push implementation work back on the user, say so.
|
|
20
|
+
|
|
1
21
|
## Project Workflow and Memory System
|
|
2
22
|
|
|
3
23
|
This project uses the Enuncia pipeline (`@tgoodington/intuition`). Run `/intuition-enuncia-start` to check project status and get routed to the next step.
|
|
@@ -8,10 +8,6 @@ allowed-tools: Read, Write, Glob, Grep, Bash
|
|
|
8
8
|
|
|
9
9
|
# Start Protocol (Enuncia Pipeline)
|
|
10
10
|
|
|
11
|
-
## PROJECT GOAL
|
|
12
|
-
|
|
13
|
-
Deliver something to the user through an experience that places them as creative director, offloading technical implementation to Claude, that satisfies their needs and desires.
|
|
14
|
-
|
|
15
11
|
## SKILL GOAL
|
|
16
12
|
|
|
17
13
|
Detect where the project is in the Enuncia pipeline and route the user to the correct next skill. You are a router — read state, determine phase, suggest the next command.
|
|
@@ -8,10 +8,6 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Task, Bash, Agent, WebFetch, mcp__
|
|
|
8
8
|
|
|
9
9
|
# Verify Protocol
|
|
10
10
|
|
|
11
|
-
## PROJECT GOAL
|
|
12
|
-
|
|
13
|
-
Deliver something to the user through an experience that places them as creative director, offloading technical implementation to Claude, that satisfies their needs and desires.
|
|
14
|
-
|
|
15
11
|
## SKILL GOAL
|
|
16
12
|
|
|
17
13
|
Two jobs, done relentlessly:
|
|
@@ -1,405 +0,0 @@
|
|
|
1
|
-
================================================================================
|
|
2
|
-
WALDO v3 ARCHITECTURE OVERVIEW
|
|
3
|
-
Intuition v3.0.0 - February 5, 2026
|
|
4
|
-
================================================================================
|
|
5
|
-
|
|
6
|
-
PROJECT STATUS: Production Ready - Ready for Testing
|
|
7
|
-
|
|
8
|
-
VERSION: 3.0.0
|
|
9
|
-
LATEST COMMIT: bbfa9ff - "feat: Waldo v3 - Research-informed thinking partnership..."
|
|
10
|
-
STATUS: All v3 features implemented and documented
|
|
11
|
-
|
|
12
|
-
================================================================================
|
|
13
|
-
THE FIVE SKILLS
|
|
14
|
-
================================================================================
|
|
15
|
-
|
|
16
|
-
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
17
|
-
│ /intuition-start (Session Primer) │
|
|
18
|
-
│ │
|
|
19
|
-
│ Role: Load context, detect workflow phase, suggest next step │
|
|
20
|
-
│ Creates: Nothing │
|
|
21
|
-
│ Updates: .project-memory-state.json (minimal updates) │
|
|
22
|
-
│ Reads: All memory files for status detection │
|
|
23
|
-
│ When: First command at session start │
|
|
24
|
-
└─────────────────────────────────────────────────────────────────────────────┘
|
|
25
|
-
↓
|
|
26
|
-
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
27
|
-
│ /intuition-discovery (Waldo - Thinking Partner) │
|
|
28
|
-
│ │
|
|
29
|
-
│ Role: Research-informed dialogue for deep problem understanding │
|
|
30
|
-
│ │
|
|
31
|
-
│ DUAL MODES: │
|
|
32
|
-
│ • Guided: Structured options (AskUserQuestion) - user selects answers │
|
|
33
|
-
│ • Open-Ended: Natural conversational flow - user answers freely │
|
|
34
|
-
│ → Both modes produce identical discovery outcomes │
|
|
35
|
-
│ → Dialogue style differs, substance and depth are same │
|
|
36
|
-
│ │
|
|
37
|
-
│ RESEARCH LAUNCH (v3 NEW): │
|
|
38
|
-
│ • Immediate parallel launch of 3 research agents │
|
|
39
|
-
│ • Agent 1: Best practices & standards in user's domain │
|
|
40
|
-
│ • Agent 2: Common pitfalls & inefficiencies │
|
|
41
|
-
│ • Agent 3: Emerging patterns & alternatives │
|
|
42
|
-
│ → All run simultaneously while dialogue continues │
|
|
43
|
-
│ │
|
|
44
|
-
│ DIALOGUE APPROACH (v3 REDESIGN): │
|
|
45
|
-
│ • Wise confidant model (brings knowledge, not neutral) │
|
|
46
|
-
│ • "Yes, and..." building (expands ideas, never negates) │
|
|
47
|
-
│ • 1-2 focused questions per turn (never overwhelming) │
|
|
48
|
-
│ • Gentle steering when heading down inefficient paths │
|
|
49
|
-
│ • Gleaning user profile information naturally │
|
|
50
|
-
│ │
|
|
51
|
-
│ Creates: discovery_brief.md, discovery_output.json │
|
|
52
|
-
│ Updates: .project-memory-state.json │
|
|
53
|
-
│ Outputs: │
|
|
54
|
-
│ - discovery_brief.md: Narrative summary (Problem/Goals/Context) │
|
|
55
|
-
│ - discovery_output.json: Structured findings + user_profile_learnings │
|
|
56
|
-
│ - State: dialogue_mode, research_performed, conversation_history │
|
|
57
|
-
│ │
|
|
58
|
-
│ Routes to: /intuition-handoff (NOT directly to outline) │
|
|
59
|
-
└─────────────────────────────────────────────────────────────────────────────┘
|
|
60
|
-
↓
|
|
61
|
-
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
62
|
-
│ /intuition-handoff (Orchestrator - Phase Coordinator) │
|
|
63
|
-
│ │
|
|
64
|
-
│ Role: Extract insights, update memory, merge profile, prepare next agent │
|
|
65
|
-
│ │
|
|
66
|
-
│ TWO TRANSITIONS: │
|
|
67
|
-
│ │
|
|
68
|
-
│ ┌─ DISCOVERY → PLANNING ────────────────────────────────────────────────┐ │
|
|
69
|
-
│ │ │ │
|
|
70
|
-
│ │ Step 1: Extract insights from discovery_output.json │ │
|
|
71
|
-
│ │ Step 2: Extract user_profile_learnings (v3 NEW) │ │
|
|
72
|
-
│ │ Step 3: Merge into .claude/USER_PROFILE.json (v3 NEW) │ │
|
|
73
|
-
│ │ • Null fields in profile ← add discovered values │ │
|
|
74
|
-
│ │ • Existing fields ← only overwrite if high confidence │ │
|
|
75
|
-
│ │ • Track projects_contributed_to │ │
|
|
76
|
-
│ │ • Update confidence_scores │ │
|
|
77
|
-
│ │ Step 4: Update key_facts.md, decisions.md, issues.md │ │
|
|
78
|
-
│ │ Step 5: Generate outline_brief.md for Magellan │ │
|
|
79
|
-
│ │ Step 6: Update workflow state │ │
|
|
80
|
-
│ │ Step 7: Route to /intuition-outline │ │
|
|
81
|
-
│ │ │ │
|
|
82
|
-
│ └─────────────────────────────────────────────────────────────────────────┘ │
|
|
83
|
-
│ ↓ │
|
|
84
|
-
│ ┌─ PLANNING → EXECUTION ────────────────────────────────────────────────┐ │
|
|
85
|
-
│ │ │ │
|
|
86
|
-
│ │ Step 1: Extract task structure from outline.md │ │
|
|
87
|
-
│ │ Step 2: Update issues.md with outlining completion │ │
|
|
88
|
-
│ │ Step 3: Generate execution_brief.md for Faraday │ │
|
|
89
|
-
│ │ Step 4: Update workflow state │ │
|
|
90
|
-
│ │ Step 5: Route to /intuition-execute │ │
|
|
91
|
-
│ │ │ │
|
|
92
|
-
│ └─────────────────────────────────────────────────────────────────────────┘ │
|
|
93
|
-
│ │
|
|
94
|
-
│ Key: Handoff is NOT evaluating. It's extracting, documenting, preparing. │
|
|
95
|
-
│ Administrative glue that keeps the symphony coordinated. │
|
|
96
|
-
│ │
|
|
97
|
-
│ Creates: outline_brief.md, execution_brief.md │
|
|
98
|
-
│ Updates: key_facts.md, decisions.md, issues.md, USER_PROFILE.json, │
|
|
99
|
-
│ .project-memory-state.json │
|
|
100
|
-
│ Reads: discovery_brief.md, discovery_output.json, outline.md │
|
|
101
|
-
└─────────────────────────────────────────────────────────────────────────────┘
|
|
102
|
-
↓
|
|
103
|
-
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
104
|
-
│ /intuition-outline (Magellan - Strategist & Planner) │
|
|
105
|
-
│ │
|
|
106
|
-
│ Role: Synthesize discovery into structured, executable outline │
|
|
107
|
-
│ │
|
|
108
|
-
│ PERSONALIZATION (v3 NEW): │
|
|
109
|
-
│ • Reads .claude/USER_PROFILE.json at startup │
|
|
110
|
-
│ • Adjusts outline depth based on user's seniority │
|
|
111
|
-
│ • Matches communication style to user preference │
|
|
112
|
-
│ • Factors in user's authority level and constraints │
|
|
113
|
-
│ • Tailors complexity to expertise areas │
|
|
114
|
-
│ │
|
|
115
|
-
│ Creates: outline.md │
|
|
116
|
-
│ Updates: .project-memory-state.json │
|
|
117
|
-
│ Reads: outline_brief.md, existing memory, USER_PROFILE.json, codebase │
|
|
118
|
-
│ │
|
|
119
|
-
│ Output: Structured outline with: │
|
|
120
|
-
│ - Objective and approach │
|
|
121
|
-
│ - Task breakdown with dependencies │
|
|
122
|
-
│ - Acceptance criteria per task │
|
|
123
|
-
│ - Identified risks and mitigations │
|
|
124
|
-
│ - Confidence in approach │
|
|
125
|
-
│ │
|
|
126
|
-
│ Routes to: User approval required before handoff │
|
|
127
|
-
└─────────────────────────────────────────────────────────────────────────────┘
|
|
128
|
-
↓
|
|
129
|
-
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
130
|
-
│ /intuition-execute (Faraday - Implementer & Orchestrator) │
|
|
131
|
-
│ │
|
|
132
|
-
│ Role: Coordinate implementation with precision │
|
|
133
|
-
│ │
|
|
134
|
-
│ PERSONALIZATION (v3 NEW): │
|
|
135
|
-
│ • Reads .claude/USER_PROFILE.json at startup │
|
|
136
|
-
│ • Adjusts communication level (detailed vs. summary) │
|
|
137
|
-
│ • Matches delegation to team size │
|
|
138
|
-
│ • Respects authority level in decision-making │
|
|
139
|
-
│ • Adapts to learning style when explaining │
|
|
140
|
-
│ │
|
|
141
|
-
│ EXECUTION PATTERN: │
|
|
142
|
-
│ • Parse outline into concrete tasks │
|
|
143
|
-
│ • Delegate to sub-agents in parallel (where possible) │
|
|
144
|
-
│ • Verify outputs against acceptance criteria │
|
|
145
|
-
│ • SECURITY REVIEW IS MANDATORY (no skipping) │
|
|
146
|
-
│ • Update project memory with completion and findings │
|
|
147
|
-
│ │
|
|
148
|
-
│ Creates: Implemented code changes │
|
|
149
|
-
│ Updates: bugs.md, decisions.md, issues.md, .project-memory-state.json │
|
|
150
|
-
│ Reads: execution_brief.md, outline.md, memory, USER_PROFILE.json, codebase │
|
|
151
|
-
│ │
|
|
152
|
-
│ Sub-agents: Code Writer, Test Runner, Code Reviewer, Security Expert, │
|
|
153
|
-
│ Documentation, Research, Specification Writer │
|
|
154
|
-
│ │
|
|
155
|
-
│ Routes to: /intuition-discovery (new feature iteration) │
|
|
156
|
-
└─────────────────────────────────────────────────────────────────────────────┘
|
|
157
|
-
|
|
158
|
-
================================================================================
|
|
159
|
-
PERSISTENT USER PROFILE (v3 NEW)
|
|
160
|
-
================================================================================
|
|
161
|
-
|
|
162
|
-
Location: .claude/USER_PROFILE.json (Global, cross-project)
|
|
163
|
-
|
|
164
|
-
What It Stores:
|
|
165
|
-
• User: name, role, seniority_level, years_experience, organization, reports_to
|
|
166
|
-
• Expertise: primary_skills, expertise_areas, learning_style, learning_goals
|
|
167
|
-
• Communication: style, pace, detail_level, decision_making
|
|
168
|
-
• Constraints: authority_level, availability, team_size, time_zone, tech_environment
|
|
169
|
-
• Motivation: primary_drives, cares_about, professional_goals
|
|
170
|
-
• Preferences: tools_and_frameworks, methodologies, collaboration_tools
|
|
171
|
-
• Metadata: created_at, last_updated, profile_completeness, projects_contributed_to,
|
|
172
|
-
confidence_scores
|
|
173
|
-
|
|
174
|
-
How It Gets Built:
|
|
175
|
-
1. Waldo discovers during dialogue (naturally, not questionnaire)
|
|
176
|
-
2. Stores findings in discovery_output.json > user_profile_learnings
|
|
177
|
-
3. Handoff extracts and merges into .claude/USER_PROFILE.json
|
|
178
|
-
4. Includes confidence scores for each property
|
|
179
|
-
5. Tracks which projects informed profile
|
|
180
|
-
6. Profile builds incrementally across projects and iterations
|
|
181
|
-
|
|
182
|
-
How It's Used:
|
|
183
|
-
• Magellan reads at outlining startup → personalizes outline
|
|
184
|
-
• Faraday reads at execution startup → personalizes execution
|
|
185
|
-
• Start skill (future) can reference for session context
|
|
186
|
-
|
|
187
|
-
Key Property: PERSISTENT & CROSS-PROJECT
|
|
188
|
-
- Built once, used forever
|
|
189
|
-
- Builds on itself with each discovery
|
|
190
|
-
- Never loses information (append-only, confidence-based merge)
|
|
191
|
-
- Clearly distinct from project-specific memory
|
|
192
|
-
|
|
193
|
-
================================================================================
|
|
194
|
-
MEMORY FILE OWNERSHIP
|
|
195
|
-
================================================================================
|
|
196
|
-
|
|
197
|
-
| File | Owner | Created By | Updated By | Purpose |
|
|
198
|
-
|------|-------|-----------|-----------|---------|
|
|
199
|
-
| .project-memory-state.json | Start/Handoff | Initialize | All skills | Workflow state |
|
|
200
|
-
| discovery_brief.md | Waldo | Waldo | Only Waldo | Discovery narrative |
|
|
201
|
-
| discovery_output.json | Waldo | Waldo | Only Waldo | Structured findings |
|
|
202
|
-
| outline_brief.md | Handoff | Handoff | Only Handoff | Context for outlining |
|
|
203
|
-
| outline.md | Magellan | Magellan | Only Magellan | Structured outline |
|
|
204
|
-
| execution_brief.md | Handoff | Handoff | Only Handoff | Context for execution |
|
|
205
|
-
| key_facts.md | Initialize | Initialize | Handoff | Project facts |
|
|
206
|
-
| decisions.md | Initialize | Initialize | Handoff, Faraday | Architectural decisions |
|
|
207
|
-
| issues.md | Initialize | Initialize | Handoff, Faraday | Work history |
|
|
208
|
-
| bugs.md | Initialize | Initialize | Faraday | Problems & solutions |
|
|
209
|
-
| .claude/USER_PROFILE.json | Initialize | Initialize | Handoff | User profile |
|
|
210
|
-
|
|
211
|
-
Golden Rule: Each file has one owner. Only that skill creates/updates it.
|
|
212
|
-
Exception: Handoff coordinates transitions and updates multiple files.
|
|
213
|
-
|
|
214
|
-
================================================================================
|
|
215
|
-
DUAL DIALOGUE MODES (v3 NEW)
|
|
216
|
-
================================================================================
|
|
217
|
-
|
|
218
|
-
GUIDED MODE:
|
|
219
|
-
• AskUserQuestion with 2-4 focused options
|
|
220
|
-
• "Other" always available for custom input
|
|
221
|
-
• Structured but fully flexible
|
|
222
|
-
• User feels guided and supported
|
|
223
|
-
• Good for: Users who like structure and clarity
|
|
224
|
-
|
|
225
|
-
OPEN-ENDED MODE:
|
|
226
|
-
• Conversational questions (no options)
|
|
227
|
-
• User answers however they want
|
|
228
|
-
• Natural rhythm and flow
|
|
229
|
-
• Just as deep and thorough
|
|
230
|
-
• Good for: Users who prefer freedom and spontaneity
|
|
231
|
-
|
|
232
|
-
EQUIVALENCE:
|
|
233
|
-
• Both explore same GAPP dimensions (Problem, Goals, Context, Motivation)
|
|
234
|
-
• Both integrate research insights
|
|
235
|
-
• Both glean user profile information
|
|
236
|
-
• Both achieve same discovery depth
|
|
237
|
-
• ONLY difference: Dialogue style, not substance
|
|
238
|
-
|
|
239
|
-
User Choice: Selected at start of discovery, stored in state, can be changed.
|
|
240
|
-
|
|
241
|
-
================================================================================
|
|
242
|
-
RESEARCH-INFORMED THINKING (v3 NEW)
|
|
243
|
-
================================================================================
|
|
244
|
-
|
|
245
|
-
IMMEDIATE RESEARCH LAUNCH:
|
|
246
|
-
• User describes context
|
|
247
|
-
• Waldo identifies domain
|
|
248
|
-
• Waldo launches 3 research agents in PARALLEL (single message)
|
|
249
|
-
• All agents run simultaneously (not sequentially)
|
|
250
|
-
|
|
251
|
-
RESEARCH AGENTS:
|
|
252
|
-
Agent 1: Best Practices & Standards
|
|
253
|
-
→ Industry standards, proven patterns, best practices
|
|
254
|
-
→ Top 5-10 key practices and why they matter
|
|
255
|
-
|
|
256
|
-
Agent 2: Common Pitfalls & Inefficiencies
|
|
257
|
-
→ What catches teams off-guard
|
|
258
|
-
→ Failure patterns and how to avoid them
|
|
259
|
-
|
|
260
|
-
Agent 3: Emerging Patterns (Optional)
|
|
261
|
-
→ Innovations and new approaches
|
|
262
|
-
→ Trends and cutting-edge practices
|
|
263
|
-
|
|
264
|
-
INTEGRATION INTO DIALOGUE:
|
|
265
|
-
• Research happens while Waldo greets and continues dialogue
|
|
266
|
-
• Research findings inform every follow-up question
|
|
267
|
-
• Insights are natural, not forced
|
|
268
|
-
• Waldo brings perspective without being obvious
|
|
269
|
-
|
|
270
|
-
WISE CONFIDANT MODEL:
|
|
271
|
-
• Waldo isn't neutral - brings relevant knowledge
|
|
272
|
-
• Every question informed by research
|
|
273
|
-
• Never a deluge of facts
|
|
274
|
-
• Collaborative "what do you think about this?" approach
|
|
275
|
-
|
|
276
|
-
================================================================================
|
|
277
|
-
ARCHITECTURE PRINCIPLES
|
|
278
|
-
================================================================================
|
|
279
|
-
|
|
280
|
-
1. SYMPHONY MODEL
|
|
281
|
-
Five distinct roles, each focused on one phase. Clean separation of concerns.
|
|
282
|
-
Waldo doesn't plan. Magellan doesn't execute. Faraday doesn't discover.
|
|
283
|
-
|
|
284
|
-
2. FILE-BASED HANDOFFS
|
|
285
|
-
No APIs. All communication through files.
|
|
286
|
-
Resumable, auditable, tool-agnostic, transparent.
|
|
287
|
-
|
|
288
|
-
3. MEMORY AUTHORITY
|
|
289
|
-
Each file has one owner. Clear responsibility, no conflicts.
|
|
290
|
-
Handoff is exception - coordinates transitions.
|
|
291
|
-
|
|
292
|
-
4. PERSISTENT USER PROFILE
|
|
293
|
-
Global, cross-project, naturally discovered.
|
|
294
|
-
Builds incrementally. Personalizes all subsequent work.
|
|
295
|
-
|
|
296
|
-
5. RESUME SUPPORT
|
|
297
|
-
All skills can resume interrupted work from state.
|
|
298
|
-
Stop anytime. Resume anytime. Files persist.
|
|
299
|
-
|
|
300
|
-
6. STATE-DRIVEN ORCHESTRATION
|
|
301
|
-
.project-memory-state.json is source of truth.
|
|
302
|
-
Each skill reads state before proceeding.
|
|
303
|
-
Handoff updates state during transitions.
|
|
304
|
-
|
|
305
|
-
7. SECURITY GATES
|
|
306
|
-
Faraday's security review is MANDATORY.
|
|
307
|
-
No execution completion without passing security.
|
|
308
|
-
|
|
309
|
-
================================================================================
|
|
310
|
-
TESTING DOCUMENTS
|
|
311
|
-
================================================================================
|
|
312
|
-
|
|
313
|
-
FOUR NEW TESTING DOCUMENTS CREATED:
|
|
314
|
-
|
|
315
|
-
1. TESTING_SUMMARY.md (781 lines)
|
|
316
|
-
• Complete project context and state
|
|
317
|
-
• Major architectural changes explained
|
|
318
|
-
• Testing scope and recommendations
|
|
319
|
-
• Known issues and technical debt
|
|
320
|
-
• Comprehensive foundation for understanding
|
|
321
|
-
|
|
322
|
-
2. SKILL_INTERACTION_GUIDE.md (993 lines)
|
|
323
|
-
• Detailed spec for each of 5 skills
|
|
324
|
-
• Memory ownership chart
|
|
325
|
-
• Data flow diagrams
|
|
326
|
-
• Common workflows
|
|
327
|
-
• Troubleshooting guide
|
|
328
|
-
• File sizes and performance
|
|
329
|
-
|
|
330
|
-
3. QUICK_TEST_CHECKLIST.md (467 lines)
|
|
331
|
-
• Pre-testing validation
|
|
332
|
-
• 11 focused test sessions
|
|
333
|
-
• Edge case testing
|
|
334
|
-
• Success criteria
|
|
335
|
-
• Test report template
|
|
336
|
-
• Tester notes and guidance
|
|
337
|
-
|
|
338
|
-
4. TESTING_README.md (215 lines)
|
|
339
|
-
• Quick navigation guide
|
|
340
|
-
• Testing path (4 phases)
|
|
341
|
-
• Success criteria summary
|
|
342
|
-
• Important notes for testers
|
|
343
|
-
• Document overview table
|
|
344
|
-
|
|
345
|
-
PLUS: ARCHITECTURE_OVERVIEW.txt (this file)
|
|
346
|
-
• Visual ASCII diagrams
|
|
347
|
-
• Quick reference for all systems
|
|
348
|
-
|
|
349
|
-
================================================================================
|
|
350
|
-
READY FOR PRODUCTION TESTING
|
|
351
|
-
================================================================================
|
|
352
|
-
|
|
353
|
-
Version: 3.0.0 (Latest)
|
|
354
|
-
Status: Production Ready
|
|
355
|
-
Last Commit: bbfa9ff (Waldo v3 complete)
|
|
356
|
-
|
|
357
|
-
What's Implemented:
|
|
358
|
-
✅ Waldo v3 redesign (thinking partner model)
|
|
359
|
-
✅ Dual dialogue modes (Guided + Open-Ended)
|
|
360
|
-
✅ Research agent launch (immediate, parallel)
|
|
361
|
-
✅ Persistent user profile system (global)
|
|
362
|
-
✅ Handoff orchestration (explicit phase coordinator)
|
|
363
|
-
✅ Five-skill integration
|
|
364
|
-
✅ Profile reading in Magellan and Faraday
|
|
365
|
-
✅ All memory file updates
|
|
366
|
-
✅ State management with v3 schema
|
|
367
|
-
✅ Resume capability across all phases
|
|
368
|
-
|
|
369
|
-
What to Test:
|
|
370
|
-
• Waldo core features (modes, research, dialogue)
|
|
371
|
-
• Handoff orchestration (transitions, memory updates, profile merge)
|
|
372
|
-
• User profile system (discovery, persistence, merging)
|
|
373
|
-
• Five-skill coordination (full workflows)
|
|
374
|
-
• Resume capability (interrupt and continue)
|
|
375
|
-
• Edge cases (missing files, poor quality, conflicts)
|
|
376
|
-
• Cross-sector testing (different domains)
|
|
377
|
-
• Personalization (Magellan and Faraday reading profile)
|
|
378
|
-
|
|
379
|
-
Documentation Quality:
|
|
380
|
-
• 2,450+ lines of testing documentation created
|
|
381
|
-
• Complete architectural overview
|
|
382
|
-
• Detailed skill specifications
|
|
383
|
-
• Actionable test checklists
|
|
384
|
-
• Troubleshooting guides
|
|
385
|
-
• Reference materials
|
|
386
|
-
|
|
387
|
-
Next Steps:
|
|
388
|
-
1. Read TESTING_SUMMARY.md (start here)
|
|
389
|
-
2. Read SKILL_INTERACTION_GUIDE.md (understand interactions)
|
|
390
|
-
3. Use QUICK_TEST_CHECKLIST.md (execute tests)
|
|
391
|
-
4. Document findings in test report
|
|
392
|
-
5. Make go/no-go decision
|
|
393
|
-
|
|
394
|
-
================================================================================
|
|
395
|
-
|
|
396
|
-
This architecture represents a significant upgrade from v2. All major components
|
|
397
|
-
are implemented and documented. The system is ready for production testing.
|
|
398
|
-
|
|
399
|
-
Ready to test? Start with TESTING_SUMMARY.md.
|
|
400
|
-
Questions? Check SKILL_INTERACTION_GUIDE.md.
|
|
401
|
-
Testing? Use QUICK_TEST_CHECKLIST.md.
|
|
402
|
-
|
|
403
|
-
Let's ship it!
|
|
404
|
-
|
|
405
|
-
================================================================================
|