@soleri/forge 9.0.1 → 9.2.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/compose-claude-md.js +1 -1
- package/dist/compose-claude-md.js.map +1 -1
- package/dist/scaffold-filetree.js +8 -13
- package/dist/scaffold-filetree.js.map +1 -1
- package/dist/skills/brain-debrief/SKILL.md +16 -12
- package/dist/skills/brainstorming/SKILL.md +9 -5
- package/dist/skills/code-patrol/SKILL.md +7 -7
- package/dist/skills/context-resume/SKILL.md +14 -11
- package/dist/skills/deep-review/SKILL.md +186 -0
- package/dist/skills/executing-plans/SKILL.md +13 -9
- package/dist/skills/fix-and-learn/SKILL.md +12 -8
- package/dist/skills/health-check/SKILL.md +21 -17
- package/dist/skills/knowledge-harvest/SKILL.md +10 -6
- package/dist/skills/onboard-me/SKILL.md +19 -16
- package/dist/skills/parallel-execute/SKILL.md +277 -0
- package/dist/skills/retrospective/SKILL.md +18 -15
- package/dist/skills/second-opinion/SKILL.md +6 -6
- package/dist/skills/systematic-debugging/SKILL.md +12 -8
- package/dist/skills/test-driven-development/SKILL.md +5 -5
- package/dist/skills/vault-capture/SKILL.md +9 -5
- package/dist/skills/vault-navigator/SKILL.md +14 -10
- package/dist/skills/vault-smells/SKILL.md +251 -0
- package/dist/skills/verification-before-completion/SKILL.md +8 -5
- package/dist/skills/writing-plans/SKILL.md +14 -11
- package/dist/templates/agents-md.js +2 -2
- package/dist/templates/agents-md.js.map +1 -1
- package/dist/templates/claude-md-template.js +2 -2
- package/dist/templates/claude-md-template.js.map +1 -1
- package/dist/templates/shared-rules.js +35 -1
- package/dist/templates/shared-rules.js.map +1 -1
- package/dist/templates/skills.js +28 -6
- package/dist/templates/skills.js.map +1 -1
- package/dist/types.d.ts +1 -1
- package/dist/types.js +6 -2
- package/dist/types.js.map +1 -1
- package/package.json +1 -1
- package/src/__tests__/scaffolder.test.ts +17 -35
- package/src/compose-claude-md.ts +1 -1
- package/src/scaffold-filetree.ts +9 -13
- package/src/skills/brain-debrief/SKILL.md +16 -12
- package/src/skills/brainstorming/SKILL.md +9 -5
- package/src/skills/code-patrol/SKILL.md +7 -7
- package/src/skills/context-resume/SKILL.md +14 -11
- package/src/skills/deep-review/SKILL.md +186 -0
- package/src/skills/executing-plans/SKILL.md +13 -9
- package/src/skills/fix-and-learn/SKILL.md +12 -8
- package/src/skills/health-check/SKILL.md +21 -17
- package/src/skills/knowledge-harvest/SKILL.md +10 -6
- package/src/skills/onboard-me/SKILL.md +19 -16
- package/src/skills/parallel-execute/SKILL.md +277 -0
- package/src/skills/retrospective/SKILL.md +18 -15
- package/src/skills/second-opinion/SKILL.md +6 -6
- package/src/skills/systematic-debugging/SKILL.md +12 -8
- package/src/skills/test-driven-development/SKILL.md +5 -5
- package/src/skills/vault-capture/SKILL.md +9 -5
- package/src/skills/vault-navigator/SKILL.md +14 -10
- package/src/skills/vault-smells/SKILL.md +251 -0
- package/src/skills/verification-before-completion/SKILL.md +8 -5
- package/src/skills/writing-plans/SKILL.md +14 -11
- package/src/templates/agents-md.ts +2 -2
- package/src/templates/claude-md-template.ts +2 -2
- package/src/templates/shared-rules.ts +36 -1
- package/src/templates/skills.ts +27 -6
- package/src/types.ts +7 -2
|
@@ -106,7 +106,7 @@ function composeSessionStart(agent) {
|
|
|
106
106
|
return [
|
|
107
107
|
'## Session Start',
|
|
108
108
|
'',
|
|
109
|
-
`On every new session: \`${agent.id}_core op:
|
|
109
|
+
`On every new session: \`${agent.id}_core op:session_start params:{ projectPath: "." }\``,
|
|
110
110
|
].join('\n');
|
|
111
111
|
}
|
|
112
112
|
function composeToolsTable(agent, tools) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"compose-claude-md.js","sourceRoot":"","sources":["../src/compose-claude-md.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"compose-claude-md.js","sourceRoot":"","sources":["../src/compose-claude-md.ts"],"names":[],"mappings":"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"}
|
|
@@ -13,6 +13,7 @@ import { stringify as yamlStringify } from 'yaml';
|
|
|
13
13
|
import { AgentYamlSchema } from './agent-schema.js';
|
|
14
14
|
import { getEngineRulesContent } from './templates/shared-rules.js';
|
|
15
15
|
import { composeClaudeMd } from './compose-claude-md.js';
|
|
16
|
+
import { generateSkills } from './templates/skills.js';
|
|
16
17
|
const BUILTIN_WORKFLOWS = [
|
|
17
18
|
{
|
|
18
19
|
name: 'feature-dev',
|
|
@@ -215,6 +216,8 @@ export function scaffoldFileTree(input, outputDir) {
|
|
|
215
216
|
});
|
|
216
217
|
writeFile(agentDir, 'agent.yaml', agentYamlContent, filesCreated);
|
|
217
218
|
// ─── 3. Write .mcp.json ─────────────────────────────────────
|
|
219
|
+
// Scaffold uses npx as portable fallback. `soleri install` overwrites
|
|
220
|
+
// with resolved absolute path for instant startup (no npm resolution).
|
|
218
221
|
const mcpJson = {
|
|
219
222
|
mcpServers: {
|
|
220
223
|
'soleri-engine': {
|
|
@@ -267,19 +270,11 @@ export function scaffoldFileTree(input, outputDir) {
|
|
|
267
270
|
writeFile(agentDir, `workflows/${wf.name}/gates.yaml`, wf.gates, filesCreated);
|
|
268
271
|
writeFile(agentDir, `workflows/${wf.name}/tools.yaml`, wf.tools, filesCreated);
|
|
269
272
|
}
|
|
270
|
-
// ─── 8. Copy bundled skills
|
|
271
|
-
const
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
.map((d) => d.name);
|
|
276
|
-
for (const skillName of skillDirs) {
|
|
277
|
-
const skillFile = join(skillsSrcDir, skillName, 'SKILL.md');
|
|
278
|
-
if (existsSync(skillFile)) {
|
|
279
|
-
mkdirSync(join(agentDir, 'skills', skillName), { recursive: true });
|
|
280
|
-
writeFile(agentDir, `skills/${skillName}/SKILL.md`, readFileSync(skillFile, 'utf-8'), filesCreated);
|
|
281
|
-
}
|
|
282
|
-
}
|
|
273
|
+
// ─── 8. Copy bundled skills (with placeholder substitution) ─
|
|
274
|
+
const skills = generateSkills({ id: config.id });
|
|
275
|
+
for (const [relativePath, content] of skills) {
|
|
276
|
+
mkdirSync(join(agentDir, dirname(relativePath)), { recursive: true });
|
|
277
|
+
writeFile(agentDir, relativePath, content, filesCreated);
|
|
283
278
|
}
|
|
284
279
|
// ─── 9. Write knowledge bundles (seed from starter packs if available) ──
|
|
285
280
|
const starterPacksDir = resolveStarterPacksDir();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scaffold-filetree.js","sourceRoot":"","sources":["../src/scaffold-filetree.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"scaffold-filetree.js","sourceRoot":"","sources":["../src/scaffold-filetree.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: brain-debrief
|
|
3
|
-
description:
|
|
3
|
+
description: >
|
|
4
|
+
Use when the user wants to explore the brain's learned PATTERNS — "brain stats", "pattern
|
|
5
|
+
strengths", "what patterns are strongest", "intelligence report", "show brain data". Focused
|
|
6
|
+
on the brain module's accumulated pattern intelligence. For time-bound sprint or weekly
|
|
7
|
+
reflection, use retrospective instead.
|
|
4
8
|
---
|
|
5
9
|
|
|
6
10
|
# Brain Debrief — Intelligence Report
|
|
@@ -11,20 +15,20 @@ Surface what the brain has learned across sessions and projects. Turns raw vault
|
|
|
11
15
|
|
|
12
16
|
### "What have I learned?" (General debrief)
|
|
13
17
|
|
|
14
|
-
1. `
|
|
15
|
-
2. `
|
|
16
|
-
3. `
|
|
17
|
-
4. `
|
|
18
|
-
5. `
|
|
18
|
+
1. `YOUR_AGENT_core op:brain_stats` — total sessions, patterns, quality scores
|
|
19
|
+
2. `YOUR_AGENT_core op:brain_strengths` — patterns ranked by strength (focus >= 70)
|
|
20
|
+
3. `YOUR_AGENT_core op:memory_topics` — knowledge clusters
|
|
21
|
+
4. `YOUR_AGENT_core op:vault_age_report` — stale entries needing refresh
|
|
22
|
+
5. `YOUR_AGENT_core op:curator_health_audit` — vault quality score
|
|
19
23
|
|
|
20
24
|
Present: top 5 patterns, top 3 anti-patterns, stale entries, coverage gaps.
|
|
21
25
|
|
|
22
26
|
### "What's working across projects?" (Cross-project)
|
|
23
27
|
|
|
24
|
-
1. `
|
|
25
|
-
2. `
|
|
26
|
-
3. `
|
|
27
|
-
4. `
|
|
28
|
+
1. `YOUR_AGENT_core op:brain_global_patterns` — promoted patterns
|
|
29
|
+
2. `YOUR_AGENT_core op:brain_recommend params: { projectName: "<project>" }` — similarity-based recommendations
|
|
30
|
+
3. `YOUR_AGENT_core op:project_linked_projects` — connected projects
|
|
31
|
+
4. `YOUR_AGENT_core op:memory_cross_project_search params: { query: "<topic>", crossProject: true }`
|
|
28
32
|
|
|
29
33
|
### "Am I getting smarter?" (Learning velocity)
|
|
30
34
|
|
|
@@ -32,8 +36,8 @@ Compare `brain_stats` for 7-day vs 30-day periods. Check `memory_stats`, `admin_
|
|
|
32
36
|
|
|
33
37
|
### "Build fresh intelligence" (Rebuild)
|
|
34
38
|
|
|
35
|
-
1. `
|
|
36
|
-
2. `
|
|
39
|
+
1. `YOUR_AGENT_core op:brain_build_intelligence` — full pipeline rebuild
|
|
40
|
+
2. `YOUR_AGENT_core op:curator_consolidate` — vault cleanup
|
|
37
41
|
3. Show updated `brain_stats`
|
|
38
42
|
|
|
39
43
|
### "Export what I know" (Portability)
|
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: brainstorming
|
|
3
|
-
description:
|
|
3
|
+
description: >
|
|
4
|
+
Use for open-ended creative exploration when requirements are NOT yet clear — "I want to build
|
|
5
|
+
something", "let's think about", "explore options for", "what if we". Explores intent and
|
|
6
|
+
design before implementation. If the user already has a spec or clear requirements, use
|
|
7
|
+
writing-plans instead.
|
|
4
8
|
---
|
|
5
9
|
|
|
6
10
|
# Brainstorming Ideas Into Designs
|
|
@@ -15,8 +19,8 @@ Do NOT invoke any implementation skill, write any code, scaffold any project, or
|
|
|
15
19
|
|
|
16
20
|
Complete in order:
|
|
17
21
|
|
|
18
|
-
1. **Classify intent** — `
|
|
19
|
-
2. **Search vault for prior art** — `
|
|
22
|
+
1. **Classify intent** — `YOUR_AGENT_core op:route_intent`
|
|
23
|
+
2. **Search vault for prior art** — `YOUR_AGENT_core op:search_intelligent`
|
|
20
24
|
3. **Search web for existing solutions** — don't build what already exists
|
|
21
25
|
4. **Explore project context** — check files, docs, recent commits
|
|
22
26
|
5. **Ask clarifying questions** — one at a time, purpose/constraints/success criteria
|
|
@@ -31,7 +35,7 @@ Complete in order:
|
|
|
31
35
|
### Vault First
|
|
32
36
|
|
|
33
37
|
```
|
|
34
|
-
|
|
38
|
+
YOUR_AGENT_core op:search_intelligent
|
|
35
39
|
params: { query: "<the feature or idea>" }
|
|
36
40
|
```
|
|
37
41
|
|
|
@@ -54,7 +58,7 @@ Present findings: "Before we design this, here's what I found..."
|
|
|
54
58
|
**Capture the decision:**
|
|
55
59
|
|
|
56
60
|
```
|
|
57
|
-
|
|
61
|
+
YOUR_AGENT_core op:capture_knowledge
|
|
58
62
|
params: {
|
|
59
63
|
title: "<feature> — design decision",
|
|
60
64
|
description: "<chosen approach, rationale, rejected alternatives>",
|
|
@@ -12,22 +12,22 @@ Review code against vault patterns, anti-patterns, and project conventions. Catc
|
|
|
12
12
|
### 1. Understand the Code's Domain
|
|
13
13
|
|
|
14
14
|
```
|
|
15
|
-
|
|
15
|
+
YOUR_AGENT_core op:route_intent
|
|
16
16
|
params: { prompt: "Code review: <brief description>" }
|
|
17
|
-
|
|
17
|
+
YOUR_AGENT_core op:vault_domains
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
### 2. Load Relevant Patterns
|
|
21
21
|
|
|
22
22
|
```
|
|
23
|
-
|
|
23
|
+
YOUR_AGENT_core op:search_intelligent
|
|
24
24
|
params: { query: "<what this code does>" }
|
|
25
|
-
|
|
25
|
+
YOUR_AGENT_core op:search
|
|
26
26
|
params: { type: "anti-pattern" }
|
|
27
|
-
|
|
27
|
+
YOUR_AGENT_core op:search
|
|
28
28
|
params: { severity: "critical" }
|
|
29
|
-
|
|
30
|
-
|
|
29
|
+
YOUR_AGENT_core op:project_list_rules
|
|
30
|
+
YOUR_AGENT_core op:brain_strengths
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
### 3. Review the Code
|
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: context-resume
|
|
3
|
-
description:
|
|
3
|
+
description: >
|
|
4
|
+
Use when the user says "where did I leave off", "what was I working on", "catch me up",
|
|
5
|
+
"resume", "continue where we stopped", or is starting a new session and needs to reconstruct
|
|
6
|
+
working context from memory, plans, and sessions.
|
|
4
7
|
---
|
|
5
8
|
|
|
6
9
|
# Context Resume — Pick Up Where You Left Off
|
|
@@ -12,9 +15,9 @@ Reconstruct full working context in seconds. Chains memory, plans, sessions, and
|
|
|
12
15
|
### 1. Load Active Plans
|
|
13
16
|
|
|
14
17
|
```
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
+
YOUR_AGENT_core op:plan_stats
|
|
19
|
+
YOUR_AGENT_core op:get_plan
|
|
20
|
+
YOUR_AGENT_core op:plan_list_tasks
|
|
18
21
|
params: { planId: "<id>" }
|
|
19
22
|
```
|
|
20
23
|
|
|
@@ -23,29 +26,29 @@ Present: plan objective, task status (completed/in-progress/pending), what's nex
|
|
|
23
26
|
### 2. Search Recent Memory
|
|
24
27
|
|
|
25
28
|
```
|
|
26
|
-
|
|
29
|
+
YOUR_AGENT_core op:memory_search
|
|
27
30
|
params: { query: "session summary" }
|
|
28
|
-
|
|
29
|
-
|
|
31
|
+
YOUR_AGENT_core op:memory_list
|
|
32
|
+
YOUR_AGENT_core op:vault_recent
|
|
30
33
|
```
|
|
31
34
|
|
|
32
35
|
### 3. Check Active Loops
|
|
33
36
|
|
|
34
37
|
```
|
|
35
|
-
|
|
36
|
-
|
|
38
|
+
YOUR_AGENT_core op:loop_is_active
|
|
39
|
+
YOUR_AGENT_core op:loop_status
|
|
37
40
|
```
|
|
38
41
|
|
|
39
42
|
### 4. Brain Snapshot
|
|
40
43
|
|
|
41
44
|
```
|
|
42
|
-
|
|
45
|
+
YOUR_AGENT_core op:brain_strengths
|
|
43
46
|
```
|
|
44
47
|
|
|
45
48
|
### 5. System Health
|
|
46
49
|
|
|
47
50
|
```
|
|
48
|
-
|
|
51
|
+
YOUR_AGENT_core op:admin_health
|
|
49
52
|
```
|
|
50
53
|
|
|
51
54
|
## Presenting the Resume
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: deep-review
|
|
3
|
+
description: >
|
|
4
|
+
Use for in-depth code review beyond linting — architecture fitness, code smells, solution quality,
|
|
5
|
+
optimization opportunities. Triggers on "deep review", "review this code", "is this well architected",
|
|
6
|
+
"code smells", "review this module", "architecture review", "is this the right approach",
|
|
7
|
+
"optimization review". Works on any codebase. For vault-specific knowledge quality, use vault-smells instead.
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Deep Review — Architecture, Smells & Solution Quality
|
|
11
|
+
|
|
12
|
+
Multi-pass code review that goes beyond surface lint. Analyzes structural health, code smells, architectural fitness, and solution quality. Works on any codebase — vault context is optional enrichment, not a requirement.
|
|
13
|
+
|
|
14
|
+
## Input
|
|
15
|
+
|
|
16
|
+
The user provides a **target**: file, module, directory, PR diff, or function. If unclear, ask.
|
|
17
|
+
|
|
18
|
+
## The Three Passes
|
|
19
|
+
|
|
20
|
+
### Pass 1: Structural Analysis & Code Smells
|
|
21
|
+
|
|
22
|
+
**Metrics** (gather by reading the code):
|
|
23
|
+
- File length and function count
|
|
24
|
+
- Cyclomatic complexity (nesting depth, branch count)
|
|
25
|
+
- Dependency count — imports from how many modules?
|
|
26
|
+
- Export surface area — how much is public vs. should be internal?
|
|
27
|
+
|
|
28
|
+
**Structural Smells:**
|
|
29
|
+
- **God file/class** — too many responsibilities, >300 lines with mixed concerns
|
|
30
|
+
- **Long parameter lists** — function takes 5+ params (should be an object/config)
|
|
31
|
+
- **Deep nesting** — 4+ levels of if/for/try/catch
|
|
32
|
+
- **Shotgun surgery** — changing this code requires touching 5+ other files
|
|
33
|
+
- **Primitive obsession** — passing raw strings/numbers instead of domain types
|
|
34
|
+
- **Boolean blindness** — functions with multiple boolean params (`fn(true, false, true)`)
|
|
35
|
+
|
|
36
|
+
**Duplication Smells:**
|
|
37
|
+
- Copy-paste with slight variations
|
|
38
|
+
- Repeated conditional logic — same if-chain in 3+ places
|
|
39
|
+
- Parallel structures that always change together
|
|
40
|
+
|
|
41
|
+
**Temporal Smells** (check git history):
|
|
42
|
+
- Files that always change together but live in different modules → missing abstraction
|
|
43
|
+
- Functions that get patched repeatedly → wrong abstraction
|
|
44
|
+
- High churn files → instability signal
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
git log --format=format: --name-only --since="3 months ago" <target-path> | sort | uniq -c | sort -rn | head -20
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Present findings before moving to Pass 2.
|
|
51
|
+
|
|
52
|
+
### Pass 2: Architectural Fitness
|
|
53
|
+
|
|
54
|
+
**Dependency Direction:**
|
|
55
|
+
- Do dependencies flow in the right direction? (Outer layers depend on inner, not reverse)
|
|
56
|
+
- Are there circular dependencies?
|
|
57
|
+
- Does the code reach across module boundaries it shouldn't?
|
|
58
|
+
|
|
59
|
+
**Abstraction Level:**
|
|
60
|
+
- Is this the right level of abstraction for the problem?
|
|
61
|
+
- Over-engineered? (abstraction for one use case, premature generalization)
|
|
62
|
+
- Under-engineered? (inline logic that should be extracted)
|
|
63
|
+
|
|
64
|
+
**Cohesion & Coupling:**
|
|
65
|
+
- Does everything in this module belong together? (high cohesion)
|
|
66
|
+
- Is the module tangled with others? (low coupling desired)
|
|
67
|
+
- Feature envy — does a function touch another module's internals more than its own?
|
|
68
|
+
|
|
69
|
+
**Vault Context** (optional — only if vault is connected):
|
|
70
|
+
|
|
71
|
+
```
|
|
72
|
+
YOUR_AGENT_core op:search_intelligent
|
|
73
|
+
params: { query: "<module name> architecture pattern" }
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
If vault has relevant patterns, check alignment. If not, skip — this pass works without vault.
|
|
77
|
+
|
|
78
|
+
### Pass 3: Solution Quality Assessment
|
|
79
|
+
|
|
80
|
+
**Simplification:**
|
|
81
|
+
- Is there a simpler way to achieve the same result?
|
|
82
|
+
- Could any abstraction be removed without loss?
|
|
83
|
+
- Are there standard library/framework features that replace custom code?
|
|
84
|
+
|
|
85
|
+
**Edge Cases:**
|
|
86
|
+
- What inputs would break this?
|
|
87
|
+
- Are error paths handled or just the happy path?
|
|
88
|
+
- What happens with empty/null/undefined inputs?
|
|
89
|
+
- Concurrency: race conditions, shared mutable state?
|
|
90
|
+
|
|
91
|
+
**Performance:**
|
|
92
|
+
- Any O(n²) or worse hidden in loops?
|
|
93
|
+
- Unnecessary allocations, copies, or serialization?
|
|
94
|
+
- N+1 query patterns?
|
|
95
|
+
- Unbounded growth (arrays/maps that grow without limit)?
|
|
96
|
+
|
|
97
|
+
**Evolutionary Fitness:**
|
|
98
|
+
- How does this code age? Easy to modify in 6 months?
|
|
99
|
+
- Does it create "gravity" — attracting more complexity over time?
|
|
100
|
+
- Are extension points in the right places?
|
|
101
|
+
|
|
102
|
+
## Presenting the Report
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
## Deep Review: [target name]
|
|
106
|
+
|
|
107
|
+
### Structural Health
|
|
108
|
+
| Metric | Value | Verdict |
|
|
109
|
+
|--------|-------|---------|
|
|
110
|
+
| Lines | X | OK / ⚠️ Large |
|
|
111
|
+
| Functions | X | OK / ⚠️ Many |
|
|
112
|
+
| Max nesting | X | OK / ⚠️ Deep |
|
|
113
|
+
| Dependencies | X | OK / ⚠️ Heavy |
|
|
114
|
+
| Export surface | X public / Y total | OK / ⚠️ Wide |
|
|
115
|
+
|
|
116
|
+
### Code Smells
|
|
117
|
+
| Smell | Location | Severity | Detail |
|
|
118
|
+
|-------|----------|----------|--------|
|
|
119
|
+
| God file | file.ts | ⚠️ | 450 lines, 3 mixed concerns |
|
|
120
|
+
| Feature envy | fn() → other module | ⚠️ | Reaches into X internals |
|
|
121
|
+
| Deep nesting | line 120-180 | 💡 | 5 levels, consider early returns |
|
|
122
|
+
|
|
123
|
+
### Architecture
|
|
124
|
+
| Aspect | Assessment |
|
|
125
|
+
|--------|------------|
|
|
126
|
+
| Dependency direction | ✅ Clean / ⚠️ Reverse dep on X |
|
|
127
|
+
| Abstraction level | ✅ Right / ⚠️ Over/Under |
|
|
128
|
+
| Cohesion | ✅ High / ⚠️ Mixed concerns |
|
|
129
|
+
| Coupling | ✅ Low / ⚠️ Tight with X |
|
|
130
|
+
|
|
131
|
+
### Solution Quality
|
|
132
|
+
| Area | Finding |
|
|
133
|
+
|------|---------|
|
|
134
|
+
| Simplification | [opportunity or "none found"] |
|
|
135
|
+
| Edge cases | [gaps found or "well covered"] |
|
|
136
|
+
| Performance | [concerns or "no issues"] |
|
|
137
|
+
| Evolutionary fitness | [assessment] |
|
|
138
|
+
|
|
139
|
+
### Recommendations
|
|
140
|
+
| Priority | Action | Impact |
|
|
141
|
+
|----------|--------|--------|
|
|
142
|
+
| 1 | [most impactful] | High |
|
|
143
|
+
| 2 | [second] | Medium |
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
## Severity Scale
|
|
147
|
+
|
|
148
|
+
| Level | Meaning |
|
|
149
|
+
|-------|---------|
|
|
150
|
+
| ✅ | Clean — no action needed |
|
|
151
|
+
| 💡 | Info — worth knowing, low priority |
|
|
152
|
+
| ⚠️ | Warning — should fix, causes friction |
|
|
153
|
+
| 🔴 | Critical — fix before shipping, causes bugs or blocks scaling |
|
|
154
|
+
|
|
155
|
+
## Capturing Learnings (Optional)
|
|
156
|
+
|
|
157
|
+
If the review uncovers a pattern or anti-pattern worth remembering:
|
|
158
|
+
|
|
159
|
+
```
|
|
160
|
+
YOUR_AGENT_core op:capture_knowledge
|
|
161
|
+
params: {
|
|
162
|
+
title: "<pattern name>",
|
|
163
|
+
description: "<what was found, why it matters>",
|
|
164
|
+
type: "pattern" | "anti-pattern",
|
|
165
|
+
category: "architecture",
|
|
166
|
+
tags: ["code-review", "<specific-tag>"]
|
|
167
|
+
}
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
Only capture if genuinely reusable — not every review finding is vault-worthy.
|
|
171
|
+
|
|
172
|
+
## Common Mistakes
|
|
173
|
+
|
|
174
|
+
- Reviewing without reading the full file first (missing context)
|
|
175
|
+
- Reporting every minor style issue as a "smell" (noise kills signal)
|
|
176
|
+
- Suggesting rewrites when the code is adequate (perfect is the enemy of good)
|
|
177
|
+
- Skipping git history (temporal smells are the most actionable)
|
|
178
|
+
- Treating all smells as equal severity (prioritize by impact)
|
|
179
|
+
|
|
180
|
+
## Quick Reference
|
|
181
|
+
|
|
182
|
+
| Pass | Focus | Key Activities |
|
|
183
|
+
|------|-------|----------------|
|
|
184
|
+
| 1. Structural | Metrics + Smells | Read code, check complexity, find smells, check git history |
|
|
185
|
+
| 2. Architecture | Fitness | Dependency direction, abstraction level, cohesion/coupling |
|
|
186
|
+
| 3. Solution | Quality | Simplification, edge cases, performance, evolution |
|
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: executing-plans
|
|
3
|
-
description:
|
|
3
|
+
description: >
|
|
4
|
+
Use when the user says "execute my plan", "run the plan", "start executing", "implement the
|
|
5
|
+
plan step by step", or has a written plan to execute sequentially with review checkpoints.
|
|
6
|
+
Tasks run one at a time in order. If tasks are independent and can run in parallel, use
|
|
7
|
+
parallel-execute instead.
|
|
4
8
|
---
|
|
5
9
|
|
|
6
10
|
# Executing Plans
|
|
@@ -14,10 +18,10 @@ Load plan, review critically, execute tasks in batches, report for review betwee
|
|
|
14
18
|
### Step 1: Load and Review Plan
|
|
15
19
|
|
|
16
20
|
```
|
|
17
|
-
|
|
18
|
-
|
|
21
|
+
YOUR_AGENT_core op:get_plan
|
|
22
|
+
YOUR_AGENT_core op:plan_list_tasks
|
|
19
23
|
params: { planId: "<id>" }
|
|
20
|
-
|
|
24
|
+
YOUR_AGENT_core op:plan_stats
|
|
21
25
|
```
|
|
22
26
|
|
|
23
27
|
If no tracked plan exists, read from `docs/plans/`. Review critically — raise concerns before starting.
|
|
@@ -25,7 +29,7 @@ If no tracked plan exists, read from `docs/plans/`. Review critically — raise
|
|
|
25
29
|
### Step 2: Start Execution Loop
|
|
26
30
|
|
|
27
31
|
```
|
|
28
|
-
|
|
32
|
+
YOUR_AGENT_core op:loop_start
|
|
29
33
|
params: { prompt: "<plan objective>", mode: "custom" }
|
|
30
34
|
```
|
|
31
35
|
|
|
@@ -49,10 +53,10 @@ Apply feedback, execute next batch, repeat until complete.
|
|
|
49
53
|
### Step 6: Complete Development
|
|
50
54
|
|
|
51
55
|
1. Run final verification (use verification-before-completion skill)
|
|
52
|
-
2. `
|
|
53
|
-
3. `
|
|
54
|
-
4. `
|
|
55
|
-
5. `
|
|
56
|
+
2. `YOUR_AGENT_core op:loop_complete`
|
|
57
|
+
3. `YOUR_AGENT_core op:plan_reconcile` — compare planned vs actual
|
|
58
|
+
4. `YOUR_AGENT_core op:plan_complete_lifecycle` — extract knowledge, archive
|
|
59
|
+
5. `YOUR_AGENT_core op:session_capture` — save session context
|
|
56
60
|
|
|
57
61
|
Capture mid-execution learnings with `op:capture_quick` as they happen — don't wait until the end.
|
|
58
62
|
|
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: fix-and-learn
|
|
3
|
-
description:
|
|
3
|
+
description: >
|
|
4
|
+
Use AFTER a root cause has been identified (typically via systematic-debugging) to execute
|
|
5
|
+
the fix and capture the learning in the vault. Triggers on "fix it", "apply the fix",
|
|
6
|
+
"patch this and remember". Do NOT use as the first response to a bug — use
|
|
7
|
+
systematic-debugging first to find root cause.
|
|
4
8
|
---
|
|
5
9
|
|
|
6
10
|
# Fix & Learn — Debug, Repair, Capture
|
|
@@ -21,16 +25,16 @@ Fix bugs through a structured recovery workflow, then capture the root cause as
|
|
|
21
25
|
### Step 1: Classify and Route
|
|
22
26
|
|
|
23
27
|
```
|
|
24
|
-
|
|
28
|
+
YOUR_AGENT_core op:route_intent
|
|
25
29
|
params: { prompt: "<bug description>" }
|
|
26
30
|
```
|
|
27
31
|
|
|
28
32
|
### Step 2: Check Vault First
|
|
29
33
|
|
|
30
34
|
```
|
|
31
|
-
|
|
35
|
+
YOUR_AGENT_core op:search_intelligent
|
|
32
36
|
params: { query: "<error message or bug description>" }
|
|
33
|
-
|
|
37
|
+
YOUR_AGENT_core op:memory_search
|
|
34
38
|
params: { query: "<bug description>" }
|
|
35
39
|
```
|
|
36
40
|
|
|
@@ -43,7 +47,7 @@ If vault has no answer, search for known issues, Stack Overflow answers, GitHub
|
|
|
43
47
|
### Step 4: Start Fix Loop
|
|
44
48
|
|
|
45
49
|
```
|
|
46
|
-
|
|
50
|
+
YOUR_AGENT_core op:loop_start
|
|
47
51
|
params: { prompt: "Fix: <bug description>", mode: "custom" }
|
|
48
52
|
```
|
|
49
53
|
|
|
@@ -59,12 +63,12 @@ If Steps 2-3 didn't produce a solution, use systematic-debugging skill:
|
|
|
59
63
|
|
|
60
64
|
### Step 6: Validate
|
|
61
65
|
|
|
62
|
-
Run test suite. Use verification-before-completion skill. Complete loop: `
|
|
66
|
+
Run test suite. Use verification-before-completion skill. Complete loop: `YOUR_AGENT_core op:loop_complete`.
|
|
63
67
|
|
|
64
68
|
### Step 7: Capture the Learning
|
|
65
69
|
|
|
66
70
|
```
|
|
67
|
-
|
|
71
|
+
YOUR_AGENT_core op:capture_knowledge
|
|
68
72
|
params: {
|
|
69
73
|
title: "<bug title>",
|
|
70
74
|
description: "<root cause, solution, what made it hard to find>",
|
|
@@ -74,7 +78,7 @@ ernesto_core op:capture_knowledge
|
|
|
74
78
|
}
|
|
75
79
|
```
|
|
76
80
|
|
|
77
|
-
Run `
|
|
81
|
+
Run `YOUR_AGENT_core op:curator_detect_duplicates` to avoid redundant entries.
|
|
78
82
|
|
|
79
83
|
## Exit Criteria
|
|
80
84
|
|