@trespies-source/dojo-genesis-plugin 1.0.0

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 (209) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/LICENSE +21 -0
  3. package/README.md +204 -0
  4. package/dist/hooks/after-tool-call/handler.d.ts +4 -0
  5. package/dist/hooks/after-tool-call/handler.d.ts.map +1 -0
  6. package/dist/hooks/after-tool-call/handler.js +37 -0
  7. package/dist/hooks/after-tool-call/handler.js.map +1 -0
  8. package/dist/hooks/agent-end/handler.d.ts +4 -0
  9. package/dist/hooks/agent-end/handler.d.ts.map +1 -0
  10. package/dist/hooks/agent-end/handler.js +16 -0
  11. package/dist/hooks/agent-end/handler.js.map +1 -0
  12. package/dist/hooks/before-agent-start/handler.d.ts +4 -0
  13. package/dist/hooks/before-agent-start/handler.d.ts.map +1 -0
  14. package/dist/hooks/before-agent-start/handler.js +81 -0
  15. package/dist/hooks/before-agent-start/handler.js.map +1 -0
  16. package/dist/index.d.ts +18 -0
  17. package/dist/index.d.ts.map +1 -0
  18. package/dist/index.js +35 -0
  19. package/dist/index.js.map +1 -0
  20. package/dist/src/commands/archive.d.ts +4 -0
  21. package/dist/src/commands/archive.d.ts.map +1 -0
  22. package/dist/src/commands/archive.js +20 -0
  23. package/dist/src/commands/archive.js.map +1 -0
  24. package/dist/src/commands/init.d.ts +4 -0
  25. package/dist/src/commands/init.d.ts.map +1 -0
  26. package/dist/src/commands/init.js +57 -0
  27. package/dist/src/commands/init.js.map +1 -0
  28. package/dist/src/commands/list.d.ts +4 -0
  29. package/dist/src/commands/list.d.ts.map +1 -0
  30. package/dist/src/commands/list.js +9 -0
  31. package/dist/src/commands/list.js.map +1 -0
  32. package/dist/src/commands/router.d.ts +3 -0
  33. package/dist/src/commands/router.d.ts.map +1 -0
  34. package/dist/src/commands/router.js +83 -0
  35. package/dist/src/commands/router.js.map +1 -0
  36. package/dist/src/commands/skill-invoke.d.ts +4 -0
  37. package/dist/src/commands/skill-invoke.d.ts.map +1 -0
  38. package/dist/src/commands/skill-invoke.js +26 -0
  39. package/dist/src/commands/skill-invoke.js.map +1 -0
  40. package/dist/src/commands/status.d.ts +4 -0
  41. package/dist/src/commands/status.d.ts.map +1 -0
  42. package/dist/src/commands/status.js +42 -0
  43. package/dist/src/commands/status.js.map +1 -0
  44. package/dist/src/commands/switch.d.ts +4 -0
  45. package/dist/src/commands/switch.d.ts.map +1 -0
  46. package/dist/src/commands/switch.js +20 -0
  47. package/dist/src/commands/switch.js.map +1 -0
  48. package/dist/src/orchestration/tool-registry.d.ts +18 -0
  49. package/dist/src/orchestration/tool-registry.d.ts.map +1 -0
  50. package/dist/src/orchestration/tool-registry.js +153 -0
  51. package/dist/src/orchestration/tool-registry.js.map +1 -0
  52. package/dist/src/skills/catalog.d.ts +9 -0
  53. package/dist/src/skills/catalog.d.ts.map +1 -0
  54. package/dist/src/skills/catalog.js +251 -0
  55. package/dist/src/skills/catalog.js.map +1 -0
  56. package/dist/src/state/manager.d.ts +19 -0
  57. package/dist/src/state/manager.d.ts.map +1 -0
  58. package/dist/src/state/manager.js +114 -0
  59. package/dist/src/state/manager.js.map +1 -0
  60. package/dist/src/state/migrations.d.ts +3 -0
  61. package/dist/src/state/migrations.d.ts.map +1 -0
  62. package/dist/src/state/migrations.js +8 -0
  63. package/dist/src/state/migrations.js.map +1 -0
  64. package/dist/src/state/types.d.ts +62 -0
  65. package/dist/src/state/types.d.ts.map +1 -0
  66. package/dist/src/state/types.js +2 -0
  67. package/dist/src/state/types.js.map +1 -0
  68. package/dist/src/ui/chat-formatter.d.ts +11 -0
  69. package/dist/src/ui/chat-formatter.d.ts.map +1 -0
  70. package/dist/src/ui/chat-formatter.js +39 -0
  71. package/dist/src/ui/chat-formatter.js.map +1 -0
  72. package/dist/src/utils/file-ops.d.ts +6 -0
  73. package/dist/src/utils/file-ops.d.ts.map +1 -0
  74. package/dist/src/utils/file-ops.js +38 -0
  75. package/dist/src/utils/file-ops.js.map +1 -0
  76. package/dist/src/utils/markdown.d.ts +2 -0
  77. package/dist/src/utils/markdown.d.ts.map +1 -0
  78. package/dist/src/utils/markdown.js +11 -0
  79. package/dist/src/utils/markdown.js.map +1 -0
  80. package/dist/src/utils/validation.d.ts +7 -0
  81. package/dist/src/utils/validation.d.ts.map +1 -0
  82. package/dist/src/utils/validation.js +29 -0
  83. package/dist/src/utils/validation.js.map +1 -0
  84. package/dist/tests/__mocks__/openclaw-types.d.ts +54 -0
  85. package/dist/tests/__mocks__/openclaw-types.d.ts.map +1 -0
  86. package/dist/tests/__mocks__/openclaw-types.js +29 -0
  87. package/dist/tests/__mocks__/openclaw-types.js.map +1 -0
  88. package/hooks/after-tool-call/HOOK.md +7 -0
  89. package/hooks/after-tool-call/handler.ts +41 -0
  90. package/hooks/agent-end/HOOK.md +7 -0
  91. package/hooks/agent-end/handler.ts +18 -0
  92. package/hooks/before-agent-start/HOOK.md +7 -0
  93. package/hooks/before-agent-start/handler.ts +133 -0
  94. package/openclaw.plugin.json +19 -0
  95. package/package.json +61 -0
  96. package/skills/agent-teaching/SKILL.md +583 -0
  97. package/skills/agent-teaching/claw.json +12 -0
  98. package/skills/compression-ritual/SKILL.md +136 -0
  99. package/skills/compression-ritual/claw.json +12 -0
  100. package/skills/context-ingestion/SKILL.md +109 -0
  101. package/skills/context-ingestion/claw.json +12 -0
  102. package/skills/decision-propagation/SKILL.md +130 -0
  103. package/skills/decision-propagation/claw.json +12 -0
  104. package/skills/documentation-audit/SKILL.md +146 -0
  105. package/skills/documentation-audit/claw.json +12 -0
  106. package/skills/era-architecture/SKILL.md +166 -0
  107. package/skills/era-architecture/claw.json +12 -0
  108. package/skills/file-management/SKILL.md +127 -0
  109. package/skills/file-management/claw.json +12 -0
  110. package/skills/frontend-from-backend/SKILL.md +127 -0
  111. package/skills/frontend-from-backend/claw.json +12 -0
  112. package/skills/handoff-protocol/SKILL.md +168 -0
  113. package/skills/handoff-protocol/claw.json +12 -0
  114. package/skills/health-audit/SKILL.md +123 -0
  115. package/skills/health-audit/claw.json +12 -0
  116. package/skills/implementation-prompt/SKILL.md +361 -0
  117. package/skills/implementation-prompt/claw.json +12 -0
  118. package/skills/iterative-scouting/SKILL.md +106 -0
  119. package/skills/iterative-scouting/claw.json +12 -0
  120. package/skills/memory-garden/SKILL.md +470 -0
  121. package/skills/memory-garden/claw.json +12 -0
  122. package/skills/multi-surface-strategy/SKILL.md +288 -0
  123. package/skills/multi-surface-strategy/claw.json +12 -0
  124. package/skills/parallel-tracks/SKILL.md +152 -0
  125. package/skills/parallel-tracks/claw.json +12 -0
  126. package/skills/patient-learning-protocol/SKILL.md +438 -0
  127. package/skills/patient-learning-protocol/claw.json +12 -0
  128. package/skills/planning-with-files/SKILL.md +139 -0
  129. package/skills/planning-with-files/claw.json +12 -0
  130. package/skills/pre-implementation-checklist/SKILL.md +156 -0
  131. package/skills/pre-implementation-checklist/claw.json +12 -0
  132. package/skills/process-extraction/SKILL.md +148 -0
  133. package/skills/process-extraction/claw.json +12 -0
  134. package/skills/process-extraction/references/process_example_template.md +40 -0
  135. package/skills/product-positioning/SKILL.md +293 -0
  136. package/skills/product-positioning/claw.json +12 -0
  137. package/skills/project-exploration/SKILL.md +168 -0
  138. package/skills/project-exploration/claw.json +12 -0
  139. package/skills/release-specification/SKILL.md +645 -0
  140. package/skills/release-specification/claw.json +12 -0
  141. package/skills/repo-context-sync/SKILL.md +362 -0
  142. package/skills/repo-context-sync/claw.json +12 -0
  143. package/skills/repo-context-sync/references/file_hierarchy_patterns.md +186 -0
  144. package/skills/repo-context-sync/references/zenflow_repo_patterns.md +328 -0
  145. package/skills/repo-context-sync/scripts/context_mapper.py +251 -0
  146. package/skills/repo-context-sync/scripts/diff_tracker.py +187 -0
  147. package/skills/repo-context-sync/scripts/smart_clone.sh +52 -0
  148. package/skills/repo-context-sync/templates/context_summary.md +58 -0
  149. package/skills/repo-status/SKILL.md +240 -0
  150. package/skills/repo-status/claw.json +12 -0
  151. package/skills/repo-status/references/semantic-clusters.md +159 -0
  152. package/skills/repo-status/references/status-template.md +214 -0
  153. package/skills/research-modes/SKILL.md +515 -0
  154. package/skills/research-modes/claw.json +12 -0
  155. package/skills/research-synthesis/SKILL.md +110 -0
  156. package/skills/research-synthesis/claw.json +12 -0
  157. package/skills/retrospective/SKILL.md +152 -0
  158. package/skills/retrospective/claw.json +12 -0
  159. package/skills/seed-extraction/SKILL.md +419 -0
  160. package/skills/seed-extraction/claw.json +12 -0
  161. package/skills/seed-library/SKILL.md +424 -0
  162. package/skills/seed-library/claw.json +12 -0
  163. package/skills/seed-library/references/seed_catalog.md +171 -0
  164. package/skills/seed-library/scripts/apply_seed.py +129 -0
  165. package/skills/seed-library/scripts/suggest_seeds.py +183 -0
  166. package/skills/seed-library/seeds/01_three_tiered_governance.md +90 -0
  167. package/skills/seed-library/seeds/02_harness_trace.md +135 -0
  168. package/skills/seed-library/seeds/03_context_iceberg.md +120 -0
  169. package/skills/seed-library/seeds/04_agent_connect.md +106 -0
  170. package/skills/seed-library/seeds/05_go_live_bundles.md +40 -0
  171. package/skills/seed-library/seeds/06_cost_guard.md +40 -0
  172. package/skills/seed-library/seeds/07_safety_switch.md +41 -0
  173. package/skills/seed-library/seeds/08_implicit_perspective_extraction.md +41 -0
  174. package/skills/seed-library/seeds/09_mode_based_complexity_gating.md +46 -0
  175. package/skills/seed-library/seeds/10_shared_infrastructure.md +75 -0
  176. package/skills/seed-library/seeds/11_voice_before_structure.md +74 -0
  177. package/skills/seed-library/seeds/12_pointer_directories.md +81 -0
  178. package/skills/seed-library/seeds/13_granular_visibility.md +82 -0
  179. package/skills/seed-library/seeds/meta_governance_multiplies_velocity.md +43 -0
  180. package/skills/seed-to-skill-converter/SKILL.md +113 -0
  181. package/skills/seed-to-skill-converter/claw.json +12 -0
  182. package/skills/semantic-clusters/SKILL.md +246 -0
  183. package/skills/semantic-clusters/claw.json +12 -0
  184. package/skills/semantic-clusters/references/verb-catalog.md +267 -0
  185. package/skills/skill-audit-upgrade/SKILL.md +427 -0
  186. package/skills/skill-audit-upgrade/claw.json +12 -0
  187. package/skills/skill-creation/LICENSE.txt +202 -0
  188. package/skills/skill-creation/SKILL.md +252 -0
  189. package/skills/skill-creation/claw.json +12 -0
  190. package/skills/skill-creation/references/output-patterns.md +82 -0
  191. package/skills/skill-creation/references/progressive-disclosure-patterns.md +79 -0
  192. package/skills/skill-creation/references/workflows.md +28 -0
  193. package/skills/skill-creation/scripts/init_skill.py +305 -0
  194. package/skills/skill-creation/scripts/quick_validate.py +134 -0
  195. package/skills/skill-maintenance/SKILL.md +413 -0
  196. package/skills/skill-maintenance/claw.json +12 -0
  197. package/skills/spec-constellation-to-prompt-suite/SKILL.md +174 -0
  198. package/skills/spec-constellation-to-prompt-suite/claw.json +12 -0
  199. package/skills/status-template/SKILL.md +211 -0
  200. package/skills/status-template/claw.json +12 -0
  201. package/skills/status-template/references/complete-template.md +191 -0
  202. package/skills/status-writing/SKILL.md +161 -0
  203. package/skills/status-writing/claw.json +12 -0
  204. package/skills/strategic-scout/SKILL.md +163 -0
  205. package/skills/strategic-scout/claw.json +12 -0
  206. package/skills/strategic-to-tactical-workflow/SKILL.md +391 -0
  207. package/skills/strategic-to-tactical-workflow/claw.json +12 -0
  208. package/skills/workspace-navigation/SKILL.md +622 -0
  209. package/skills/workspace-navigation/claw.json +12 -0
