@soleri/forge 9.2.0 → 9.3.0

package/dist/skills/systematic-debugging/SKILL.md

@@ -91,13 +91,13 @@ YOUR_AGENT_core op:session_capture
 
 ## Quick Reference
 
-| Phase | Key Activities | Tools |
-|-------|---------------|-------|
-| 0. Search | Vault, web, memory | `search_intelligent`, `brain_strengths`, `memory_search` |
-| 1. Root Cause | Read errors, reproduce, trace | `loop_iterate` |
-| 2. Pattern | Find working examples, compare | `search_intelligent` |
-| 3. Hypothesis | Form theory, test minimally | `loop_iterate` |
-| 4. Implementation | Test, fix, verify | `loop_iterate` |
-| 5. Capture | Persist root cause | `capture_knowledge`, `loop_complete` |
+| Phase             | Key Activities                 | Tools                                                    |
+| ----------------- | ------------------------------ | -------------------------------------------------------- |
+| 0. Search         | Vault, web, memory             | `search_intelligent`, `brain_strengths`, `memory_search` |
+| 1. Root Cause     | Read errors, reproduce, trace  | `loop_iterate`                                           |
+| 2. Pattern        | Find working examples, compare | `search_intelligent`                                     |
+| 3. Hypothesis     | Form theory, test minimally    | `loop_iterate`                                           |
+| 4. Implementation | Test, fix, verify              | `loop_iterate`                                           |
+| 5. Capture        | Persist root cause             | `capture_knowledge`, `loop_complete`                     |
 
 **Related skills:** test-driven-development, verification-before-completion, fix-and-learn

package/dist/skills/test-driven-development/SKILL.md

@@ -75,17 +75,17 @@ YOUR_AGENT_core op:capture_quick
 - Test passes immediately (testing existing behavior, not new)
 - Multiple behaviors in one test ("and" in name means split it)
 
-| Problem | Solution |
-|---------|----------|
-| Don't know how to test | Write wished-for API first |
-| Must mock everything | Code too coupled — use DI |
-| Test setup huge | Extract helpers or simplify design |
+| Problem                | Solution                           |
+| ---------------------- | ---------------------------------- |
+| Don't know how to test | Write wished-for API first         |
+| Must mock everything   | Code too coupled — use DI          |
+| Test setup huge        | Extract helpers or simplify design |
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `search_intelligent` | Find testing patterns |
-| `brain_strengths` | Proven testing approaches |
-| `loop_start` / `loop_iterate` / `loop_complete` | TDD cycle tracking |
-| `capture_quick` | Capture new testing patterns |
+| Op                                              | When to Use                  |
+| ----------------------------------------------- | ---------------------------- |
+| `search_intelligent`                            | Find testing patterns        |
+| `brain_strengths`                               | Proven testing approaches    |
+| `loop_start` / `loop_iterate` / `loop_complete` | TDD cycle tracking           |
+| `capture_quick`                                 | Capture new testing patterns |

package/dist/skills/vault-capture/SKILL.md

@@ -25,13 +25,13 @@ If similar entry exists, update it instead of creating a duplicate.
 
 ### 2. Classify the Knowledge
 
-| Type | Description |
-|------|-------------|
-| **pattern** | Works and should be repeated |
-| **anti-pattern** | Fails and should be avoided |
-| **workflow** | Steps for a specific task |
-| **principle** | Guiding rule or heuristic |
-| **decision** | Architectural choice with rationale |
+| Type             | Description                         |
+| ---------------- | ----------------------------------- |
+| **pattern**      | Works and should be repeated        |
+| **anti-pattern** | Fails and should be avoided         |
+| **workflow**     | Steps for a specific task           |
+| **principle**    | Guiding rule or heuristic           |
+| **decision**     | Architectural choice with rationale |
 
 ### 3. Capture
 
