@rune-kit/rune 2.2.6 → 2.3.0

package/skills/fix/SKILL.md

@@ -3,7 +3,7 @@ name: fix
 description: Apply code changes and fixes. Writes implementation code, applies bug fixes, and verifies changes with tests. Core action hub in the development mesh.
 metadata:
   author: runedev
-  version: "0.5.0"
+  version: "0.6.0"
   layer: L2
   model: sonnet
   group: development
@@ -204,7 +204,7 @@ If fix requires touching >3 files not in the diagnosis → re-diagnose. You're p
 ```
 ## Fix Report
 - **Task**: [what was fixed/implemented]
-- **Status**: complete | partial | blocked
+- **Status**: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED
 
 ### Changes
 - `path/to/file.ts` — [description of change]
@@ -215,10 +215,38 @@ If fix requires touching >3 files not in the diagnosis → re-diagnose. You're p
 - Types: PASS | FAIL
 - Tests: PASS | FAIL ([n] passed, [m] failed)
 
+### Concerns (if DONE_WITH_CONCERNS)
+- [concern]: [impact assessment] — [suggested remediation]
+
+### Context Needed (if NEEDS_CONTEXT)
+- [what is unknown]: [why it blocks] — [two most likely answers]
+
+### Blocker (if BLOCKED)
+- [specific blocker]: [what was attempted]
+
 ### Notes
 - [any caveats or follow-up needed]
 ```
 
+### Status Protocol (Subagent Contract)
+
+Fix returns one of four statuses to its caller (cook, debug, review, surgeon). The caller uses this to route next actions.
+
+| Status | When | Example |
+|--------|------|---------|
+| `DONE` | Fix applied, tests pass, no issues | Clean bug fix, all green |
+| `DONE_WITH_CONCERNS` | Fix works but has side effects or caveats worth noting | "Tests pass but performance regressed 15% — consider optimizing in follow-up" |
+| `NEEDS_CONTEXT` | Cannot apply fix without clarification — ambiguous spec or missing info | "Two valid interpretations of the expected behavior — need user input" |
+| `BLOCKED` | Hard blocker — exhausted fix attempts, broken dependency, fundamental incompatibility | "3 fix attempts failed — triggering debug escalation" |
+
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Code changes | Source files | Per debug report / plan file paths |
+| Fix Report | Markdown (inline) | Emitted to calling skill (cook, debug, review, surgeon) |
+| Verification output | Inline (Fix Report) | Lint + types + test results |
+
 ## Sharp Edges
 
 Known failure modes for this skill. Check these before declaring done.
@@ -242,8 +270,13 @@ Known failure modes for this skill. Check these before declaring done.
 - Tests pass for the fixed functionality (actual output shown)
 - Lint and type check pass
 - hallucination-guard verified any new imports
-- Fix Report emitted with changed files and verification results
+- Fix Report emitted with 4-state status, changed files, and verification results
+- If `DONE_WITH_CONCERNS`: concerns listed with impact + remediation
+- If `NEEDS_CONTEXT`: specific questions stated with two likely answers
+- If `BLOCKED`: blocker + all attempted approaches documented
 
 ## Cost Profile
 
 ~2000-5000 tokens input, ~1000-3000 tokens output. Sonnet for code writing quality. Most active skill during implementation.
+
+**Scope guardrail**: Do not refactor unrelated code or create new features beyond the diagnosed fix target unless explicitly delegated by the parent agent.

package/skills/incident/SKILL.md

@@ -214,6 +214,16 @@ File: src/middleware/auth.ts:47
 | Security Gate | sentinel ran before closing incident | Run sentinel — do not skip |
 | Postmortem Gate | All sections populated (Timeline, RCA, Prevention Actions) before status = Resolved | Complete or note as DRAFT |
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Incident response report | Markdown | inline (chat output) |
+| Incident timeline | Text (HH:MM format) | inline + postmortem |
+| Postmortem document | Markdown | `.rune/incidents/INCIDENT-<date>-<slug>.md` |
+| Prevention actions table | Markdown table | postmortem |
+| Journal entry (incident ADR) | Text | `.rune/adr/` (via `rune:journal`) |
+
 ## Sharp Edges
 
 Known failure modes for this skill. Check these before declaring done.

