@lovrozagar/grunt 0.3.7 → 0.3.8

package/.agents/skills/cascade/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: cascade
+description: >
+  Session mode. /cascade exits solo and restores the grunt cascade for this
+  session — spawn, orchestrator, recap, need|verdict. Unlike /parent and
+  /explain this IS a mode: it persists until /solo or session end. Not a
+  sticky second mode — exit solo / restore cascade.
+---
+Exit solo / restore cascade. Not a sticky second mode.
+
+Session mode, not one-turn. Persists until `/solo` or session end.
+
+This session: cascade restored. You are the parent orchestrator.
+
+- Spawn grunt|implementer|thinker.
+- Recap tags. Recap `[orchestrator]:` `[grunt]:` `[implementer]:` `[thinker]:` `[handoff]:`.
+- Spawn-first rule. `need:`/`verdict:` grammar.
+- Voice unchanged: `.rulesync/reference/output.md`. `/explain` is still the voice escape.
+
+Fat-tool caps stay on — token guards, not cascade.
+
+Claude/Codex/Grok: `/cascade` via submit hook unlinks `.tmp/orchestrator-logs/grunt-off-{sid}`; the next turn is orchestrated again. Already orchestrated: no-op. Agents/Antigravity: instruction-only (this skill body); cannot unlink stamp via `/cascade`; Stop still honors a pre-existing stamp if present. Session-scoped, never global.
+
+After `/solo`, or when spawn/recap/need|verdict must resume.

package/.claude/skills/cascade/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: cascade
+description: >
+  Session mode. /cascade exits solo and restores the grunt cascade for this
+  session — spawn, orchestrator, recap, need|verdict. Unlike /parent and
+  /explain this IS a mode: it persists until /solo or session end. Not a
+  sticky second mode — exit solo / restore cascade.
+---
+Exit solo / restore cascade. Not a sticky second mode.
+
+Session mode, not one-turn. Persists until `/solo` or session end.
+
+This session: cascade restored. You are the parent orchestrator.
+
+- Spawn grunt|implementer|thinker.
+- Recap tags. Recap `[orchestrator]:` `[grunt]:` `[implementer]:` `[thinker]:` `[handoff]:`.
+- Spawn-first rule. `need:`/`verdict:` grammar.
+- Voice unchanged: `.rulesync/reference/output.md`. `/explain` is still the voice escape.
+
+Fat-tool caps stay on — token guards, not cascade.
+
+Claude/Codex/Grok: `/cascade` via submit hook unlinks `.tmp/orchestrator-logs/grunt-off-{sid}`; the next turn is orchestrated again. Already orchestrated: no-op. Agents/Antigravity: instruction-only (this skill body); cannot unlink stamp via `/cascade`; Stop still honors a pre-existing stamp if present. Session-scoped, never global.
+
+After `/solo`, or when spawn/recap/need|verdict must resume.

package/.grok/skills/cascade/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: cascade
+description: >
+  Session mode. /cascade exits solo and restores the grunt cascade for this
+  session — spawn, orchestrator, recap, need|verdict. Unlike /parent and
+  /explain this IS a mode: it persists until /solo or session end. Not a
+  sticky second mode — exit solo / restore cascade.
+---
+Exit solo / restore cascade. Not a sticky second mode.
+
+Session mode, not one-turn. Persists until `/solo` or session end.
+
+This session: cascade restored. You are the parent orchestrator.
+
+- Spawn grunt|implementer|thinker.
+- Recap tags. Recap `[orchestrator]:` `[grunt]:` `[implementer]:` `[thinker]:` `[handoff]:`.
+- Spawn-first rule. `need:`/`verdict:` grammar.
+- Voice unchanged: `.rulesync/reference/output.md`. `/explain` is still the voice escape.
+
+Fat-tool caps stay on — token guards, not cascade.
+
+Claude/Codex/Grok: `/cascade` via submit hook unlinks `.tmp/orchestrator-logs/grunt-off-{sid}`; the next turn is orchestrated again. Already orchestrated: no-op. Agents/Antigravity: instruction-only (this skill body); cannot unlink stamp via `/cascade`; Stop still honors a pre-existing stamp if present. Session-scoped, never global.
+
+After `/solo`, or when spawn/recap/need|verdict must resume.

package/.rulesync/reference/map.md

