@rune-kit/rune 2.2.6 → 2.3.1

package/skills/review-intake/SKILL.md

@@ -233,6 +233,17 @@ How to push back:
 - Tests pass after each individual fix
 - Review Intake Report emitted
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Review Intake Report | Markdown table | inline |
+| Categorized feedback (P0–P4) | Classified list | inline |
+| Verdict per item (CORRECT/PUSHBACK/YAGNI/DEFER) | Table | inline |
+| Action plan (changes applied) | File list with descriptions | inline |
+
 ## Cost Profile
 
 ~2000-5000 tokens depending on feedback volume. Sonnet for evaluation logic, haiku for scout/grep verification.
+
+**Scope guardrail:** review-intake processes the feedback items provided — it does not pull new reviews, open PRs, or change architectural decisions without owner confirmation.

package/skills/safeguard/SKILL.md

@@ -183,6 +183,18 @@ Known failure modes for this skill. Check these before declaring done.
 - Git tag `rune-safeguard-<module>` created
 - Safeguard Report emitted with test count, coverage, and rollback tag
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Characterization test file | TypeScript/JS/Python test | `tests/char/<module>.test.*` |
+| Boundary markers | Code comments (@legacy, @bridge) | in-source |
+| Frozen config snapshot | Copies of config files | `.rune/*.frozen.*` |
+| Git rollback tag | Git tag | `rune-safeguard-<module>` |
+| Safeguard Report | Markdown | inline |
+
 ## Cost Profile
 
 ~2000-5000 tokens input, ~1000-2000 tokens output. Sonnet for test writing quality.
+
+**Scope guardrail:** safeguard builds safety nets only — it does not refactor code. All surgery is delegated to `surgeon` after the safeguard HARD-GATE passes.

package/skills/scaffold/SKILL.md

@@ -247,6 +247,16 @@ Max 3 fix-verify loops. If still failing after 3 → report failures to user wit
 9. MUST respect user's existing project if scaffolding into non-empty directory — warn and ask before overwriting
 10. Generated files MUST be < 500 LOC each — split large files
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Project directory structure | Directories + files | Project root (per plan) |
+| Source code | Source files | Per plan file list |
+| Test suite | Source files | Co-located or `tests/` per framework convention |
+| Documentation | Markdown | `README.md`, `ARCHITECTURE.md`, `docs/API.md` as applicable |
+| Scaffold Report | Markdown (inline) | Emitted at session end |
+
 ## Sharp Edges
 
 | Failure Mode | Severity | Mitigation |

package/skills/scope-guard/SKILL.md

@@ -145,6 +145,17 @@ Known failure modes for this skill. Check these before declaring done.
 - Creep severity classified (IN_SCOPE / MINOR CREEP / SIGNIFICANT CREEP)
 - Scope Report emitted with recommendations
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Scope Report | Markdown (IN_SCOPE / MINOR CREEP / SIGNIFICANT CREEP) | inline |
+| In-scope file list | Classified list | inline |
+| Out-of-scope drift report | File list with reasons | inline |
+| Recommendations | Actionable list | inline |
+
 ## Cost Profile
 
 ~200-500 tokens input, ~100-300 tokens output. Haiku. Lightweight monitor.
+
+**Scope guardrail:** scope-guard reports drift and advises — it does not revert files, block commits, or modify code. Override decisions belong to the calling orchestrator or the user.

package/skills/scout/SKILL.md

@@ -206,6 +206,13 @@ None — pure scanner using Glob, Grep, Read, and Bash tools directly. Does not
 - [pattern or potential issue noticed]
 ```
 
+## Returns
+
+| Artifact | Format | Location |
+|----------|--------|----------|
+| Scout Report | Markdown (inline) | Emitted to calling skill |
+| Codebase map | Markdown | `.rune/codebase-map.md` (when called by cook, team, onboard, autopsy) |
+
 ## Sharp Edges
 
 Known failure modes for this skill. Check these before declaring done.
@@ -230,3 +237,5 @@ Known failure modes for this skill. Check these before declaring done.
 ## Cost Profile
 
 ~500-2000 tokens input, ~200-500 tokens output. Always haiku. Cheapest skill in the mesh.
+
+**Scope guardrail**: Do not expand the scan to unrelated modules or write files beyond `.rune/codebase-map.md` unless explicitly delegated by the parent agent.