@@ -76,11 +76,11 @@ For cross-project knowledge: `op:memory_promote_to_global params: { entryId: "<i
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `search_intelligent` | Check for duplicates |
-| `capture_knowledge` / `capture_quick` | Persist to vault |
-| `curator_groom` / `curator_enrich` | Post-capture quality |
-| `curator_contradictions` | Find conflicts |
-| `memory_promote_to_global` | Share cross-project |
-| `admin_health` | Verify health |
+| Op                                    | When to Use          |
+| ------------------------------------- | -------------------- |
+| `search_intelligent`                  | Check for duplicates |
+| `capture_knowledge` / `capture_quick` | Persist to vault     |
+| `curator_groom` / `curator_enrich`    | Post-capture quality |
+| `curator_contradictions`              | Find conflicts       |
+| `memory_promote_to_global`            | Share cross-project  |
+| `admin_health`                        | Verify health        |

package/dist/skills/vault-navigator/SKILL.md

@@ -72,13 +72,13 @@ If all vault strategies return nothing, search the web. If web finds something u
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `search_intelligent` | Default semantic search |
-| `search` | Structured search with filters |
-| `vault_tags` / `vault_domains` | Browse knowledge landscape |
-| `vault_recent` | Recently modified entries |
-| `vault_age_report` | Stale entries |
-| `memory_cross_project_search` | Cross-project search |
-| `brain_strengths` / `brain_global_patterns` | Proven patterns |
-| `capture_quick` | Capture web findings |
+| Op                                          | When to Use                    |
+| ------------------------------------------- | ------------------------------ |
+| `search_intelligent`                        | Default semantic search        |
+| `search`                                    | Structured search with filters |
+| `vault_tags` / `vault_domains`              | Browse knowledge landscape     |
+| `vault_recent`                              | Recently modified entries      |
+| `vault_age_report`                          | Stale entries                  |
+| `memory_cross_project_search`               | Cross-project search           |
+| `brain_strengths` / `brain_global_patterns` | Proven patterns                |
+| `capture_quick`                             | Capture web findings           |

package/dist/skills/vault-smells/SKILL.md

@@ -23,6 +23,7 @@ YOUR_AGENT_core op:curator_contradictions
 ```
 
 **What to look for:**
+
 - Two patterns that recommend opposite approaches for the same situation
 - An anti-pattern that contradicts an active pattern
 - Entries from different time periods with conflicting advice (the older one may be stale)
@@ -38,6 +39,7 @@ YOUR_AGENT_core op:vault_age_report
 ```
 
 **Indicators:**
+
 - Entries >60 days without access or update
 - Patterns referencing APIs, libraries, or versions that have changed
 - Entries tagged with technologies the project no longer uses
@@ -55,6 +57,7 @@ YOUR_AGENT_core op:curator_detect_duplicates
 ```
 
 **Indicators:**
+
 - Entries with zero inbound or outbound links
 - Entries never returned in search results (check search insights)
 - Entries with no tags or only generic tags
@@ -73,6 +76,7 @@ YOUR_AGENT_core op:curator_detect_duplicates
 ```
 
 **Indicators:**
+
 - High similarity scores between entries
 - Same tags and category but different titles
 - Entries captured in different sessions about the same topic
@@ -89,6 +93,7 @@ YOUR_AGENT_core op:curator_health_audit
 ```
 
 **Indicators:**
+
 - Description under 50 characters
 - No examples or context
 - Missing "why" — only states "what" without rationale
@@ -107,6 +112,7 @@ YOUR_AGENT_core op:vault_tags
 ```
 
 **Indicators:**
+
 - Near-duplicate categories (e.g., "error-handling" and "errors" and "exception-handling")
 - Categories with only 1-2 entries (too granular)
 - Tags used inconsistently (same concept, different tag names)
@@ -123,6 +129,7 @@ YOUR_AGENT_core op:brain_strengths
 ```
 
 **Indicators:**
+
 - Patterns with high initial strength that have decayed below 0.3
 - Patterns that were strong but haven't received positive feedback in >30 days
 - Patterns with mixed feedback (both positive and negative) — unresolved
@@ -131,13 +138,14 @@ YOUR_AGENT_core op:brain_strengths
 
 ### 8. Knowledge Gap Smells
 
-Areas where the vault *should* have knowledge but doesn't.
+Areas where the vault _should_ have knowledge but doesn't.
 
 ```
 YOUR_AGENT_core op:admin_search_insights
 ```
 
 **Indicators:**
