@soleri/forge 5.5.0 → 5.7.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 (48) hide show
  1. package/dist/facades/forge.facade.js +4 -3
  2. package/dist/facades/forge.facade.js.map +1 -1
  3. package/dist/scaffolder.js +122 -8
  4. package/dist/scaffolder.js.map +1 -1
  5. package/dist/skills/skills/brain-debrief.md +214 -0
  6. package/dist/skills/skills/brainstorming.md +180 -0
  7. package/dist/skills/skills/code-patrol.md +178 -0
  8. package/dist/skills/skills/context-resume.md +146 -0
  9. package/dist/skills/skills/executing-plans.md +216 -0
  10. package/dist/skills/skills/fix-and-learn.md +167 -0
  11. package/dist/skills/skills/health-check.md +231 -0
  12. package/dist/skills/skills/knowledge-harvest.md +185 -0
  13. package/dist/skills/skills/onboard-me.md +198 -0
  14. package/dist/skills/skills/retrospective.md +205 -0
  15. package/dist/skills/skills/second-opinion.md +149 -0
  16. package/dist/skills/skills/systematic-debugging.md +241 -0
  17. package/dist/skills/skills/test-driven-development.md +281 -0
  18. package/dist/skills/skills/vault-capture.md +170 -0
  19. package/dist/skills/skills/vault-navigator.md +140 -0
  20. package/dist/skills/skills/verification-before-completion.md +182 -0
  21. package/dist/skills/skills/writing-plans.md +215 -0
  22. package/dist/templates/entry-point.js +8 -0
  23. package/dist/templates/entry-point.js.map +1 -1
  24. package/dist/templates/test-facades.js +35 -6
  25. package/dist/templates/test-facades.js.map +1 -1
  26. package/package.json +1 -1
  27. package/src/__tests__/scaffolder.test.ts +2 -2
  28. package/src/facades/forge.facade.ts +4 -3
  29. package/src/scaffolder.ts +120 -10
  30. package/src/skills/brain-debrief.md +47 -19
  31. package/src/skills/brainstorming.md +19 -9
  32. package/src/skills/code-patrol.md +21 -19
  33. package/src/skills/context-resume.md +14 -11
  34. package/src/skills/executing-plans.md +30 -15
  35. package/src/skills/fix-and-learn.md +17 -14
  36. package/src/skills/health-check.md +29 -23
  37. package/src/skills/knowledge-harvest.md +27 -20
  38. package/src/skills/onboard-me.md +16 -15
  39. package/src/skills/retrospective.md +34 -18
  40. package/src/skills/second-opinion.md +16 -9
  41. package/src/skills/systematic-debugging.md +40 -29
  42. package/src/skills/test-driven-development.md +45 -30
  43. package/src/skills/vault-capture.md +31 -15
  44. package/src/skills/vault-navigator.md +24 -13
  45. package/src/skills/verification-before-completion.md +38 -26
  46. package/src/skills/writing-plans.md +21 -13
  47. package/src/templates/entry-point.ts +8 -0
  48. package/src/templates/test-facades.ts +35 -6
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: brainstorming
3
- description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation."
3
+ description: 'You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.'
4
4
  ---
5
5
 
6
6
  <!-- Adapted from superpowers (MIT License) -->
@@ -52,12 +52,14 @@ This returns the intent type (BUILD, FIX, VALIDATE, DESIGN, IMPROVE, DELIVER) an
52
52
  **BEFORE asking any questions or exploring code**, search for existing knowledge. Follow this order:
53
53
 
54
54
  ### Vault First
55
+
55
56
  ```
56
57
  YOUR_AGENT_core op:search_intelligent
57
58
  params: { query: "<the feature or idea the user described>" }
58
59
  ```
59
60
 
60
61
  Look for:
62
+
61
63
  - **Previous designs** — was this discussed or attempted before?
62
64
  - **Architectural decisions** — are there constraints from past decisions?
63
65
  - **Patterns** — established approaches in this codebase
