@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.
Files changed (131) hide show
  1. package/package.json +1 -2
  2. package/skills/intuition-enuncia-compose/SKILL.md +5 -10
  3. package/skills/intuition-enuncia-design/SKILL.md +0 -4
  4. package/skills/intuition-enuncia-discovery/SKILL.md +1 -7
  5. package/skills/intuition-enuncia-execute/SKILL.md +0 -4
  6. package/skills/intuition-enuncia-handoff/SKILL.md +0 -4
  7. package/skills/intuition-enuncia-initialize/references/claude_template.md +20 -0
  8. package/skills/intuition-enuncia-start/SKILL.md +0 -4
  9. package/skills/intuition-enuncia-verify/SKILL.md +0 -4
  10. package/docs/archive/ARCHITECTURE_OVERVIEW.txt +0 -405
  11. package/docs/archive/INSTALLATION.md +0 -431
  12. package/docs/archive/PROJECT_CONTEXT.md +0 -361
  13. package/docs/archive/QUICK_TEST_CHECKLIST.md +0 -467
  14. package/docs/archive/SKILL_INTERACTION_GUIDE.md +0 -993
  15. package/docs/archive/TESTING_README.md +0 -215
  16. package/docs/archive/TESTING_SUMMARY.md +0 -781
  17. package/docs/archive/WALDO_V3_COMPLETE_DOCUMENTATION.md +0 -538
  18. package/docs/archive/WALDO_V3_DESIGN_SUMMARY.md +0 -449
  19. package/docs/archive/intuition-architecture.md +0 -342
  20. package/docs/archive/intuition-workflow.md +0 -210
  21. package/docs/archive/intuition_design_skill_spec.md +0 -219
  22. package/docs/archive/v7_design_spec.md +0 -1111
  23. package/docs/archive/v7_plan.md +0 -339
  24. package/docs/archive/v9-design/decision-framework-direction.md +0 -142
  25. package/docs/archive/v9-design/decision-framework-implementation.md +0 -114
  26. package/docs/archive/v9-design/domain-adaptive-team-architecture.md +0 -1016
  27. package/docs/archive/v9-test/SESSION_SUMMARY.md +0 -117
  28. package/docs/archive/v9-test/TEST_PLAN.md +0 -119
  29. package/docs/archive/v9-test/blueprints/legal-analyst.md +0 -166
  30. package/docs/archive/v9-test/output/07_cover_letter.md +0 -41
  31. package/docs/archive/v9-test/phase2/mock_plan.md +0 -89
  32. package/docs/archive/v9-test/phase2/producers.json +0 -32
  33. package/docs/archive/v9-test/phase2/specialists/database-architect.specialist.md +0 -10
  34. package/docs/archive/v9-test/phase2/specialists/financial-analyst.specialist.md +0 -10
  35. package/docs/archive/v9-test/phase2/specialists/legal-analyst.specialist.md +0 -10
  36. package/docs/archive/v9-test/phase2/specialists/technical-writer.specialist.md +0 -10
  37. package/docs/archive/v9-test/phase2/team_assignment.json +0 -61
  38. package/docs/archive/v9-test/phase3/blueprints/legal-analyst.md +0 -840
  39. package/docs/archive/v9-test/phase3/legal-analyst-full.specialist.md +0 -111
  40. package/docs/archive/v9-test/phase3/project_context/nh_landlord_tenant_notes.md +0 -35
  41. package/docs/archive/v9-test/phase3/project_context/property_facts.md +0 -32
  42. package/docs/archive/v9-test/phase3b/blueprints/legal-analyst.md +0 -1715
  43. package/docs/archive/v9-test/phase3b/legal-analyst.specialist.md +0 -153
  44. package/docs/archive/v9-test/phase3b/scratch/legal-analyst-stage1.md +0 -270
  45. package/docs/archive/v9-test/phase4/TEST_PLAN.md +0 -32
  46. package/docs/archive/v9-test/phase4/blueprints/financial-analyst-T2.md +0 -538
  47. package/docs/archive/v9-test/phase4/blueprints/legal-analyst-T4.md +0 -253
  48. package/docs/archive/v9-test/phase4/cross-blueprint-check.md +0 -280
  49. package/docs/archive/v9-test/phase4/scratch/financial-analyst-T2-stage1.md +0 -67
  50. package/docs/archive/v9-test/phase4/scratch/legal-analyst-T4-stage1.md +0 -54
  51. package/docs/archive/v9-test/phase4/specialists/financial-analyst.specialist.md +0 -156
  52. package/docs/archive/v9-test/phase4/specialists/legal-analyst.specialist.md +0 -153
  53. package/docs/archive/v9-test/phase5/TEST_PLAN.md +0 -35
  54. package/docs/archive/v9-test/phase5/blueprints/code-architect-hw-vetter.md +0 -375
  55. package/docs/archive/v9-test/phase5/output/04_compliance_checklist.md +0 -149
  56. package/docs/archive/v9-test/phase5/output/hardware-vetter-SKILL-v2.md +0 -561
  57. package/docs/archive/v9-test/phase5/output/hardware-vetter-SKILL.md +0 -459
  58. package/docs/archive/v9-test/phase5/producers/code-writer.producer.md +0 -49
  59. package/docs/archive/v9-test/phase5/producers/document-writer.producer.md +0 -62
  60. package/docs/archive/v9-test/phase5/regression-comparison-v2.md +0 -60
  61. package/docs/archive/v9-test/phase5/regression-comparison.md +0 -197
  62. package/docs/archive/v9-test/phase5/review-5A-specialist.md +0 -213
  63. package/docs/archive/v9-test/phase5/specialist-test/TEST_PLAN.md +0 -60
  64. package/docs/archive/v9-test/phase5/specialist-test/blueprint-comparison.md +0 -252
  65. package/docs/archive/v9-test/phase5/specialist-test/blueprints/code-architect-hw-vetter.md +0 -916
  66. package/docs/archive/v9-test/phase5/specialist-test/scratch/code-architect-stage1.md +0 -427
  67. package/docs/archive/v9-test/phase5/specialists/code-architect.specialist.md +0 -168
  68. package/docs/archive/v9-test/phase5b/TEST_PLAN.md +0 -219
  69. package/docs/archive/v9-test/phase5b/blueprints/5B-10-stage2-with-decisions.md +0 -286
  70. package/docs/archive/v9-test/phase5b/decisions/5B-2-accept-all-decisions.json +0 -68
  71. package/docs/archive/v9-test/phase5b/decisions/5B-3-promote-decisions.json +0 -70
  72. package/docs/archive/v9-test/phase5b/decisions/5B-4-individual-decisions.json +0 -68
  73. package/docs/archive/v9-test/phase5b/decisions/5B-5-triage-decisions.json +0 -110
  74. package/docs/archive/v9-test/phase5b/decisions/5B-6-fallback-decisions.json +0 -40
  75. package/docs/archive/v9-test/phase5b/decisions/5B-8-partial-decisions.json +0 -46
  76. package/docs/archive/v9-test/phase5b/decisions/5B-9-complete-decisions.json +0 -54
  77. package/docs/archive/v9-test/phase5b/scratch/code-architect-stage1.md +0 -133
  78. package/docs/archive/v9-test/phase5b/specialists/code-architect.specialist.md +0 -202
  79. package/docs/archive/v9-test/phase5b/stage1-many-decisions.md +0 -139
  80. package/docs/archive/v9-test/phase5b/stage1-no-assumptions.md +0 -70
  81. package/docs/archive/v9-test/phase5b/stage1-with-assumptions.md +0 -86
  82. package/docs/archive/v9-test/phase5b/test-5B-1-results.md +0 -157
  83. package/docs/archive/v9-test/phase5b/test-5B-10-results.md +0 -130
  84. package/docs/archive/v9-test/phase5b/test-5B-2-results.md +0 -75
  85. package/docs/archive/v9-test/phase5b/test-5B-3-results.md +0 -104
  86. package/docs/archive/v9-test/phase5b/test-5B-4-results.md +0 -114
  87. package/docs/archive/v9-test/phase5b/test-5B-5-results.md +0 -126
  88. package/docs/archive/v9-test/phase5b/test-5B-6-results.md +0 -60
  89. package/docs/archive/v9-test/phase5b/test-5B-7-results.md +0 -141
  90. package/docs/archive/v9-test/phase5b/test-5B-8-results.md +0 -115
  91. package/docs/archive/v9-test/phase5b/test-5B-9-results.md +0 -76
  92. package/docs/archive/v9-test/producers/document-writer.producer.md +0 -62
  93. package/docs/archive/v9-test/specialists/legal-analyst.specialist.md +0 -58
  94. package/docs/project_notes/.project-memory-state.json +0 -100
  95. package/docs/project_notes/archive/trunk-v9.2-complete/.gitkeep +0 -0
  96. package/docs/project_notes/archive/trunk-v9.2-complete/.planning_research/decision_file_naming.md +0 -15
  97. package/docs/project_notes/archive/trunk-v9.2-complete/.planning_research/decisions_log.md +0 -32
  98. package/docs/project_notes/archive/trunk-v9.2-complete/.planning_research/orientation.md +0 -51
  99. package/docs/project_notes/archive/trunk-v9.2-complete/audit/plan-rename-hitlist.md +0 -654
  100. package/docs/project_notes/archive/trunk-v9.2-complete/blueprint-conflicts.md +0 -109
  101. package/docs/project_notes/archive/trunk-v9.2-complete/blueprints/database-architect.md +0 -416
  102. package/docs/project_notes/archive/trunk-v9.2-complete/blueprints/devops-infrastructure.md +0 -514
  103. package/docs/project_notes/archive/trunk-v9.2-complete/blueprints/technical-writer.md +0 -788
  104. package/docs/project_notes/archive/trunk-v9.2-complete/build_brief.md +0 -119
  105. package/docs/project_notes/archive/trunk-v9.2-complete/build_report.md +0 -250
  106. package/docs/project_notes/archive/trunk-v9.2-complete/detail_brief.md +0 -94
  107. package/docs/project_notes/archive/trunk-v9.2-complete/plan.md +0 -182
  108. package/docs/project_notes/archive/trunk-v9.2-complete/planning_brief.md +0 -96
  109. package/docs/project_notes/archive/trunk-v9.2-complete/prompt_brief.md +0 -60
  110. package/docs/project_notes/archive/trunk-v9.2-complete/prompt_output.json +0 -98
  111. package/docs/project_notes/archive/trunk-v9.2-complete/scratch/database-architect-decisions.json +0 -72
  112. package/docs/project_notes/archive/trunk-v9.2-complete/scratch/database-architect-research-plan.md +0 -10
  113. package/docs/project_notes/archive/trunk-v9.2-complete/scratch/database-architect-stage1.md +0 -226
  114. package/docs/project_notes/archive/trunk-v9.2-complete/scratch/devops-infrastructure-decisions.json +0 -71
  115. package/docs/project_notes/archive/trunk-v9.2-complete/scratch/devops-infrastructure-research-plan.md +0 -7
  116. package/docs/project_notes/archive/trunk-v9.2-complete/scratch/devops-infrastructure-stage1.md +0 -164
  117. package/docs/project_notes/archive/trunk-v9.2-complete/scratch/technical-writer-decisions.json +0 -88
  118. package/docs/project_notes/archive/trunk-v9.2-complete/scratch/technical-writer-research-plan.md +0 -7
  119. package/docs/project_notes/archive/trunk-v9.2-complete/scratch/technical-writer-stage1.md +0 -266
  120. package/docs/project_notes/archive/trunk-v9.2-complete/team_assignment.json +0 -108
  121. package/docs/project_notes/archive/trunk-v9.2-complete/test_brief.md +0 -75
  122. package/docs/project_notes/archive/trunk-v9.2-complete/test_report.md +0 -26
  123. package/docs/project_notes/archive/trunk-v9.2-complete/verification/devops-infrastructure-verification.md +0 -172
  124. package/docs/project_notes/branches/.gitkeep +0 -0
  125. package/docs/project_notes/bugs.md +0 -41
  126. package/docs/project_notes/decisions.md +0 -147
  127. package/docs/project_notes/issues.md +0 -101
  128. package/docs/project_notes/key_facts.md +0 -88
  129. package/docs/project_notes/trunk/.gitkeep +0 -0
  130. package/docs/project_notes/trunk/discovery_brief.md +0 -40
  131. 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.4.0",
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 NOT open a response with a compliment or filler.
28
- 6. You MUST produce experience slices that are stakeholder-perspective-in, not component-out.
29
- 7. 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.
30
- 8. You MUST write `tasks.json`, `docs/project_notes/project_map.md`, and update state before routing.
31
- 9. You MUST route to `/intuition-enuncia-design`. NEVER to `/intuition-enuncia-handoff`.
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 open a response with a compliment or filler. Show you heard them through substance. Do NOT restate what the user just said back to them — only recap when you are sharpening or reframing their words into something more precise.
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
- ================================================================================