+
 - Repeated search queries that return no results
 - Domains the project uses but vault has no entries for
 - Anti-patterns captured without corresponding patterns (what to do instead?)
@@ -166,11 +174,11 @@ YOUR_AGENT_core op:admin_search_insights
 
 For each smell category, assess severity:
 
-| Severity | Meaning |
-|----------|---------|
-| 🟢 Clean | No issues in this category |
-| 🟡 Minor | 1-3 instances, low impact |
-| 🟠 Moderate | Multiple instances, degrading quality |
+| Severity    | Meaning                                    |
+| ----------- | ------------------------------------------ |
+| 🟢 Clean    | No issues in this category                 |
+| 🟡 Minor    | 1-3 instances, low impact                  |
+| 🟠 Moderate | Multiple instances, degrading quality      |
 | 🔴 Critical | Widespread, actively causing bad decisions |
 
 ### Step 3: Present the Report
@@ -237,15 +245,15 @@ After fixes: `op:brain_build_intelligence` to rebuild with clean data.
 
 ## Quick Reference
 
-| Smell | Detection Op | Fix Op |
-|-------|-------------|--------|
-| Contradictions | `curator_contradictions` | `curator_resolve_contradiction` |
-| Staleness | `vault_age_report` | Review + archive/update |
-| Orphans | `admin_vault_analytics` | Link or archive |
-| Duplicates | `curator_detect_duplicates` | `curator_groom` (merge) |
-| Shallow entries | `curator_health_audit` | Enrich or archive |
-| Category drift | `vault_domains` + `vault_tags` | `curator_groom_all` |
-| Confidence decay | `brain_strengths` | Reinforce or retire |
-| Knowledge gaps | `admin_search_insights` | `capture_knowledge` |
+| Smell            | Detection Op                   | Fix Op                          |
+| ---------------- | ------------------------------ | ------------------------------- |
+| Contradictions   | `curator_contradictions`       | `curator_resolve_contradiction` |
+| Staleness        | `vault_age_report`             | Review + archive/update         |
+| Orphans          | `admin_vault_analytics`        | Link or archive                 |
+| Duplicates       | `curator_detect_duplicates`    | `curator_groom` (merge)         |
+| Shallow entries  | `curator_health_audit`         | Enrich or archive               |
+| Category drift   | `vault_domains` + `vault_tags` | `curator_groom_all`             |
+| Confidence decay | `brain_strengths`              | Reinforce or retire             |
+| Knowledge gaps   | `admin_search_insights`        | `capture_knowledge`             |
 
 **Related skills:** health-check (operational status), vault-curate (active cleanup), knowledge-harvest (fill gaps)

package/dist/skills/verification-before-completion/SKILL.md

@@ -43,12 +43,12 @@ If any check reports problems, address before claiming completion.
 
 ## Common Failures
 
-| Claim | Requires | Not Sufficient |
-|-------|----------|----------------|
-| Tests pass | Test output: 0 failures | Previous run, "should pass" |
-| Build succeeds | Build command: exit 0 | Linter passing |
-| Bug fixed | Original symptom passes | "Code changed, assumed fixed" |
-| Requirements met | Line-by-line checklist | Tests passing alone |
+| Claim            | Requires                | Not Sufficient                |
+| ---------------- | ----------------------- | ----------------------------- |
+| Tests pass       | Test output: 0 failures | Previous run, "should pass"   |
+| Build succeeds   | Build command: exit 0   | Linter passing                |
+| Bug fixed        | Original symptom passes | "Code changed, assumed fixed" |
+| Requirements met | Line-by-line checklist  | Tests passing alone           |
 
 ## Red Flags — STOP
 
@@ -57,12 +57,12 @@ If any check reports problems, address before claiming completion.
 - About to commit/push/PR without verification
 - Relying on partial verification
 
-| Excuse | Reality |
-|--------|---------|
-| "Should work now" | RUN the verification |
-| "I'm confident" | Confidence is not evidence |
-| "Just this once" | No exceptions |
-| "Partial check is enough" | Partial proves nothing |
+| Excuse                    | Reality                    |
+| ------------------------- | -------------------------- |
+| "Should work now"         | RUN the verification       |
+| "I'm confident"           | Confidence is not evidence |
+| "Just this once"          | No exceptions              |
+| "Partial check is enough" | Partial proves nothing     |
 
 ## After Verification
 
