@rune-kit/rune 2.2.6 → 2.3.1

package/skills/onboard/SKILL.md

@@ -3,7 +3,7 @@ name: onboard
 description: Auto-generate project context for AI sessions. Scans codebase, creates CLAUDE.md and .rune/ setup so every future session starts with full context.
 metadata:
   author: runedev
-  version: "0.2.0"
+  version: "0.3.0"
   layer: L2
   model: sonnet
   group: quality
@@ -43,6 +43,7 @@ project/
     ├── decisions.md       # Empty, ready for session-bridge
     ├── progress.md        # Empty, ready for session-bridge
     ├── session-log.md     # Empty, ready for session-bridge
+    ├── instincts.md       # Empty, ready for session-bridge instinct learning
     └── DEVELOPER-GUIDE.md # Human-readable onboarding for new developers
 ```
 
@@ -103,6 +104,19 @@ Use `Write` to create each file:
 - `.rune/decisions.md` — create with header `# Architecture Decisions` and one placeholder row in a markdown table (Date | Decision | Rationale | Status)
 - `.rune/progress.md` — create with header `# Progress Log` and one placeholder entry
 - `.rune/session-log.md` — create with header `# Session Log` and current date as first entry
+- `.rune/instincts.md` — create with header `# Project Instincts` and a description: "Learned trigger→action patterns. Managed by session-bridge. See session-bridge SKILL.md Step 5.7 for format."
+
+### Step 5.5 — Load Existing Instincts
+
+If `.rune/instincts.md` already exists and contains instinct entries, read it and include a summary in the Onboard Report under `### Learned Instincts`. This tells the agent what project-specific behaviors have been learned from previous sessions.
+
+For each instinct with confidence ≥0.6, include in the report:
+- Trigger and action (one line)
+- Confidence level
+
+Instincts with confidence <0.6 are still learning — mention count but don't list individually.
+
+**Why**: Onboard is the first skill that runs in a new session. Surfacing instincts here ensures the agent starts with project-specific learned behaviors, not just static conventions.
 
 ### Step 6b — Generate DEVELOPER-GUIDE.md
 
@@ -188,6 +202,24 @@ Based on your detected stack ([detected frameworks]), these extension packs may
   Install: [link or command when available]
 ```
 
+### Step 6d — Context Budget Check
+
+Audit the project's baseline context cost from MCP servers and agent configurations. This helps developers understand why their context window fills up faster than expected.
+
+1. Count MCP tools available (from session start messages or `settings.json`)
+2. Check CLAUDE.md line count
+3. If total MCP tools >80 or CLAUDE.md >150 lines, include a **Context Budget Advisory** in the Onboard Report:
+
+```
+### Context Budget Advisory
+- **MCP tools loaded**: [count] across [N] servers
+- **CLAUDE.md size**: [N] lines
+- **Estimated baseline**: ~[N]k tokens before any work begins
+- **Recommendation**: [specific advice — disable unused MCP servers, move CLAUDE.md details to .rune/]
+```
+
+**Skip if**: Total MCP tools ≤80 AND CLAUDE.md ≤150 lines (healthy baseline).
+
 ### Step 7 — Commit
 Use `Bash` to stage and commit the generated files:
 ```bash
@@ -256,6 +288,10 @@ If any of the `.rune/` files already exist, do not overwrite them (they may cont
 ### Skipped (already exist)
 - [list of files not overwritten]
 
+### Learned Instincts (if any)
+- [trigger] → [action] (confidence: [0.6-0.9]) — for each high-confidence instinct
+- [N] low-confidence instincts still learning
+
 ### Observations
 - [notable patterns or anomalies found]
 - [potential issues detected]
@@ -288,11 +324,23 @@ Known failure modes for this skill. Check these before declaring done.
 ## Done When
 
 - CLAUDE.md written (or merged) with all detected tech stack fields populated
-- .rune/ directory initialized with conventions, decisions, progress, session-log
+- .rune/ directory initialized with conventions, decisions, progress, session-log, instincts
 - .rune/DEVELOPER-GUIDE.md written with setup commands from actual scan
 - All generated commands verified to exist in package.json/Makefile/etc.
 - Onboard Report emitted with Generated + Skipped + Observations sections
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Project AI config | Markdown | `CLAUDE.md` (project root) |
+| Detected conventions | Markdown | `.rune/conventions.md` |
+| Decision log (initialized) | Markdown | `.rune/decisions.md` |
+| Developer onboarding guide | Markdown | `.rune/DEVELOPER-GUIDE.md` |
+| Session/progress files | Markdown | `.rune/progress.md`, `.rune/session-log.md` |
+
 ## Cost Profile
 
 ~2000-5000 tokens input, ~1000-2000 tokens output. Sonnet for analysis quality.
+
+**Scope guardrail:** onboard generates project context files — it does not modify source code, install dependencies, or change project configuration.

package/skills/perf/SKILL.md

@@ -292,6 +292,17 @@ Known failure modes for this skill. Check these before declaring done.
 - Benchmark scripts ran (if configured) or INFO: skipped
 - Perf Report emitted with PASS/WARN/BLOCK verdict
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Perf Report with verdict | Markdown (PASS/WARN/BLOCK) | inline |
+| Per-finding details | Structured list (file:line + impact) | inline |
+| Lighthouse scores (if ran) | Score table | inline |
+| Framework-specific findings | Categorized list | inline |
+
 ## Cost Profile
 
 ~3000-8000 tokens input, ~500-1500 tokens output. Sonnet for pattern recognition.
+
+**Scope guardrail:** perf investigates and reports only — it does not fix code. All fixes are delegated to `fix` (L2) after the report is reviewed.