@@ -23,13 +23,13 @@ Cheap outline. Not a file dump.
 - `.grok/hooks/orchestrate-parent.js` + `orchestrate-parent.json` — parent spawn/fat/stop/plan-write / SubagentStop intercept
 - `.grok/hooks/rtk.json` — RTK
 - `.grok/skills/{write-plan,implement-plan,shared}/` — hand-only (no rulesync SSOT); point to cascade, do not paste
-- `.grok/skills/{parent,explain,handoff,solo,commit,commit-and-push}/` — generated from `.rulesync/skills/`; do not hand-edit
+- `.grok/skills/{parent,explain,handoff,solo,cascade,commit,commit-and-push}/` — generated from `.rulesync/skills/`; do not hand-edit
 - `.grok/parent.md` — 1-line pointer to orchestrator agent; not SessionStart
 - `.grok/roles/*.toml`
 - `.grok/global-settings.toml` — merged into `~/.grok/config.toml` by `scripts/sync-global-settings.mjs` (not auto-loaded; project config cannot set `[features]`)
 - `.rulesync/global-settings/` — host manifest and reserved noop payloads
 - `.rulesync/mcp-policy.jsonc` — MCP deny-default SSOT (`default: deny`, `allow: []`)
-- `.rulesync/skills/{parent,explain,handoff,solo,commit,commit-and-push}/` — skill SSOT; `rulesync -f skills` emits `.grok/skills/`, `.claude/skills/`, `.agents/skills/` byte-equal. `/cascade` has no skill (hook-only: a `grunt`-adjacent listing entry risks mis-routing `Skill` vs `Agent`)
+- `.rulesync/skills/{parent,explain,handoff,solo,cascade,commit,commit-and-push}/` — skill SSOT; `rulesync -f skills` emits `.grok/skills/`, `.claude/skills/`, `.agents/skills/` byte-equal. `/cascade` = exit solo / restore cascade (not a sticky second mode)
 
 ## Scripts
 - `scripts/check-globals.mjs` — `$HOME/.grok/config.toml` `[agent].name==orchestrator` + `[features].two_pass_compaction==true`; project `.grok/config.toml` must not have `[features]`/`[agent]`; wired as `sync:globals:check` (also after emit-mcp in `rulesync:check`)
@@ -58,7 +58,7 @@ Cheap outline. Not a file dump.
 
 ## Generated (do not hand-edit; committed, not gitignored)
 - `AGENTS.md`, `CLAUDE.md`
-- `.claude/skills/*`, `.agents/skills/*`, `.grok/skills/{parent,explain,handoff,solo,commit,commit-and-push}/` (from `.rulesync/skills/`)
+- `.claude/skills/*`, `.agents/skills/*`, `.grok/skills/{parent,explain,handoff,solo,cascade,commit,commit-and-push}/` (from `.rulesync/skills/`)
 - `.grok/agents/*`
 - `.claude/agents/*`
 - `.codex/agents/*`

package/.rulesync/skills/cascade/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: cascade
+description: >
+  Session mode. /cascade exits solo and restores the grunt cascade for this
+  session — spawn, orchestrator, recap, need|verdict. Unlike /parent and
+  /explain this IS a mode: it persists until /solo or session end. Not a
+  sticky second mode — exit solo / restore cascade.
+---
+Exit solo / restore cascade. Not a sticky second mode.
+
+Session mode, not one-turn. Persists until `/solo` or session end.
+
+This session: cascade restored. You are the parent orchestrator.
+
+- Spawn grunt|implementer|thinker.
+- Recap tags. Recap `[orchestrator]:` `[grunt]:` `[implementer]:` `[thinker]:` `[handoff]:`.
+- Spawn-first rule. `need:`/`verdict:` grammar.
+- Voice unchanged: `.rulesync/reference/output.md`. `/explain` is still the voice escape.
+
+Fat-tool caps stay on — token guards, not cascade.
+
+Claude/Codex/Grok: `/cascade` via submit hook unlinks `.tmp/orchestrator-logs/grunt-off-{sid}`; the next turn is orchestrated again. Already orchestrated: no-op. Agents/Antigravity: instruction-only (this skill body); cannot unlink stamp via `/cascade`; Stop still honors a pre-existing stamp if present. Session-scoped, never global.
+
+After `/solo`, or when spawn/recap/need|verdict must resume.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovrozagar/grunt",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Multi-agent orchestrator SoT — deep-merge rulesync trees, product scripts, and generate pipeline into a consumer repo",
   "keywords": [
     "agents",