@@ -77,9 +77,9 @@ Capture session summary: `YOUR_AGENT_core op:session_capture params: { summary:
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `admin_health` | Quick system health check |
-| `admin_diagnostic` | Comprehensive diagnostic |
-| `admin_vault_analytics` | Knowledge quality metrics |
-| `session_capture` | Persist verified completion context |
+| Op                      | When to Use                         |
+| ----------------------- | ----------------------------------- |
+| `admin_health`          | Quick system health check           |
+| `admin_diagnostic`      | Comprehensive diagnostic            |
+| `admin_vault_analytics` | Knowledge quality metrics           |
+| `session_capture`       | Persist verified completion context |

package/dist/skills/writing-plans/SKILL.md

@@ -97,12 +97,12 @@ Offer execution choice: subagent-driven (this session) or parallel session with
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `search_intelligent` | Find patterns before planning |
-| `brain_strengths` | Proven approaches |
-| `create_plan` | Create tracked plan |
-| `plan_grade` / `plan_auto_improve` | Grade and improve |
-| `plan_iterate` | Iterate with feedback |
-| `plan_split` | Split into tasks |
-| `approve_plan` | Lock in approved plan |
+| Op                                 | When to Use                   |
+| ---------------------------------- | ----------------------------- |
+| `search_intelligent`               | Find patterns before planning |
+| `brain_strengths`                  | Proven approaches             |
+| `create_plan`                      | Create tracked plan           |
+| `plan_grade` / `plan_auto_improve` | Grade and improve             |
+| `plan_iterate`                     | Iterate with feedback         |
+| `plan_split`                       | Split into tasks              |
+| `approve_plan`                     | Lock in approved plan         |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/forge",
-  "version": "9.2.0",
+  "version": "9.3.0",
   "description": "Scaffold AI agents that learn, remember, and grow with you.",
   "keywords": [
     "agent",

package/src/scaffold-filetree.ts

@@ -95,7 +95,7 @@ When building a new feature, adding functionality, or creating components.
     tools: `tools:
   - soleri_vault op:search_intelligent
   - soleri_vault op:capture_knowledge
-  - soleri_vault op:link_entries
+  - soleri_links op:link_entries
   - soleri_plan op:create_plan
   - soleri_plan op:approve_plan
   - soleri_brain op:recommend

package/src/skills/brain-debrief/SKILL.md

@@ -56,15 +56,15 @@ Format as a report with: Strengths, Risks (recurring anti-patterns), Gaps, Stale
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `brain_stats` | Aggregate metrics |
-| `brain_strengths` | Proven patterns ranked |
-| `brain_global_patterns` | Cross-project patterns |
-| `brain_recommend` | Project-similarity recommendations |
-| `brain_build_intelligence` | Rebuild intelligence pipeline |
-| `memory_topics` / `memory_stats` | Knowledge clusters and health |
-| `vault_age_report` | Stale entries |
-| `curator_health_audit` | Vault quality score |
-| `admin_vault_analytics` | Knowledge quality metrics |
-| `admin_search_insights` | Search miss analysis |
+| Op                               | When to Use                        |
+| -------------------------------- | ---------------------------------- |
+| `brain_stats`                    | Aggregate metrics                  |
+| `brain_strengths`                | Proven patterns ranked             |
+| `brain_global_patterns`          | Cross-project patterns             |
+| `brain_recommend`                | Project-similarity recommendations |
+| `brain_build_intelligence`       | Rebuild intelligence pipeline      |
+| `memory_topics` / `memory_stats` | Knowledge clusters and health      |
+| `vault_age_report`               | Stale entries                      |
+| `curator_health_audit`           | Vault quality score                |
+| `admin_vault_analytics`          | Knowledge quality metrics          |
+| `admin_search_insights`          | Search miss analysis               |

package/src/skills/brainstorming/SKILL.md