@@ -84,18 +86,22 @@ YOUR_AGENT_core op:memory_cross_project_search
84
86
  ```
85
87
 
86
88
  ### Web Search Second
89
+
87
90
  If the vault doesn't have prior art, search the web for:
91
+
88
92
  - **Existing libraries/tools** that solve this problem (don't build what exists)
89
93
  - **Reference implementations** in similar projects
90
94
  - **Best practices** and established patterns for this type of feature
91
95
  - **Known pitfalls** that others have documented
92
96
 
93
97
  ### Present Findings
98
+
94
99
  Present vault + web findings to the user: "Before we design this, here's what I found..." This informs the design conversation and prevents reinventing solutions.
95
100
 
96
101
  ## The Process
97
102
 
98
103
  **Understanding the idea:**
104
+
99
105
  - Check out the current project state first (files, docs, recent commits)
100
106
  - Ask questions one at a time to refine the idea
101
107
  - Prefer multiple choice questions when possible, but open-ended is fine too
@@ -103,6 +109,7 @@ Present vault + web findings to the user: "Before we design this, here's what I
103
109
  - Focus on understanding: purpose, constraints, success criteria
104
110
 
105
111
  **Exploring approaches:**
112
+
106
113
  - Propose 2-3 different approaches with trade-offs
107
114
  - Present options conversationally with your recommendation and reasoning
108
115
  - Lead with your recommended option and explain why
@@ -110,6 +117,7 @@ Present vault + web findings to the user: "Before we design this, here's what I
110
117
  - **Reference web findings** — if an existing library solves this, recommend it over custom code
111
118
 
112
119
  **Presenting the design:**
120
+
113
121
  - Once you understand what you're building, present the design
114
122
  - Scale each section to its complexity
115
123
  - Ask after each section whether it looks right so far
@@ -133,10 +141,12 @@ YOUR_AGENT_core op:capture_knowledge
133
141
  This ensures future brainstorming sessions can reference what was decided and why.
134
142
 
135
143
  **Documentation:**
144
+
136
145
  - Write the validated design to `docs/plans/YYYY-MM-DD-<topic>-design.md`
137
146
  - Commit the design document to git
138
147
 
139
148
  **Implementation:**
149
+
140
150
  - Invoke the writing-plans skill to create a detailed implementation plan
141
151
  - Do NOT invoke any other skill. writing-plans is the next step.
142
152
 
@@ -160,11 +170,11 @@ This ensures future brainstorming sessions can reference what was decided and wh
160
170
 
161
171
  ## Agent Tools Reference
162
172
 
163
- | Op | When to Use |
164
- |----|-------------|
165
- | `route_intent` | Classify the type of work (BUILD, FIX, etc.) |
166
- | `search_intelligent` | Search vault for prior art |
167
- | `vault_tags` / `vault_domains` | Browse knowledge landscape |
168
- | `brain_strengths` | Check proven patterns |
169
- | `memory_cross_project_search` | Check if other projects solved this |
170
- | `capture_knowledge` | Persist design decision to vault |
173
+ | Op | When to Use |
174
+ | ------------------------------ | -------------------------------------------- |
175
+ | `route_intent` | Classify the type of work (BUILD, FIX, etc.) |
176
+ | `search_intelligent` | Search vault for prior art |
177
+ | `vault_tags` / `vault_domains` | Browse knowledge landscape |
178
+ | `brain_strengths` | Check proven patterns |
179
+ | `memory_cross_project_search` | Check if other projects solved this |
180
+ | `capture_knowledge` | Persist design decision to vault |
@@ -75,13 +75,13 @@ YOUR_AGENT_core op:brain_strengths
75
75
 
76
76
  With vault patterns loaded, review the code checking for:
77
77
 
78
- | Check | Source | Severity |
79
- |-------|--------|----------|
80
- | Violates a critical rule | `search (severity: critical)` | Must fix |
81
- | Matches a known anti-pattern | `search (type: anti-pattern)` | Must fix |
82
- | Doesn't follow a proven pattern | `brain_strengths` | Should fix |
83
- | Breaks project conventions | `project_list_rules` | Should fix |
84
- | Misses an opportunity to use a pattern | `search_intelligent` | Could improve |
78
+ | Check | Source | Severity |
79
+ | -------------------------------------- | ----------------------------- | ------------- |
80
+ | Violates a critical rule | `search (severity: critical)` | Must fix |
81
+ | Matches a known anti-pattern | `search (type: anti-pattern)` | Must fix |
82
+ | Doesn't follow a proven pattern | `brain_strengths` | Should fix |
83
+ | Breaks project conventions | `project_list_rules` | Should fix |
84
+ | Misses an opportunity to use a pattern | `search_intelligent` | Could improve |
85
85
 
86
86
  ### Step 4: Present the Review
87
87
 
@@ -146,6 +146,7 @@ YOUR_AGENT_core op:search_intelligent
146
146
  ```