package/skills/launch/SKILL.md

@@ -303,6 +303,16 @@ Mark todo[4] `completed`.
 - Launch video: [ready | skipped]
 ```
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Deploy status + live URL | Inline (Launch Report) | Emitted at session end |
+| Marketing assets (copy, social, SEO) | Markdown (inline) | Generated by `rune:marketing`, presented in Phase 5 |
+| Release checklist | Markdown (inline) | Shown in Announce phase |
+| Monitoring confirmation | Inline | Watchdog setup output |
+| Launch Report | Markdown (inline) | Emitted at end of session |
+
 ## Sharp Edges
 
 Known failure modes for this skill. Check these before declaring done.
@@ -328,3 +338,5 @@ Known failure modes for this skill. Check these before declaring done.
 ## Cost Profile
 
 ~$0.08-0.15 per launch. Sonnet for coordination, delegates to haiku for scanning.
+
+**Scope guardrail**: Do not publish marketing assets or trigger external announcements unless explicitly delegated by the parent agent.

package/skills/logic-guardian/SKILL.md

@@ -235,6 +235,17 @@ Ensure the next session can pick up where this one left off:
 - Manifest summary saved to journal + neural memory for cross-session handoff
 - Tests pass after any logic edit
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Logic manifest | JSON | `.rune/logic-manifest.json` |
+| Validation report (SYNCED / DRIFT) | Markdown | inline |
+| Pre-edit gate summary | Structured text | inline |
+| ADR entries for logic changes | Markdown | via `journal` L3 |
+
 ## Cost Profile
 
 ~1,000-2,000 tokens for manifest load + pre-edit gate. ~3,000-5,000 tokens for full project scan (Phase 3). Sonnet for code analysis; haiku for file scanning via scout.
+
+**Scope guardrail:** logic-guardian protects existing logic — it does not implement new features or refactor code.

package/skills/marketing/SKILL.md

@@ -224,6 +224,19 @@ Known failure modes for this skill. Check these before declaring done.
 - Files saved to marketing/ directory
 - Marketing Assets report emitted with file list
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Brand voice contract | Markdown | `marketing/brand-voice.md` |
+| Landing page copy | Markdown | `marketing/landing-copy.md` |
+| Social media posts | Markdown | `marketing/social-posts.md` |
+| SEO metadata | JSON | `marketing/seo-meta.json` |
+| SEO audit report | Markdown | `marketing/seo-audit.md` |
+| Video demo script | Markdown | `marketing/video-script.md` |
+
 ## Cost Profile
 
 ~2000-5000 tokens input, ~1000-3000 tokens output. Sonnet for copywriting quality.
+
+**Scope guardrail:** marketing generates assets based on actual product capabilities only — no aspirational copy, no fabricated stats.

package/skills/mcp-builder/SKILL.md

@@ -353,6 +353,19 @@ mcp-server-<name>/
 - Verification passed (types + tests)
 - Ready to install in Claude Code / Cursor / other IDEs
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| MCP server source code | TypeScript or Python | `mcp-server-<name>/src/` |
+| Tool definitions (one per tool) | TS/Python files | `src/tools/<name>.ts` or `.py` |
+| Resource handlers | TS/Python files | `src/resources/<name>.ts` or `.py` |
+| Test suite | TS/Python test files | `tests/` |
+| README with tool catalog | Markdown | `mcp-server-<name>/README.md` |
+| Environment config template | `.env.example` | project root |
+
 ## Cost Profile
 
 ~3000-6000 tokens input, ~2000-5000 tokens output. Sonnet — MCP server generation is a structured code task, not architectural reasoning.
+
+**Scope guardrail:** mcp-builder generates the server and tests — it does not deploy, register with MCP registries, or configure the host IDE beyond providing the installation snippet.

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,21 @@ 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.
+
+> Source: affaan-m/everything-claude-code (91.9k★) — instinct-based learning with project isolation.
 
 ### Step 6b — Generate DEVELOPER-GUIDE.md
 
@@ -188,6 +204,26 @@ 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).
+
+> Source: affaan-m/everything-claude-code (91.9k★) — MCP token cost awareness.
+
 ### Step 7 — Commit
 Use `Bash` to stage and commit the generated files:
 ```bash
@@ -256,6 +292,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 +328,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.