@@ -79,11 +79,11 @@ Write validated design to `docs/plans/YYYY-MM-DD-<topic>-design.md` and commit.
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `route_intent` | Classify work type |
-| `search_intelligent` | Search vault for prior art |
+| Op                             | When to Use                |
+| ------------------------------ | -------------------------- |
+| `route_intent`                 | Classify work type         |
+| `search_intelligent`           | Search vault for prior art |
 | `vault_tags` / `vault_domains` | Browse knowledge landscape |
-| `brain_strengths` | Check proven patterns |
-| `memory_cross_project_search` | Check other projects |
-| `capture_knowledge` | Persist design decision |
+| `brain_strengths`              | Check proven patterns      |
+| `memory_cross_project_search`  | Check other projects       |
+| `capture_knowledge`            | Persist design decision    |

package/src/skills/code-patrol/SKILL.md

@@ -32,13 +32,13 @@ YOUR_AGENT_core op:brain_strengths
 
 ### 3. Review the Code
 
-| Check | Source | Severity |
-|-------|--------|----------|
-| Violates critical rule | `search (severity: critical)` | Must fix |
-| Matches known anti-pattern | `search (type: anti-pattern)` | Must fix |
-| Doesn't follow proven pattern | `brain_strengths` | Should fix |
-| Breaks project conventions | `project_list_rules` | Should fix |
-| Misses pattern opportunity | `search_intelligent` | Could improve |
+| Check                         | Source                        | Severity      |
+| ----------------------------- | ----------------------------- | ------------- |
+| Violates critical rule        | `search (severity: critical)` | Must fix      |
+| Matches known anti-pattern    | `search (type: anti-pattern)` | Must fix      |
+| Doesn't follow proven pattern | `brain_strengths`             | Should fix    |
+| Breaks project conventions    | `project_list_rules`          | Should fix    |
+| Misses pattern opportunity    | `search_intelligent`          | Could improve |
 
 ### 4. Present the Review
 
@@ -76,11 +76,11 @@ Re-run patrol after user applies fixes. Check `admin_health`.
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `route_intent` | Classify code domain |
-| `search_intelligent` | Find relevant patterns |
-| `search` | Find anti-patterns and critical rules |
-| `project_list_rules` / `get_behavior_rules` | Project conventions |
-| `brain_strengths` | Proven patterns |
-| `capture_quick` / `capture_knowledge` | Capture new discoveries |
+| Op                                          | When to Use                           |
+| ------------------------------------------- | ------------------------------------- |
+| `route_intent`                              | Classify code domain                  |
+| `search_intelligent`                        | Find relevant patterns                |
+| `search`                                    | Find anti-patterns and critical rules |
+| `project_list_rules` / `get_behavior_rules` | Project conventions                   |
+| `brain_strengths`                           | Proven patterns                       |
+| `capture_quick` / `capture_knowledge`       | Capture new discoveries               |

package/src/skills/context-resume/SKILL.md

@@ -85,11 +85,11 @@ YOUR_AGENT_core op:admin_health
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `plan_stats` / `get_plan` / `plan_list_tasks` | Active plans |
-| `memory_search` / `memory_list` | Session summaries |
-| `vault_recent` | Recently captured knowledge |
-| `loop_is_active` / `loop_status` | In-flight loops |
-| `brain_strengths` | Relevant proven patterns |
-| `admin_health` | System health check |
+| Op                                            | When to Use                 |
+| --------------------------------------------- | --------------------------- |
+| `plan_stats` / `get_plan` / `plan_list_tasks` | Active plans                |
+| `memory_search` / `memory_list`               | Session summaries           |
+| `vault_recent`                                | Recently captured knowledge |
+| `loop_is_active` / `loop_status`              | In-flight loops             |
+| `brain_strengths`                             | Relevant proven patterns    |
+| `admin_health`                                | System health check         |

package/src/skills/deep-review/SKILL.md

@@ -20,12 +20,14 @@ The user provides a **target**: file, module, directory, PR diff, or function. I
 ### Pass 1: Structural Analysis & Code Smells
 
 **Metrics** (gather by reading the code):
+
 - File length and function count
 - Cyclomatic complexity (nesting depth, branch count)
 - Dependency count — imports from how many modules?
 - Export surface area — how much is public vs. should be internal?
 
 **Structural Smells:**