147
147
 
148
148
  Check system health:
149
+
149
150
  ```
150
151
  YOUR_AGENT_core op:admin_health
151
152
  ```
@@ -153,6 +154,7 @@ YOUR_AGENT_core op:admin_health
153
154
  ## The Magic
154
155
 
155
156
  This feels like magic because:
157
+
156
158
  1. It's not ESLint — it catches things like "we decided not to use inheritance here" or "this API pattern caused production issues last month"
157
159
  2. The rules come from YOUR team's experience, not a generic config file
158
160
  3. It gets smarter over time — every captured pattern becomes a new check
@@ -162,15 +164,15 @@ A linter checks syntax. Code patrol checks wisdom.
162
164
 
163
165
  ## Agent Tools Reference
164
166
 
165
- | Op | When to Use |
166
- |----|-------------|
167
- | `route_intent` | Classify the code's domain |
168
- | `vault_domains` | See which domains are relevant |
169
- | `search_intelligent` | Find relevant patterns for this code |
170
- | `search` | Find anti-patterns and critical rules |
171
- | `project_list_rules` | Project-specific conventions |
172
- | `get_behavior_rules` | Behavioral rules |
173
- | `brain_strengths` | Proven patterns to check against |
174
- | `capture_quick` | Capture new patterns discovered during review |
175
- | `capture_knowledge` | Capture new conventions |
176
- | `admin_health` | Post-review health check |
167
+ | Op | When to Use |
168
+ | -------------------- | --------------------------------------------- |
169
+ | `route_intent` | Classify the code's domain |
170
+ | `vault_domains` | See which domains are relevant |
171
+ | `search_intelligent` | Find relevant patterns for this code |
172
+ | `search` | Find anti-patterns and critical rules |
173
+ | `project_list_rules` | Project-specific conventions |
174
+ | `get_behavior_rules` | Behavioral rules |
175
+ | `brain_strengths` | Proven patterns to check against |
176
+ | `capture_quick` | Capture new patterns discovered during review |
177
+ | `capture_knowledge` | Capture new conventions |
178
+ | `admin_health` | Post-review health check |
@@ -34,6 +34,7 @@ YOUR_AGENT_core op:plan_list_tasks
34
34
  ```
35
35
 
36
36
  Present:
37
+
37
38
  - Plan objective and current status
38
39
  - Which tasks are completed, in progress, or pending
39
40
  - What's next to do
@@ -66,6 +67,7 @@ YOUR_AGENT_core op:loop_is_active
66
67
  ```
67
68
 
68
69
  If active:
70
+
69
71
  ```
70
72
  YOUR_AGENT_core op:loop_status
71
73
  ```
@@ -119,6 +121,7 @@ Format as a concise standup:
119
121
  ## The Magic
120
122
 
121
123
  This feels like magic because the user just says "catch me up" and the agent:
124
+
122
125
  1. Knows what plans are active and where they stand
123
126
  2. Remembers what happened last session (even across context compactions)
124
127
  3. Shows what knowledge was recently captured
@@ -129,15 +132,15 @@ No other tool does this — the agent has genuine persistent memory.
129
132
 
130
133
  ## Agent Tools Reference
131
134
 
132
- | Op | When to Use |
133
- |----|-------------|
134
- | `plan_stats` | Find active plans |
135
- | `get_plan` | Load plan details |
135
+ | Op | When to Use |
136
+ | ----------------- | --------------------------- |
137
+ | `plan_stats` | Find active plans |
138
+ | `get_plan` | Load plan details |
136
139
  | `plan_list_tasks` | See task status within plan |
