@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.
- package/dist/facades/forge.facade.js +4 -3
- package/dist/facades/forge.facade.js.map +1 -1
- package/dist/scaffolder.js +122 -8
- package/dist/scaffolder.js.map +1 -1
- package/dist/skills/skills/brain-debrief.md +214 -0
- package/dist/skills/skills/brainstorming.md +180 -0
- package/dist/skills/skills/code-patrol.md +178 -0
- package/dist/skills/skills/context-resume.md +146 -0
- package/dist/skills/skills/executing-plans.md +216 -0
- package/dist/skills/skills/fix-and-learn.md +167 -0
- package/dist/skills/skills/health-check.md +231 -0
- package/dist/skills/skills/knowledge-harvest.md +185 -0
- package/dist/skills/skills/onboard-me.md +198 -0
- package/dist/skills/skills/retrospective.md +205 -0
- package/dist/skills/skills/second-opinion.md +149 -0
- package/dist/skills/skills/systematic-debugging.md +241 -0
- package/dist/skills/skills/test-driven-development.md +281 -0
- package/dist/skills/skills/vault-capture.md +170 -0
- package/dist/skills/skills/vault-navigator.md +140 -0
- package/dist/skills/skills/verification-before-completion.md +182 -0
- package/dist/skills/skills/writing-plans.md +215 -0
- package/dist/templates/entry-point.js +8 -0
- package/dist/templates/entry-point.js.map +1 -1
- package/dist/templates/test-facades.js +35 -6
- package/dist/templates/test-facades.js.map +1 -1
- package/package.json +1 -1
- package/src/__tests__/scaffolder.test.ts +2 -2
- package/src/facades/forge.facade.ts +4 -3
- package/src/scaffolder.ts +120 -10
- package/src/skills/brain-debrief.md +47 -19
- package/src/skills/brainstorming.md +19 -9
- package/src/skills/code-patrol.md +21 -19
- package/src/skills/context-resume.md +14 -11
- package/src/skills/executing-plans.md +30 -15
- package/src/skills/fix-and-learn.md +17 -14
- package/src/skills/health-check.md +29 -23
- package/src/skills/knowledge-harvest.md +27 -20
- package/src/skills/onboard-me.md +16 -15
- package/src/skills/retrospective.md +34 -18
- package/src/skills/second-opinion.md +16 -9
- package/src/skills/systematic-debugging.md +40 -29
- package/src/skills/test-driven-development.md +45 -30
- package/src/skills/vault-capture.md +31 -15
- package/src/skills/vault-navigator.md +24 -13
- package/src/skills/verification-before-completion.md +38 -26
- package/src/skills/writing-plans.md +21 -13
- package/src/templates/entry-point.ts +8 -0
- package/src/templates/test-facades.ts +35 -6
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: brainstorming
|
|
3
|
-
description:
|
|
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
|
|
164
|
-
|
|
165
|
-
| `route_intent`
|
|
166
|
-
| `search_intelligent`
|
|
167
|
-
| `vault_tags` / `vault_domains` | Browse knowledge landscape
|
|
168
|
-
| `brain_strengths`
|
|
169
|
-
| `memory_cross_project_search`
|
|
170
|
-
| `capture_knowledge`
|
|
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
|
|
79
|
-
|
|
80
|
-
| Violates a critical rule
|
|
81
|
-
| Matches a known anti-pattern
|
|
82
|
-
| Doesn't follow a proven pattern
|
|
83
|
-
| Breaks project conventions
|
|
84
|
-
| Misses an opportunity to use a pattern | `search_intelligent`
|
|
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
|
|
166
|
-
|
|
167
|
-
| `route_intent`
|
|
168
|
-
| `vault_domains`
|
|
169
|
-
| `search_intelligent` | Find relevant patterns for this code
|
|
170
|
-
| `search`
|
|
171
|
-
| `project_list_rules` | Project-specific conventions
|
|
172
|
-
| `get_behavior_rules` | Behavioral rules
|
|
173
|
-
| `brain_strengths`
|
|
174
|
-
| `capture_quick`
|
|
175
|
-
| `capture_knowledge`
|
|
176
|
-
| `admin_health`
|
|
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
|
|
133
|
-
|
|
134
|
-
| `plan_stats`
|
|
135
|
-
| `get_plan`
|
|
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`
|
|
138
|
-
| `memory_list`
|
|
139
|
-
| `vault_recent`
|
|
140
|
-
| `loop_is_active`
|
|
141
|
-
| `loop_status`
|
|
142
|
-
| `brain_strengths` | Relevant proven patterns
|
|
143
|
-
| `admin_health`
|
|
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
|
|
181
|
-
|
|
182
|
-
| `get_plan`
|
|
183
|
-
| `plan_list_tasks`
|
|
184
|
-
| `plan_stats`
|
|
185
|
-
| `update_task`
|
|
186
|
-
| `loop_start`
|
|
187
|
-
| `loop_iterate`
|
|
188
|
-
| `loop_status`
|
|
189
|
-
| `loop_complete`
|
|
190
|
-
| `plan_reconcile`
|
|
191
|
-
| `plan_complete_lifecycle` | Extract knowledge from execution
|
|
192
|
-
| `plan_archive`
|
|
193
|
-
| `session_capture`
|
|
194
|
-
| `capture_quick`
|
|
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
|
|
152
|
-
|
|
153
|
-
| `route_intent`
|
|
154
|
-
| `search_intelligent`
|
|
155
|
-
| `memory_search`
|
|
156
|
-
| `memory_topics`
|
|
157
|
-
| `memory_stats`
|
|
158
|
-
| `loop_start`
|
|
159
|
-
| `loop_iterate`
|
|
160
|
-
| `loop_complete`
|
|
161
|
-
| `capture_knowledge`
|
|
162
|
-
| `capture_quick`
|
|
163
|
-
| `curator_detect_duplicates` | Prevent redundant entries
|
|
164
|
-
| `admin_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
|
|
204
|
-
|
|
205
|
-
| `admin_health`
|
|
206
|
-
| `admin_diagnostic`
|
|
207
|
-
| `admin_vault_size`
|
|
208
|
-
| `admin_vault_analytics`
|
|
209
|
-
| `admin_search_insights`
|
|
210
|
-
| `admin_reset_cache`
|
|
211
|
-
| `vault_domains` / `vault_tags`
|
|
212
|
-
| `vault_age_report`
|
|
213
|
-
| `curator_health_audit`
|
|
214
|
-
| `curator_detect_duplicates`
|
|
215
|
-
| `curator_contradictions`
|
|
216
|
-
| `curator_resolve_contradiction` | Resolve conflicts
|
|
217
|
-
| `curator_groom_all`
|
|
218
|
-
| `curator_consolidate`
|
|
219
|
-
| `memory_stats`
|
|
220
|
-
| `memory_deduplicate`
|
|
221
|
-
| `memory_prune`
|
|
222
|
-
| `governance_proposals`
|
|
223
|
-
| `governance_stats`
|
|
224
|
-
| `governance_expire`
|
|
225
|
-
| `brain_build_intelligence`
|
|
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
|
|
53
|
-
|
|
54
|
-
| **pattern**
|
|
55
|
-
| **anti-pattern** | "Don't do X because Y" — known mistakes
|
|
56
|
-
| **decision**
|
|
57
|
-
| **principle**
|
|
58
|
-
| **workflow**
|
|
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
|
|
167
|
-
|
|
168
|
-
| `route_intent`
|
|
169
|
-
| `search_intelligent`
|
|
170
|
-
| `vault_tags` / `vault_domains` | See what's already covered
|
|
171
|
-
| `capture_knowledge`
|
|
172
|
-
| `curator_detect_duplicates`
|
|
173
|
-
| `curator_groom_all`
|
|
174
|
-
| `curator_enrich`
|
|
175
|
-
| `curator_contradictions`
|
|
176
|
-
| `memory_promote_to_global`
|
|
177
|
-
| `admin_health`
|
|
178
|
-
| `admin_vault_analytics`
|
|
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 |
|
package/src/skills/onboard-me.md
CHANGED
|
@@ -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
|
|
184
|
-
|
|
185
|
-
| `identity`
|
|
186
|
-
| `project_get`
|
|
187
|
-
| `project_list_rules`
|
|
188
|
-
| `get_behavior_rules`
|
|
189
|
-
| `vault_domains` / `vault_tags` | Knowledge landscape
|
|
190
|
-
| `admin_vault_size`
|
|
191
|
-
| `search`
|
|
192
|
-
| `search_intelligent`
|
|
193
|
-
| `brain_strengths`
|
|
194
|
-
| `brain_global_patterns`
|
|
195
|
-
| `project_linked_projects`
|
|
196
|
-
| `admin_search_insights`
|
|
197
|
-
| `vault_age_report`
|
|
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 |
|