+
 - **God file/class** — too many responsibilities, >300 lines with mixed concerns
 - **Long parameter lists** — function takes 5+ params (should be an object/config)
 - **Deep nesting** — 4+ levels of if/for/try/catch
@@ -34,11 +36,13 @@ The user provides a **target**: file, module, directory, PR diff, or function. I
 - **Boolean blindness** — functions with multiple boolean params (`fn(true, false, true)`)
 
 **Duplication Smells:**
+
 - Copy-paste with slight variations
 - Repeated conditional logic — same if-chain in 3+ places
 - Parallel structures that always change together
 
 **Temporal Smells** (check git history):
+
 - Files that always change together but live in different modules → missing abstraction
 - Functions that get patched repeatedly → wrong abstraction
 - High churn files → instability signal
@@ -52,16 +56,19 @@ Present findings before moving to Pass 2.
 ### Pass 2: Architectural Fitness
 
 **Dependency Direction:**
+
 - Do dependencies flow in the right direction? (Outer layers depend on inner, not reverse)
 - Are there circular dependencies?
 - Does the code reach across module boundaries it shouldn't?
 
 **Abstraction Level:**
+
 - Is this the right level of abstraction for the problem?
 - Over-engineered? (abstraction for one use case, premature generalization)
 - Under-engineered? (inline logic that should be extracted)
 
 **Cohesion & Coupling:**
+
 - Does everything in this module belong together? (high cohesion)
 - Is the module tangled with others? (low coupling desired)
 - Feature envy — does a function touch another module's internals more than its own?
@@ -78,23 +85,27 @@ If vault has relevant patterns, check alignment. If not, skip — this pass work
 ### Pass 3: Solution Quality Assessment
 
 **Simplification:**
+
 - Is there a simpler way to achieve the same result?
 - Could any abstraction be removed without loss?
 - Are there standard library/framework features that replace custom code?
 
 **Edge Cases:**
+
 - What inputs would break this?
 - Are error paths handled or just the happy path?
 - What happens with empty/null/undefined inputs?
 - Concurrency: race conditions, shared mutable state?
 
 **Performance:**
+
 - Any O(n²) or worse hidden in loops?
 - Unnecessary allocations, copies, or serialization?
 - N+1 query patterns?
 - Unbounded growth (arrays/maps that grow without limit)?
 
 **Evolutionary Fitness:**
+
 - How does this code age? Easy to modify in 6 months?
 - Does it create "gravity" — attracting more complexity over time?
 - Are extension points in the right places?
@@ -145,12 +156,12 @@ If vault has relevant patterns, check alignment. If not, skip — this pass work
 
 ## Severity Scale
 
-| Level | Meaning |
-|-------|---------|
-| ✅ | Clean — no action needed |
-| 💡 | Info — worth knowing, low priority |
-| ⚠️ | Warning — should fix, causes friction |
-| 🔴 | Critical — fix before shipping, causes bugs or blocks scaling |
+| Level | Meaning                                                       |
+| ----- | ------------------------------------------------------------- |
+| ✅    | Clean — no action needed                                      |
+| 💡    | Info — worth knowing, low priority                            |
+| ⚠️    | Warning — should fix, causes friction                         |
+| 🔴    | Critical — fix before shipping, causes bugs or blocks scaling |
 
 ## Capturing Learnings (Optional)
 
@@ -179,8 +190,8 @@ Only capture if genuinely reusable — not every review finding is vault-worthy.
 
 ## Quick Reference
 
-| Pass | Focus | Key Activities |
-|------|-------|----------------|
-| 1. Structural | Metrics + Smells | Read code, check complexity, find smells, check git history |
-| 2. Architecture | Fitness | Dependency direction, abstraction level, cohesion/coupling |
-| 3. Solution | Quality | Simplification, edge cases, performance, evolution |
+| Pass            | Focus            | Key Activities                                              |
+| --------------- | ---------------- | ----------------------------------------------------------- |
+| 1. Structural   | Metrics + Smells | Read code, check complexity, find smells, check git history |
+| 2. Architecture | Fitness          | Dependency direction, abstraction level, cohesion/coupling  |
+| 3. Solution     | Quality          | Simplification, edge cases, performance, evolution          |