137
- | `memory_search` | Find session summaries |
138
- | `memory_list` | Browse recent memories |
139
- | `vault_recent` | Recently captured knowledge |
140
- | `loop_is_active` | Check for in-flight loops |
141
- | `loop_status` | Get loop details |
142
- | `brain_strengths` | Relevant proven patterns |
143
- | `admin_health` | System health check |
140
+ | `memory_search` | Find session summaries |
141
+ | `memory_list` | Browse recent memories |
142
+ | `vault_recent` | Recently captured knowledge |
143
+ | `loop_is_active` | Check for in-flight loops |
144
+ | `loop_status` | Get loop details |
145
+ | `brain_strengths` | Relevant proven patterns |
146
+ | `admin_health` | System health check |
@@ -41,6 +41,7 @@ YOUR_AGENT_core op:plan_stats
41
41
  If no tracked plan exists, read the plan file from `docs/plans/`.
42
42
 
43
43
  Review critically — identify any questions or concerns about the plan.
44
+
44
45
  - If concerns: Raise them with your human partner before starting
45
46
  - If no concerns: Create TodoWrite and proceed
46
47
 
@@ -56,9 +57,11 @@ YOUR_AGENT_core op:loop_start
56
57
  The loop tracks iterations and validates progress automatically.
57
58
 
58
59
  ### Step 3: Execute Batch
60
+
59
61
  **Default: First 3 tasks**
60
62
 
61
63
  For each task:
64
+
62
65
  1. Mark as in_progress:
63
66
  ```
64
67
  YOUR_AGENT_core op:update_task
@@ -79,7 +82,9 @@ YOUR_AGENT_core op:loop_iterate
79
82
  ```
80
83
 
81
84
  ### Step 4: Report
85
+
82
86
  When batch complete:
87
+
83
88
  - Show what was implemented
84
89
  - Show verification output
85
90
  - Check loop status:
@@ -89,7 +94,9 @@ When batch complete:
89
94
  - Say: "Ready for feedback."
90
95
 
91
96
  ### Step 5: Continue
97
+
92
98
  Based on feedback:
99
+
93
100
  - Apply changes if needed
94
101
  - Execute next batch
95
102
  - Repeat until complete
@@ -101,11 +108,13 @@ After all tasks complete and verified:
101
108
  1. Run final verification (use verification-before-completion skill)
102
109
 
103
110
  2. Complete the validation loop:
111
+
104
112
  ```
105
113
  YOUR_AGENT_core op:loop_complete
106
114
  ```
107
115
 
108
116
  3. Reconcile plan — compare what was planned vs what actually happened:
117
+
109
118
  ```
110
119
  YOUR_AGENT_core op:plan_reconcile
111
120
  params: {
@@ -116,12 +125,14 @@ After all tasks complete and verified:
116
125
  ```
117
126
 
118
127
  4. Complete plan lifecycle — extract knowledge and archive:
128
+
119
129
  ```
120
130
  YOUR_AGENT_core op:plan_complete_lifecycle
121
131
  params: { planId: "<id>" }
122
132
  ```
123
133
 
124
134
  5. Archive the plan for historical reference:
135
+
125
136
  ```
126
137
  YOUR_AGENT_core op:plan_archive
127
138
  params: { planId: "<id>" }
@@ -150,6 +161,7 @@ Don't wait until the end — capture insights as they happen.
150
161
  ## When to Stop and Ask for Help
151
162
 
152
163
  **STOP executing immediately when:**
164
+
153
165
  - Hit a blocker mid-batch (missing dependency, test fails, instruction unclear)
154
166
  - Plan has critical gaps preventing starting
155
167
  - You don't understand an instruction
@@ -160,12 +172,14 @@ Don't wait until the end — capture insights as they happen.
160
172
  ## When to Revisit Earlier Steps
161
173
 
162
174
  **Return to Review (Step 1) when:**
175
+
163
176
  - Partner updates the plan based on your feedback
164
177
  - Fundamental approach needs rethinking
165
178
 
166
179
  **Don't force through blockers** - stop and ask.
167
180
 
168
181
  ## Remember
182
+
169
183
  - Review plan critically first
170
184
  - Follow plan steps exactly
171
185
  - Don't skip verifications
@@ -177,25 +191,26 @@ Don't wait until the end — capture insights as they happen.
177
191
 
178
192
  ## Agent Tools Reference
179
193
 
180
- | Op | When to Use |
181
- |----|-------------|
182
- | `get_plan` | Load tracked plan |
183
- | `plan_list_tasks` | List all tasks in the plan |
184
- | `plan_stats` | Plan overview and metrics |
185
- | `update_task` | Mark tasks in_progress / completed |
186
- | `loop_start` | Begin validation loop for iterative execution |
187
- | `loop_iterate` | Track each iteration |
188
- | `loop_status` | Check loop progress |
189
- | `loop_complete` | Finish validation loop |
190
- | `plan_reconcile` | Compare planned vs actual (post-execution) |
191
- | `plan_complete_lifecycle` | Extract knowledge from execution |
192
- | `plan_archive` | Archive plan for history |
193
- | `session_capture` | Save session context |
194
- | `capture_quick` | Capture mid-execution learnings |
194
+ | Op | When to Use |
195
+ | ------------------------- | --------------------------------------------- |
196
+ | `get_plan` | Load tracked plan |
197
+ | `plan_list_tasks` | List all tasks in the plan |
198
+ | `plan_stats` | Plan overview and metrics |
199
+ | `update_task` | Mark tasks in_progress / completed |
200
+ | `loop_start` | Begin validation loop for iterative execution |
201
+ | `loop_iterate` | Track each iteration |
202
+ | `loop_status` | Check loop progress |
203
+ | `loop_complete` | Finish validation loop |
204
+ | `plan_reconcile` | Compare planned vs actual (post-execution) |
205
+ | `plan_complete_lifecycle` | Extract knowledge from execution |
206
+ | `plan_archive` | Archive plan for history |
207
+ | `session_capture` | Save session context |
208
+ | `capture_quick` | Capture mid-execution learnings |
195
209
 
196
210
  ## Integration
197
211
 
198
212
  **Required workflow skills:**
213
+
199
214
  - writing-plans — Creates the plan this skill executes
200
215
  - verification-before-completion — Verify work before claiming completion
201
216
  - test-driven-development — Follow TDD for each implementation step
@@ -66,6 +66,7 @@ If vault returns a match with high confidence — **use it**. Don't re-investiga
66
66
  ### Step 3: Search the Web
67
67
 
68
68
  If the vault has no answer, search for existing solutions before investigating from scratch:
69
+
69
70
  - Known issues in the library/framework
70
71
  - Stack Overflow answers for the exact error
71
72
  - GitHub issues on relevant repos
@@ -85,6 +86,7 @@ YOUR_AGENT_core op:loop_start
85
86
  ### Step 5: Diagnose and Fix
86
87
 
87
88
  Only if Steps 2-3 didn't produce a solution, apply the systematic debugging approach (use systematic-debugging skill):
89
+
88
90
  1. Reproduce the issue
89
91
  2. Isolate the root cause
90
92
  3. **Plan the fix before writing code** — even a one-line mental plan
@@ -123,6 +125,7 @@ YOUR_AGENT_core op:capture_knowledge
123
125
  ```
124
126
 
125
127
  For quick captures:
128
+
126
129
  ```
127
130
  YOUR_AGENT_core op:capture_quick
128
131
  params: { title: "<bug>", description: "<root cause and fix>" }
@@ -148,17 +151,17 @@ Fix is complete when: the bug is resolved, tests pass (Step 6), and the root cau
148
151
 
149
152
  ## Agent Tools Reference
150
153
 
151
- | Op | When to Use |
152
- |----|-------------|
153
- | `route_intent` | Classify as FIX intent |
154
- | `search_intelligent` | Check vault for known bugs |
155
- | `memory_search` | Search across session memories |
156
- | `memory_topics` | See if bugs cluster in an area |
157
- | `memory_stats` | Understand debugging landscape |
158
- | `loop_start` | Begin iterative fix cycle |
159
- | `loop_iterate` | Track each fix attempt |
160
- | `loop_complete` | Finish fix cycle |
161
- | `capture_knowledge` | Full anti-pattern capture |
162
- | `capture_quick` | Fast capture |
163
- | `curator_detect_duplicates` | Prevent redundant entries |
164
- | `admin_health` | Verify system health |
154
+ | Op | When to Use |
155
+ | --------------------------- | ------------------------------ |
156
+ | `route_intent` | Classify as FIX intent |
157
+ | `search_intelligent` | Check vault for known bugs |
158
+ | `memory_search` | Search across session memories |
159
+ | `memory_topics` | See if bugs cluster in an area |
160
+ | `memory_stats` | Understand debugging landscape |
161
+ | `loop_start` | Begin iterative fix cycle |
162
+ | `loop_iterate` | Track each fix attempt |
163
+ | `loop_complete` | Finish fix cycle |
164
+ | `capture_knowledge` | Full anti-pattern capture |
165
+ | `capture_quick` | Fast capture |
166
+ | `curator_detect_duplicates` | Prevent redundant entries |
167
+ | `admin_health` | Verify system health |
@@ -87,6 +87,7 @@ YOUR_AGENT_core op:vault_age_report
87
87
  ```
88
88
 
89
89
  Entries older than 30 days without updates are candidates for:
90
+
90
91
  - Refresh (still relevant, needs updating)
91
92
  - Archive (no longer relevant)
92
93
  - Delete (incorrect or superseded)
@@ -135,26 +136,31 @@ YOUR_AGENT_core op:governance_expire
135
136
  If the user approves, run the full cleanup:
136
137
 
137
138
  **Groom all entries — normalize tags, fix metadata:**
139
+
138
140
  ```
139
141
  YOUR_AGENT_core op:curator_groom_all
140
142
  ```
141
143
 
142
144
  **Full consolidation — deduplicate, normalize, quality-score:**
145
+
143
146
  ```
144
147
  YOUR_AGENT_core op:curator_consolidate
145
148
  ```
146
149
 
147
150
  **Prune stale memory:**
151
+
148
152
  ```
149
153
  YOUR_AGENT_core op:memory_prune
150
154
  ```
151
155
 
152
156
  **Rebuild brain intelligence with clean data:**
157
+
153
158
  ```
154
159
  YOUR_AGENT_core op:brain_build_intelligence
155
160
  ```
156
161
 
157
162
  **Reset caches to pick up changes:**
163
+
158
164
  ```
159
165
  YOUR_AGENT_core op:admin_reset_cache
160
166
  ```
@@ -200,26 +206,26 @@ This feels like magic because knowledge bases normally decay silently — duplic
200
206
 
201
207
  ## Agent Tools Reference
202
208
 