@@ -0,0 +1,106 @@
1
+ ---
2
+ seed_id: 04
3
+ name: Agent Connect
4
+ version: 1.0
5
+ created: 2026-01-12
6
+ source: Dataiku Research
7
+ status: active
8
+ ---
9
+
10
+ # Agent Connect (Routing-First, Not Swarm-First)
11
+
12
+ ## What It Is
13
+
14
+ A central hub for managing interactions with multiple agents, handling routing, permissions, and task handoff from a single entry point.
15
+
16
+ ## Why It Matters
17
+
18
+ "Agent sprawl" creates a patchwork of disconnected tools that no one can fully monitor or govern. Users don't need to know which agent does what—they just ask, and the right agent responds.
19
+
20
+ ## The Pattern
21
+
22
+ ### Single Entry Point
23
+ Users interact with one interface (the Supervisor).
24
+
25
+ ### Routing Logic
26
+ Behind the scenes, route to the right agent based on:
27
+ - Context (what is the user asking?)
28
+ - User role and permissions
29
+ - Task complexity
30
+ - Agent availability
31
+
32
+ ### Task Handoff
33
+ Agents can hand off to other agents when needed:
34
+ - Dojo → Librarian (retrieve seed modules)
35
+ - Dojo → Debugger (resolve conflicts)
36
+ - Dojo → Builder (execute code)
37
+
38
+ ### Permission Management
39
+ Leverage existing permission systems:
40
+ - Groups, projects, workspaces
41
+ - Agents access only what the user has access to
42
+
43
+ ### Prevent Sprawl
44
+ Centralized console for IT to deploy and route all agents.
45
+
46
+ ## Revisit Trigger
47
+
48
+ When adding new specialized agents (Librarian, Debugger, Referee) or coordinating multi-agent workflows.
49
+
50
+ ## Dojo Application
51
+
52
+ ### Supervisor as Router
53
+ - **Single entry point:** User talks to Supervisor
54
+ - **Routing logic:** Supervisor routes to Dojo, Librarian, Debugger, Builder
55
+ - **Transparent handoff:** "Routing to Librarian to retrieve seed modules..."
56
+
57
+ ### Mode-Based Routing (Within Dojo)
58
+ - **Mirror:** Simple reflection, minimal context
59
+ - **Scout:** Explore routes, recommend paths
60
+ - **Gardener:** Identify strong ideas, prune weak ones
61
+ - **Implementation:** Generate concrete next steps
62
+
63
+ ### Agent Roster
64
+ - **Dojo Agent:** Core thinking partnership (Mirror/Scout/Gardener/Implementation)
65
+ - **Librarian Agent:** Semantic search and retrieval from knowledge base
66
+ - **Debugger Agent:** Resolve conflicting perspectives or logical errors
67
+ - **Builder Agent:** Code generation and execution
68
+
69
+ ### Permission Inheritance
70
+ Agents access only what the user has access to:
71
+ - Google Drive files
72
+ - GitHub repositories
73
+ - Project memory
74
+
75
+ ## What It Refuses
76
+
77
+ Multi-agent swarm where every agent talks to every other agent (coordination complexity explodes).
78
+
79
+ ## Usage Examples
80
+
81
+ ### Example 1: User Asks "What's the DojoPacket schema?"
82
+ **Routing:** Supervisor → Librarian (retrieve schema) → Dojo (explain)
83
+ **Result:** User gets answer without knowing which agents were involved
84
+
85
+ ### Example 2: User Asks "How should we architect the Workbench?"
86
+ **Routing:** Supervisor → Dojo (Scout mode) → analyze routes → recommend
87
+ **Result:** Dojo provides architectural guidance
88
+
89
+ ### Example 3: User Asks "These perspectives conflict"
90
+ **Routing:** Supervisor → Debugger → resolve conflict → Dojo (present resolution)
91
+ **Result:** Conflict resolved transparently
92
+
93
+ ## Checks
94
+
95
+ - [ ] Single entry point exists (Supervisor)
96
+ - [ ] Routing logic is explicit and documented
97
+ - [ ] Agents can hand off to other agents
98
+ - [ ] Permissions are inherited from user
99
+ - [ ] Handoffs are transparent to user
100
+ - [ ] No agent-to-agent sprawl (all routing through Supervisor)
101
+
102
+ ## Related Seeds
103
+
104
+ - **Seed 01 (Three-Tiered Governance):** Tactical tier defines routing logic
105
+ - **Seed 10 (Shared Infrastructure):** Routing logic is shared infrastructure
106
+ - **Seed 09 (Mode-Based Complexity Gating):** Routing within Dojo uses mode selection
@@ -0,0 +1,40 @@
1
+ ---
2
+ seed_id: 05
3
+ name: Go-Live Bundles
4
+ version: 1.0
5
+ created: 2026-01-12
6
+ source: Dataiku Research
7
+ status: active
8
+ ---
9
+
10
+ # Go-Live Bundles (Reusable Artifacts)
11
+
12
+ ## What It Is
13
+ Lightweight packages that pair technical artifacts with approval evidence, stored centrally for reuse across similar projects.
14
+
15
+ ## Why It Matters
16
+ Teams spend less time renegotiating approvals when trust is embedded in reusable artifacts.
17
+
18
+ ## The Pattern
19
+ - Bundle contents: Project standards, test results, version rollback plans, approval sign-off, lineage, trace logs
20
+ - Central storage: Reviewers know exactly where to look
21
+ - Reuse: Similar projects reuse bundles without starting governance from scratch
22
+
23
+ ## Revisit Trigger
24
+ When exporting Dojo sessions, sharing work across projects, or building trust through repeatability.
25
+
26
+ ## Dojo Application
27
+ - **DojoPacket Schema:** Standardized export format containing perspectives, mode, artifacts, next move, harness trace
28
+ - **Seed Modules:** Reusable thinking modules with triggers and checks
29
+ - **Workbench Storage:** Central hub for all DojoPackets, accessible across sessions
30
+ - **Copy-Paste Memory Patch:** Compact format for transferring context between sessions
31
+
32
+ ## What It Refuses
33
+ One-off sessions that can't be inspected, reused, or learned from.
34
+
35
+ ## Checks
36
+ - [ ] DojoPacket schema is defined and versioned
37
+ - [ ] Sessions are exportable
38
+ - [ ] Exports include trace logs for transparency
39
+ - [ ] Central storage exists (Workbench)
40
+ - [ ] Reuse is encouraged and tracked
@@ -0,0 +1,40 @@
1
+ ---
2
+ seed_id: 06
3
+ name: Cost Guard
4
+ version: 1.0
5
+ created: 2026-01-12
6
+ source: Dataiku Research
7
+ status: active
8
+ ---
9
+
10
+ # Cost Guard (Budget for the Full Iceberg)
11
+
12
+ ## What It Is
13
+ A comprehensive approach to cost management that accounts for system complexity, context explosion, error handling, validation, integration, oversight, and scope expansion—not just API bills.
14
+
15
+ ## Why It Matters
16
+ "Your API bill is just 10% to 20% of your real AI costs." Production costs are 5-10x pilot costs. This isn't failure—it's the cost of reliability, security, scalability, and usefulness.
17
+
18
+ ## The Pattern
19
+ - **Seven hidden layers:** System complexity, context explosion, error handling, validation overhead, integration complexity, human oversight, scope expansion
20
+ - **Budget multiplier:** 5-10x from pilot to production
21
+ - **Strategies:** Start with hardest scenario, build shared infrastructure, make validation efficient, plan for deliberate expansion
22
+
23
+ ## Revisit Trigger
24
+ When planning new features, estimating costs, or justifying infrastructure investments.
25
+
26
+ ## Dojo Application
27
+ - **Token budgeting:** Warning at 80%, hard stop at 100%, offer to export and start new session
28
+ - **Cost estimation:** Show user estimated token usage before running Scout mode
29
+ - **Usage metadata tracking:** Track tokens/cost per mode, roll up to session level
30
+ - **Cost-aware mode selection:** If budget low, prefer Mirror over Scout; if ample, use full capabilities
31
+
32
+ ## What It Refuses
33
+ Simple mental models that assume AI costs = API bills.
34
+
35
+ ## Checks
36
+ - [ ] Budget accounts for 5-10x multiplier (not just API costs)
37
+ - [ ] Token usage is tracked per session
38
+ - [ ] Users are warned before hitting limits
39
+ - [ ] Cost estimation is shown before expensive operations
40
+ - [ ] Mode selection considers budget constraints
@@ -0,0 +1,41 @@
1
+ ---
2
+ seed_id: 07
3
+ name: Safety Switch
4
+ version: 1.0
5
+ created: 2026-01-12
6
+ source: Dataiku Research
7
+ status: active
8
+ ---
9
+
10
+ # Safety Switch (Fallback to Conservative Mode)
11
+
12
+ ## What It Is
13
+ An automated pattern where the system forces fallback to a conservative operating mode and alerts the user when real-time data drifts outside tolerance.
14
+
15
+ ## Why It Matters
16
+ Most failures start small. A prompt tweak siphons tokens, or an embedding model upgrade shifts outputs. Builder-level controls catch these changes before they propagate.
17
+
18
+ ## The Pattern
19
+ - **Trigger:** Real-time monitoring detects drift outside tolerance band
20
+ - **Action:** Automatically fall back to conservative mode
21
+ - **Alert:** Ping user through appropriate channel (Slack, Teams, or in-app)
22
+ - **Recovery:** User reviews, adjusts, and re-enables full mode
23
+
24
+ ## Revisit Trigger
25
+ When context approaching limit, perspectives conflict, or output feels like "smart fog."
26
+
27
+ ## Dojo Application
28
+ - **Context drift:** If context window > 95% → prune and alert
29
+ - **Perspective conflict:** If perspectives contradict → enter Debugger mode
30
+ - **Output validation:** If output doesn't match expected artifact type → trigger "Press to Reality" module
31
+ - **Cost overrun:** If session cost approaching budget → alert and suggest pruning
32
+
33
+ ## What It Refuses
34
+ Silent failures that compound without user awareness.
35
+
36
+ ## Checks
37
+ - [ ] Drift detection is implemented
38
+ - [ ] Fallback mode is defined
39
+ - [ ] Alerts are sent to user
40
+ - [ ] Recovery path is clear
41
+ - [ ] Failures are logged for analysis
@@ -0,0 +1,41 @@
1
+ ---
2
+ seed_id: 08
3
+ name: Implicit Perspective Extraction
4
+ version: 1.0
5
+ created: 2026-01-12
6
+ source: Dataiku Research
7
+ status: active
8
+ ---
9
+
10
+ # Implicit Perspective Extraction
11
+
12
+ ## What It Is
13
+ Treating constraints, metaphors, and scope boundaries as implicit perspectives rather than requiring explicit "Perspective 1/2/3" format.
14
+
15
+ ## Why It Matters
16
+ Asking for numbered perspectives feels like homework. Users naturally provide perspectives through constraints, goals, and context—we just need to extract them.
17
+
18
+ ## The Pattern
19
+ - **User input:** "no autopilot, artifact-first, 11/10 UI, avoid overbuilding"
20
+ - **Extraction:** Identify 4 implicit perspectives (autonomy constraint, output preference, quality standard, scope boundary)
21
+ - **Reflection:** "Captured 4 perspectives: [list]. Need more?"
22
+ - **Benefit:** Reduces context overhead while maintaining perspective-driven approach
23
+
24
+ ## Revisit Trigger
25
+ When users provide rich context but don't explicitly number perspectives.
26
+
27
+ ## Dojo Application
28
+ - **Constraint extraction:** "no X" → perspective about what to avoid
29
+ - **Metaphor extraction:** "Wikipedia of Prompts" → perspective about collaborative, open-source model
30
+ - **Scope extraction:** "Workbench for prompt engineering" → perspective about target use case
31
+ - **Quality extraction:** "11/10 UI" → perspective about design standards
32
+
33
+ ## What It Refuses
34
+ Rigid perspective format that creates friction.
35
+
36
+ ## Checks
37
+ - [ ] Constraints are extracted as perspectives
38
+ - [ ] Metaphors are extracted as perspectives
39
+ - [ ] Scope boundaries are extracted as perspectives
40
+ - [ ] User is asked to confirm extracted perspectives
41
+ - [ ] Extraction reduces overhead (doesn't add it)
@@ -0,0 +1,46 @@
1
+ ---
2
+ seed_id: 09
3
+ name: Mode-Based Complexity Gating
4
+ version: 1.0
5
+ created: 2026-01-12
6
+ source: Dataiku Research
7
+ status: active
8
+ ---
9
+
10
+ # Mode-Based Complexity Gating (3-Question Test)
11
+
12
+ ## What It Is
13
+ A decision framework for determining whether to use simple or complex modes based on three questions about reasoning, data sources, and adaptive processing.
14
+
15
+ ## Why It Matters
16
+ Don't load unnecessary context for simple queries. Match complexity to need.
17
+
18
+ ## The Pattern
19
+
20
+ ### Three Questions
21
+ 1. Does this require reasoning across different inputs?
22
+ 2. Does this involve multiple data sources?
23
+ 3. Does this need adaptive processing?
24
+
25
+ ### Routing Logic
26
+ - **No to all:** Stay simple (Mirror mode, minimal context)
27
+ - **Yes to some:** Moderate complexity (Scout mode, Tier 1+2 context)
28
+ - **Yes to all:** Full complexity (Scout + Debugger, Tier 1+2+3 context)
29
+
30
+ ## Revisit Trigger
31
+ When selecting mode, loading context, or estimating token usage.
32
+
33
+ ## Dojo Application
34
+ - **Simple query** ("What's the DojoPacket schema?"): Mirror mode, retrieve schema, done
35
+ - **Moderate query** ("How should we architect the Workbench?"): Scout mode, analyze routes, recommend
36
+ - **Complex query** ("Reconcile conflicting perspectives on multi-agent coordination"): Scout + Debugger, deep analysis
37
+
38
+ ## What It Refuses
39
+ One-size-fits-all complexity that wastes tokens on simple queries.
40
+
41
+ ## Checks
42
+ - [ ] Three questions are answered for each query
43
+ - [ ] Mode selection matches complexity
44
+ - [ ] Context loading matches mode
45
+ - [ ] Simple queries use minimal resources
46
+ - [ ] Complex queries get full capabilities
@@ -0,0 +1,75 @@
1
+ ---
2
+ seed_id: 10
3
+ name: Shared Infrastructure
4
+ version: 1.0
5
+ created: 2026-01-12
6
+ source: Dataiku Research
7
+ status: active
8
+ ---
9
+
10
+ # Shared Infrastructure (Build Once, Reuse Everywhere)
11
+
12
+ ## What It Is
13
+
14
+ Building foundational capabilities (validation frameworks, feedback loops, permission management, monitoring, integrations) as shared services that all agents use.
15
+
16
+ ## Why It Matters
17
+
18
+ Building the same capabilities for every agent is wasteful. Shared infrastructure makes subsequent agents much easier to deploy. Faster iteration, less duplication.
19
+
20
+ ## The Pattern
21
+
22
+ ### Identify Common Needs
23
+ - Validation frameworks
24
+ - Feedback loops
25
+ - Permission management
26
+ - Monitoring and logging
27
+ - Integrations (APIs, databases)
28
+
29
+ ### Build as Shared Services
30
+ - Central implementation
31
+ - Not per-agent duplication
32
+ - Versioned and documented
33
+
34
+ ### Reuse Across Agents
35
+ - Every new agent inherits the foundation
36
+ - Less time rebuilding, more time on unique capabilities
37
+
38
+ ## Revisit Trigger
39
+
40
+ When adding new agents, building new capabilities, or noticing duplication.
41
+
42
+ ## Dojo Application
43
+
44
+ ### Workbench
45
+ Shared infrastructure for storage, retrieval, and visualization of DojoPackets.
46
+
47
+ ### Shared Context Bus
48
+ Central store for project spines, seed modules, and contracts.
49
+
50
+ ### Trace Explorer
51
+ Unified trace visualization for all sessions (uses Harness Trace format).
52
+
53
+ ### DojoPacket Schema
54
+ Standardized export format for all sessions.
55
+
56
+ ### Perspective Validation
57
+ Reusable check across all modes (Mirror, Scout, Gardener, Implementation).
58
+
59
+ ## What It Refuses
60
+
61
+ Per-agent duplication of foundational capabilities.
62
+
63
+ ## Checks
64
+
65
+ - [ ] Common needs are identified before building per-agent solutions
66
+ - [ ] Shared services are versioned and documented
67
+ - [ ] New agents reuse existing infrastructure
68
+ - [ ] Duplication is actively prevented
69
+ - [ ] Infrastructure investment is justified by reuse
70
+
71
+ ## Related Seeds
72
+
73
+ - **Seed 01 (Three-Tiered Governance):** Operational tier uses shared instruments
74
+ - **Seed 04 (Agent Connect):** Routing logic is shared infrastructure
75
+ - **Seed 06 (Cost Guard):** Shared infrastructure reduces per-agent costs
@@ -0,0 +1,74 @@
1
+ ---
2
+ seed_id: 11
3
+ name: Voice Before Structure
4
+ version: 1.0
5
+ created: 2026-02-12
6
+ source: Marketplace Build Sprint
7
+ status: experimental
8
+ ---
9
+
10
+ # Voice Before Structure
11
+
12
+ ## What It Is
13
+
14
+ A practice of reading the project's design language and philosophy documents before writing any structural artifacts — manifests, descriptions, READMEs, schemas.
15
+
16
+ ## Why It Matters
17
+
18
+ Structure without voice produces generic output. Manifests written without philosophy grounding had to be rewritten. Voice informs structure — the descriptions, the naming, the framing all change when you understand the project's philosophy. The difference between "strategic planning tools" and "begin with a tension, not a solution" is the difference between cargo and cargo with identity.
19
+
20
+ ## The Pattern
21
+
22
+ ### Before Writing Structure
23
+ 1. Identify the project's philosophy documents (README, design language, reflections, founding documents)
24
+ 2. Read 2-3 of them — enough to hear the voice, not so many that execution stalls
25
+ 3. Let the voice inform naming, descriptions, and framing
26
+ 4. Check: would someone who knows this project recognize these descriptions as belonging here?
27
+
28
+ ### The Test
29
+ Read the structural artifact aloud. Does it sound like it came from this project, or could it belong to any project? If the latter, you haven't grounded in the voice yet.
30
+
31
+ ## Revisit Trigger
32
+
33
+ - Starting any ecosystem-level work (plugin builds, marketplace setup, documentation overhauls)
34
+ - Creating manifests, READMEs, or descriptions for a project with established design language
35
+ - When the word "description" appears in a template
36
+ - When writing metadata that carries the project's identity
37
+
38
+ ## Dojo Application
39
+
40
+ ### How Dojo Uses This Pattern
41
+ - Marketplace manifests carry growth language ("planted, cultivated, harvested") because the philosophy documents were read first
42
+ - Plugin descriptions use nature metaphors and governance principles because the Design Language was grounded before structure was written
43
+ - Cruz's mid-sprint interrupt — "before you write the manifest make sure you ground yourself in the philosophy" — was the single highest-leverage moment of the sprint
44
+
45
+ ### In Practice
46
+ Make "read the design language" Step 0 of any ecosystem-level work. Encode this in handoff templates and commission documents.
47
+
48
+ ## What It Refuses
49
+
50
+ Writing structural artifacts in a vacuum. Treating manifests, descriptions, and READMEs as boilerplate to be filled in generically.
51
+
52
+ ## Usage Examples
53
+
54
+ ### Example 1: Plugin Marketplace Build
55
+ **Without Voice:** Plugin description reads "A collection of strategic planning tools."
56
+ **With Voice:** Plugin description reads "Begin with a tension, not a solution. Scout multiple routes, align on vision, and only then commit to a plan."
57
+
58
+ ### Example 2: Documentation Overhaul
59
+ **Without Voice:** Section headings are functional ("Getting Started", "Configuration", "API Reference").
60
+ **With Voice:** Section headings carry identity — framed in the project's own language and metaphors.
61
+
62
+ ## Checks
63
+
64
+ - [ ] Philosophy documents identified before writing began
65
+ - [ ] 2-3 documents read (not just skimmed)
66
+ - [ ] Structural artifacts carry the project's voice, not generic language
67
+ - [ ] Someone familiar with the project would recognize the voice
68
+ - [ ] Execution was not delayed indefinitely by reading everything
69
+
70
+ ## Related Seeds
71
+
72
+ - **Seed 05 (Go-Live Bundles):** Bundles should carry voice too — export artifacts are identity-carrying
73
+ - **Seed 08 (Implicit Perspective Extraction):** Both seeds are about drawing richness from context rather than imposing generic structure
74
+ - **Seed 13 (Granular Visibility):** Both emerged from the same sprint; together they represent "ground first, then track visibly"
@@ -0,0 +1,81 @@
1
+ ---
2
+ seed_id: 12
3
+ name: Pointer Directories
4
+ version: 1.0
5
+ created: 2026-02-12
6
+ source: Marketplace Build Sprint
7
+ status: experimental
8
+ ---
9
+
10
+ # Pointer Directories
11
+
12
+ ## What It Is
13
+
14
+ Empty directories in a project registry are often intentional references to content that lives elsewhere — not missing content. The instinct to "fill the gap" can produce unnecessary duplication. Understanding why something is empty is more valuable than filling it.
15
+
16
+ ## Why It Matters
17
+
18
+ During the marketplace build, 7 skill directories appeared to be missing SKILL.md files. The instinct was to create new content for each. Investigation revealed they were intentional pointers — 4 referenced Anthropic Cowork platform skills (docx, pdf, pptx, xlsx), and 3 referenced Dojo Genesis skills installed at the system level (specification-writer, zenflow-prompt-writer, project-exploration). Understanding the provenance eliminated unnecessary work and produced a more accurate changelog.
19
+
20
+ ## The Pattern
21
+
22
+ ### Before Creating Content for Empty Directories
23
+ 1. Ask: "Is this directory a pointer or a gap?"
24
+ 2. Check if the content exists elsewhere — installed system, platform, external dependency, parent repository
25
+ 3. If it's a pointer, copy from the authoritative source rather than writing from scratch
26
+ 4. Document the provenance in the changelog
27
+
28
+ ### The Provenance Model
29
+ In any registry system, content may live at multiple levels:
30
+ - **Source:** The original authoring location (e.g., `dojo-genesis/skills/`)
31
+ - **System-installed:** Deployed to runtime (e.g., `.skills/skills/`)
32
+ - **Platform:** Provided by the host platform (e.g., Cowork system skills)
33
+
34
+ An empty directory at one level doesn't mean the content is missing — it may live at another level by design.
35
+
36
+ ## Revisit Trigger
37
+
38
+ - Encountering empty directories during an audit or reorganization
39
+ - Finding skills, components, or modules that exist in a registry but have no local content
40
+ - When a coverage metric shows "gaps" that nobody has complained about
41
+ - Before creating content to "fill" something that feels incomplete
42
+
43
+ ## Dojo Application
44
+
45
+ ### How Dojo Uses This Pattern
46
+ - The 49-skill marketplace achieved 100% SKILL.md coverage by copying from authoritative sources rather than writing new content
47
+ - The CHANGELOG documents each skill's provenance (platform vs. system-installed vs. source)
48
+ - Empty directories in `dojo-genesis/skills/` are understood as part of the architecture, not defects
49
+
50
+ ### The Decision
51
+ Rather than writing 7 new SKILL.md files from scratch, the sprint copied content from where it actually lived. This preserved quality, maintained consistency with the Cowork platform, and avoided divergence between the marketplace copy and the authoritative source.
52
+
53
+ ## What It Refuses
54
+
55
+ - Automatically creating content for every empty directory without investigating why it's empty
56
+ - Treating coverage metrics as the only measure of completeness
57
+ - Duplicating content when a reference to the authoritative source would be more accurate
58
+
59
+ ## Usage Examples
60
+
61
+ ### Example 1: Marketplace Build
62
+ **Without Seed:** Create 7 new SKILL.md files from scratch. Result: divergent content, maintenance burden, potential inaccuracies.
63
+ **With Seed:** Investigate provenance, discover pointers, copy from authoritative sources. Result: consistent content, clear provenance, no maintenance drift.
64
+
65
+ ### Example 2: Monorepo Audit
66
+ **Without Seed:** Report 15 packages as "missing documentation." File bugs for all 15.
67
+ **With Seed:** Check if packages reference docs from a shared documentation system or parent repo. Report only the genuine gaps.
68
+
69
+ ## Checks
70
+
71
+ - [ ] Empty directories investigated before content creation
72
+ - [ ] Provenance checked at all levels (source, system, platform)
73
+ - [ ] Authoritative source identified and content copied (not rewritten)
74
+ - [ ] Provenance documented in changelog or README
75
+ - [ ] Genuine gaps distinguished from intentional pointers
76
+
77
+ ## Related Seeds
78
+
79
+ - **Seed 10 (Shared Infrastructure):** Both patterns recognize that content may be shared across multiple consumers
80
+ - **Seed 02 (Harness Trace):** Tracing the provenance of a pointer is analogous to tracing a decision path
81
+ - **Seed 11 (Voice Before Structure):** Both emerged from the same sprint; voice informs what to write, pointers inform what not to write
@@ -0,0 +1,82 @@
1
+ ---
2
+ seed_id: 13
3
+ name: Granular Visibility
4
+ version: 1.0
5
+ created: 2026-02-12
6
+ source: Marketplace Build Sprint
7
+ status: experimental
8
+ ---
9
+
10
+ # Granular Visibility
11
+
12
+ ## What It Is
13
+
14
+ On complex multi-phase work, maintain granular progress tracking that serves the user's need for visibility — not the agent's preference for tidiness. The user steers the work. Compressed progress updates remove their ability to see what's happening, what's next, and what might need course correction.
15
+
16
+ ## Why It Matters
17
+
18
+ During the marketplace build, the todo list was compressed from 17 items to 8 mid-sprint. The user explicitly asked to "return to the more complex and complete version." The instinct to simplify felt helpful to the agent but removed the user's ability to monitor and steer. Visibility enables trust. Trust enables delegation. Delegation enables velocity.
19
+
20
+ ## The Pattern
21
+
22
+ ### Progress Tracking Principles
23
+ 1. Create granular items from the start — one per discrete deliverable or decision point, not one per phase
24
+ 2. Update status in real-time as items complete
25
+ 3. If the list feels long, that's a signal the work is complex — the list is accurate, not bloated
26
+ 4. Let the user request compression if they want it — don't pre-compress for them
27
+
28
+ ### The Chain
29
+ Granular visibility → User sees progress → User can steer → User trusts the process → User delegates more → Agent moves faster → Better outcomes
30
+
31
+ ### The Anti-Pattern
32
+ Compressed visibility → User can't see progress → User interrupts to check status → Agent stops to explain → Both lose momentum → Trust erodes
33
+
34
+ ## Revisit Trigger
35
+
36
+ - Any task with more than 10 discrete steps
37
+ - Multi-phase work spanning multiple tool calls or agents
38
+ - When the instinct arises to "simplify" or "clean up" progress tracking
39
+ - When working with a user who values steering over delegation
40
+
41
+ ## Dojo Application
42
+
43
+ ### How Dojo Uses This Pattern
44
+ - The marketplace build maintained a 24-item todo list across 4 phases
45
+ - Each SKILL.md update, each verification step, each version bump had its own line item
46
+ - The user could see at a glance: what's done, what's in progress, what's next
47
+ - Course corrections (like the philosophy grounding interrupt) were possible because the user could see where the work was heading
48
+
49
+ ### The Rule
50
+ Default to granular. Let the user ask for compression, not the other way around. The user's need for visibility outweighs the agent's preference for tidiness.
51
+
52
+ ## What It Refuses
53
+
54
+ - Pre-compressing progress updates for aesthetic reasons
55
+ - Assuming the user wants less detail
56
+ - Treating "long todo list" as a problem to solve rather than an accurate reflection of complex work
57
+ - Simplifying for the agent's convenience at the cost of the user's steering ability
58
+
59
+ ## Usage Examples
60
+
61
+ ### Example 1: Marketplace Build Sprint
62
+ **Without Seed:** 8-item todo list: "Phase 1: Reorganize", "Phase 2: Improve", etc. User can't see which of 49 skills have been updated.
63
+ **With Seed:** 24-item list: individual items for trigger phrases, version bumps, verification, each plugin's README. User can steer at any point.
64
+
65
+ ### Example 2: Documentation Overhaul
66
+ **Without Seed:** "Update all docs" as one item. Done when done.
67
+ **With Seed:** Separate items for each document group, with progress visible throughout. User notices a section was missed and corrects before completion.
68
+
69
+ ## Checks
70
+
71
+ - [ ] Todo items represent discrete deliverables or decision points (not phases)
72
+ - [ ] Status is updated in real-time
73
+ - [ ] User has not been asked to accept a compressed view
74
+ - [ ] The list length matches the work complexity
75
+ - [ ] Truly trivial sub-steps (like "read file X") are not individually tracked
76
+
77
+ ## Related Seeds
78
+
79
+ - **Seed 02 (Harness Trace):** Both seeds are about transparency — traces for decisions, visibility for progress
80
+ - **Seed 01 (Three-Tiered Governance):** Granular visibility is operational governance applied to progress tracking
81
+ - **Seed 11 (Voice Before Structure):** Both emerged from the same sprint; together they represent the mindfulness axis of the work
82
+ - **Meta-Seed (Governance Multiplies Velocity):** Granular visibility is governance that accelerates rather than slows — the user steers faster when they can see
@@ -0,0 +1,43 @@
1
+ ---
2
+ seed_id: meta
3
+ name: Governance Multiplies Velocity
4
+ version: 1.0
5
+ created: 2026-01-12
6
+ source: Dataiku Research
7
+ status: active
8
+ ---
9
+
10
+ # Governance Multiplies Velocity (Meta-Seed)
11
+
12
+ ## What It Is
13
+ The counterintuitive truth that stronger governance accelerates delivery, not slows it.
14
+
15
+ ## Why It Matters
16
+ Organizations that embed AI governance principles shave a full year or more off time-to-value. Trust accelerates delivery because teams spend less time renegotiating approvals.
17
+
18
+ ## The Pattern
19
+ - **Clear contracts** (DojoPacket schema) enable faster reuse
20
+ - **Visible traces** (harness logs) build trust faster
21
+ - **Automated checks** (perspective validation) prevent rework
22
+ - **Shared infrastructure** reduces duplication
23
+ - **Reusable artifacts** (seed modules) compound learning
24
+
25
+ ## Revisit Trigger
26
+ When governance feels like friction or when trust is lacking.
27
+
28
+ ## Dojo Application
29
+ - **Non-negotiable refusals:** Build trust through consistency
30
+ - **Harness trace:** Build trust through transparency
31
+ - **DojoPacket export:** Build trust through inspectability
32
+ - **Seed modules:** Build trust through reusability
33
+ - **Mode contracts:** Build trust through predictability
34
+
35
+ ## What It Refuses
36
+ The false dichotomy between speed and governance.
37
+
38
+ ## Checks
39
+ - [ ] Governance is seen as enabler, not blocker
40
+ - [ ] Trust is measured and tracked
41
+ - [ ] Delivery velocity increases with governance maturity
42
+ - [ ] Teams spend less time renegotiating
43
+ - [ ] Reuse is the norm, not the exception