package/src/skills/executing-plans/SKILL.md

@@ -36,6 +36,7 @@ YOUR_AGENT_core op:loop_start
 ### Step 3: Execute Batch (default: first 3 tasks)
 
 For each task:
+
 1. `op:update_task` — mark `in_progress`
 2. Follow each step exactly
 3. Run verifications as specified
@@ -78,14 +79,14 @@ Capture mid-execution learnings with `op:capture_quick` as they happen — don't
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `get_plan` / `plan_list_tasks` / `plan_stats` | Load plan |
-| `update_task` | Mark task status |
-| `loop_start` / `loop_iterate` / `loop_complete` | Validation loop |
-| `plan_reconcile` | Post-execution drift report |
-| `plan_complete_lifecycle` | Extract knowledge, archive |
-| `session_capture` | Save session context |
-| `capture_quick` | Mid-execution learnings |
+| Op                                              | When to Use                 |
+| ----------------------------------------------- | --------------------------- |
+| `get_plan` / `plan_list_tasks` / `plan_stats`   | Load plan                   |
+| `update_task`                                   | Mark task status            |
+| `loop_start` / `loop_iterate` / `loop_complete` | Validation loop             |
+| `plan_reconcile`                                | Post-execution drift report |
+| `plan_complete_lifecycle`                       | Extract knowledge, archive  |
+| `session_capture`                               | Save session context        |
+| `capture_quick`                                 | Mid-execution learnings     |
 
 **Related skills:** writing-plans, verification-before-completion, test-driven-development

package/src/skills/fix-and-learn/SKILL.md

@@ -92,11 +92,11 @@ Bug resolved, tests pass, root cause captured in vault. A fix without a capture
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `route_intent` | Classify as FIX intent |
-| `search_intelligent` | Check vault for known bugs |
-| `memory_search` | Search session memories |
-| `loop_start` / `loop_iterate` / `loop_complete` | Iterative fix cycle |
-| `capture_knowledge` / `capture_quick` | Persist anti-pattern |
-| `curator_detect_duplicates` | Prevent redundant entries |
+| Op                                              | When to Use                |
+| ----------------------------------------------- | -------------------------- |
+| `route_intent`                                  | Classify as FIX intent     |
+| `search_intelligent`                            | Check vault for known bugs |
+| `memory_search`                                 | Search session memories    |
+| `loop_start` / `loop_iterate` / `loop_complete` | Iterative fix cycle        |
+| `capture_knowledge` / `capture_quick`           | Persist anti-pattern       |
+| `curator_detect_duplicates`                     | Prevent redundant entries  |

package/src/skills/health-check/SKILL.md

@@ -122,14 +122,14 @@ YOUR_AGENT_core op:governance_expire
 
 ## Quick Reference
 
-| Op | When to Use |
-|----|-------------|
-| `admin_health` / `admin_diagnostic` | System health |
-| `admin_vault_analytics` / `admin_vault_size` | Vault metrics |
-| `curator_health_audit` | Quality score |
-| `curator_detect_duplicates` | Find duplicates |
-| `curator_contradictions` | Find conflicts |
-| `vault_age_report` | Stale entries |
-| `admin_search_insights` | Search miss analysis |
-| `curator_consolidate` | Full cleanup pipeline |
-| `brain_build_intelligence` | Rebuild after cleanup |
+| Op                                           | When to Use           |
+| -------------------------------------------- | --------------------- |
+| `admin_health` / `admin_diagnostic`          | System health         |
+| `admin_vault_analytics` / `admin_vault_size` | Vault metrics         |
+| `curator_health_audit`                       | Quality score         |
+| `curator_detect_duplicates`                  | Find duplicates       |
+| `curator_contradictions`                     | Find conflicts        |
+| `vault_age_report`                           | Stale entries         |
+| `admin_search_insights`                      | Search miss analysis  |
+| `curator_consolidate`                        | Full cleanup pipeline |
+| `brain_build_intelligence`                   | Rebuild after cleanup |