203
- | Op | When to Use |
204
- |----|-------------|
205
- | `admin_health` | System health check |
206
- | `admin_diagnostic` | Comprehensive system diagnostic |
207
- | `admin_vault_size` | Vault storage metrics |
208
- | `admin_vault_analytics` | Knowledge quality metrics |
209
- | `admin_search_insights` | Search miss analysis |
210
- | `admin_reset_cache` | Clear caches after cleanup |
211
- | `vault_domains` / `vault_tags` | Knowledge landscape |
212
- | `vault_age_report` | Stale entry detection |
213
- | `curator_health_audit` | Quality score and audit |
214
- | `curator_detect_duplicates` | Find duplicates |
215
- | `curator_contradictions` | Find conflicting entries |
216
- | `curator_resolve_contradiction` | Resolve conflicts |
217
- | `curator_groom_all` | Batch tag normalization |
218
- | `curator_consolidate` | Full cleanup pipeline |
219
- | `memory_stats` | Memory health |
220
- | `memory_deduplicate` | Remove duplicate memories |
221
- | `memory_prune` | Remove stale memories |
222
- | `governance_proposals` | Pending review queue |
223
- | `governance_stats` | Governance metrics |
224
- | `governance_expire` | Expire stale proposals |
225
- | `brain_build_intelligence` | Rebuild after cleanup |
209
+ | Op | When to Use |
210
+ | ------------------------------- | ------------------------------- |
211
+ | `admin_health` | System health check |
212
+ | `admin_diagnostic` | Comprehensive system diagnostic |
213
+ | `admin_vault_size` | Vault storage metrics |
214
+ | `admin_vault_analytics` | Knowledge quality metrics |
215
+ | `admin_search_insights` | Search miss analysis |
216
+ | `admin_reset_cache` | Clear caches after cleanup |
217
+ | `vault_domains` / `vault_tags` | Knowledge landscape |
218
+ | `vault_age_report` | Stale entry detection |
219
+ | `curator_health_audit` | Quality score and audit |
220
+ | `curator_detect_duplicates` | Find duplicates |
221
+ | `curator_contradictions` | Find conflicting entries |
222
+ | `curator_resolve_contradiction` | Resolve conflicts |
223
+ | `curator_groom_all` | Batch tag normalization |
224
+ | `curator_consolidate` | Full cleanup pipeline |
225
+ | `memory_stats` | Memory health |
226
+ | `memory_deduplicate` | Remove duplicate memories |
227
+ | `memory_prune` | Remove stale memories |
228
+ | `governance_proposals` | Pending review queue |
229
+ | `governance_stats` | Governance metrics |
230
+ | `governance_expire` | Expire stale proposals |
231
+ | `brain_build_intelligence` | Rebuild after cleanup |
@@ -49,15 +49,16 @@ This tells you what the vault already covers — focus extraction on gaps.
49
49
 
50
50
  Read through the source material and identify:
51
51
 
52
- | Type | What to Look For |
53
- |------|-----------------|
54
- | **pattern** | "We always do X because Y" — repeatable approaches |
55
- | **anti-pattern** | "Don't do X because Y" — known mistakes |
56
- | **decision** | "We chose X over Y because Z" — architectural choices |
57
- | **principle** | "We believe X" — guiding rules |
58
- | **workflow** | "The process for X is: step 1, step 2..." — procedures |
52
+ | Type | What to Look For |
53
+ | ---------------- | ------------------------------------------------------ |
54
+ | **pattern** | "We always do X because Y" — repeatable approaches |
55
+ | **anti-pattern** | "Don't do X because Y" — known mistakes |
56
+ | **decision** | "We chose X over Y because Z" — architectural choices |
57
+ | **principle** | "We believe X" — guiding rules |
58
+ | **workflow** | "The process for X is: step 1, step 2..." — procedures |
59
59
 
60
60
  For each extracted item, determine:
61
+
61
62
  - **Category**: Which domain it belongs to
62
63
  - **Severity**: critical / warning / suggestion
63
64
  - **Tags**: Searchable keywords
@@ -81,6 +82,7 @@ YOUR_AGENT_core op:capture_knowledge
81
82
  ```
82
83
 
83
84
  Present each capture to the user as you go:
85
+
84
86
  ```
85
87
  Captured: api-auth-jwt (pattern, critical)
86
88
  → "Use short-lived JWTs for authentication"
@@ -92,22 +94,26 @@ Captured: api-auth-jwt (pattern, critical)
92
94
  After all items captured, run quality checks:
93
95
 
94
96
  **Detect any duplicates created during harvest:**
97
+
95
98
  ```
96
99
  YOUR_AGENT_core op:curator_detect_duplicates
97
100
  ```
98
101
 
99
102
  **Groom all new entries — normalize tags, fix metadata:**
103
+
100
104
  ```
101
105
  YOUR_AGENT_core op:curator_groom_all
102
106
  ```
103
107
 
104
108
  **Enrich entries with additional context:**
109
+
105
110
  ```
106
111
  YOUR_AGENT_core op:curator_enrich
107
112
  params: { entryId: "<id>" }
108
113
  ```
109
114
 
110
115
  **Check for contradictions with existing knowledge:**
116
+
111
117
  ```
112
118
  YOUR_AGENT_core op:curator_contradictions
113
119
  ```
@@ -125,6 +131,7 @@ YOUR_AGENT_core op:admin_vault_analytics
125
131
  ```
126
132
 
127
133
  Present a summary:
134
+
128
135
  ```
129
136
  ## Harvest Complete
130
137
 
@@ -163,16 +170,16 @@ This feels like magic because the user points at a 50-page architecture doc and
163
170
 
164
171
  ## Agent Tools Reference
165
172
 
166
- | Op | When to Use |
167
- |----|-------------|
168
- | `route_intent` | Classify the source material |
169
- | `search_intelligent` | Check for existing knowledge |
170
- | `vault_tags` / `vault_domains` | See what's already covered |
171
- | `capture_knowledge` | Capture each extracted item |
172
- | `curator_detect_duplicates` | Find duplicates post-harvest |
173
- | `curator_groom_all` | Normalize all new entries |
174
- | `curator_enrich` | LLM-enrich entries |
175
- | `curator_contradictions` | Find conflicts with existing knowledge |
176
- | `memory_promote_to_global` | Share universal patterns cross-project |
177
- | `admin_health` | Post-harvest health check |
178
- | `admin_vault_analytics` | Knowledge quality metrics |
173
+ | Op | When to Use |
174
+ | ------------------------------ | -------------------------------------- |
175
+ | `route_intent` | Classify the source material |
176
+ | `search_intelligent` | Check for existing knowledge |
177
+ | `vault_tags` / `vault_domains` | See what's already covered |
178
+ | `capture_knowledge` | Capture each extracted item |
179
+ | `curator_detect_duplicates` | Find duplicates post-harvest |
180
+ | `curator_groom_all` | Normalize all new entries |
181
+ | `curator_enrich` | LLM-enrich entries |
182
+ | `curator_contradictions` | Find conflicts with existing knowledge |
183
+ | `memory_promote_to_global` | Share universal patterns cross-project |
184
+ | `admin_health` | Post-harvest health check |
185
+ | `admin_vault_analytics` | Knowledge quality metrics |
@@ -169,6 +169,7 @@ Use `/second-opinion` before making any architectural decision.
169
169
  ## The Magic
170
170
 
171
171
  This feels like magic because a new team member says "onboard me" and instantly gets:
172
+
172
173
  1. Every critical rule they must follow
173
174
  2. Every architectural decision and why it was made
174
175
  3. Proven patterns to follow
@@ -180,18 +181,18 @@ No other onboarding tool does this — it's not a static wiki, it's a living kno
180
181
 
181
182
  ## Agent Tools Reference
182
183
 
183
- | Op | When to Use |
184
- |----|-------------|
185
- | `identity` | Project persona and description |
186
- | `project_get` | Project registration details |
187
- | `project_list_rules` | Project-specific rules |
188
- | `get_behavior_rules` | Behavioral conventions |
189
- | `vault_domains` / `vault_tags` | Knowledge landscape |
190
- | `admin_vault_size` | How much knowledge exists |
191
- | `search` | Find critical entries and anti-patterns |
192
- | `search_intelligent` | Find decisions and patterns |
193
- | `brain_strengths` | Proven approaches |
194
- | `brain_global_patterns` | Cross-project patterns |
195
- | `project_linked_projects` | Related projects |
196
- | `admin_search_insights` | What's not in the vault |
197
- | `vault_age_report` | Stale knowledge areas |
184
+ | Op | When to Use |
185
+ | ------------------------------ | --------------------------------------- |
186
+ | `identity` | Project persona and description |
187
+ | `project_get` | Project registration details |
188
+ | `project_list_rules` | Project-specific rules |
189
+ | `get_behavior_rules` | Behavioral conventions |
190
+ | `vault_domains` / `vault_tags` | Knowledge landscape |
191
+ | `admin_vault_size` | How much knowledge exists |
192
+ | `search` | Find critical entries and anti-patterns |
193
+ | `search_intelligent` | Find decisions and patterns |
194
+ | `brain_strengths` | Proven approaches |
195
+ | `brain_global_patterns` | Cross-project patterns |
196
+ | `project_linked_projects` | Related projects |
197
+ | `admin_search_insights` | What's not in the vault |
198
+ | `vault_age_report` | Stale knowledge areas |