@ionivetech/mugiwara 0.2.0 → 0.4.0

package/content/skills/mugiwara-workflow/SKILL.md

@@ -5,12 +5,23 @@ description: Use at the start of any non-trivial mission to run the Mugiwara cre
 
 # Mugiwara Workflow
 
+## Skip when
+
+- Lane 0 direct work: typo, rename, or single-file fix under 20 LOC.
+- User explicitly declined the harness for this request.
+
 The Straw Hat harness: Wave 0 triage + Waves 1-9, with an optional adversarial pass at Wave 4.5. Waves are phases of the mission, not files — Nami writes them into the plan doc, Zoro executes them. The main thread runs the harness and embodies each crew role inline (Execution model below); the harness always starts through Luffy unless the user summons a crew member directly.
 
 ## Execution model (every harness)
 
 **Inline by default.** The main/primary agent runs the pipeline and plays each crew role itself using that member's skill. Every wave's work is performed in the main conversation so the user sees the process live — no hidden subagent jumps, no click-to-expand. The crew members are personas + skills the main thread embodies, not mandatory dispatch targets.
 
+**Visible wave transitions.** Every wave opens with a main-thread banner `## Wave N — <crew> (<skill>)` and closes with the handoff line `→ Wave N+1 — <crew>` (Wave 9: `→ closure`). No wave starts without its banner; the conversation names who runs now and who takes over next so the user always sees the chain live.
+
+**Auto-activation.** Any non-trivial request fires the harness without the user asking. Check first, before exploring or answering: if the request could benefit from the crew, start Wave 0 triage. The user does not need to invoke `using-mugiwara` explicitly — the workflow starts itself.
+
+**Checkpoint-report presentation.** The banner marks a stage boundary; no wave passes silently. At each boundary the owning crew reports inline — one compact per-crew report: what ran, the result, the evidence pointer. No narration of every tool call. Each wave closes with a short progress summary (done / in-flight / blocked + next handoff). On failure or risk, PAUSE: report the problem and get a continue / retry / escalate decision before proceeding.
+
 1. For each wave, the main thread loads the owning crew member's skill (e.g. `mugiwara-checkpoint` for Wave 4) and performs that role inline: triage, planning, execution, audit, quality, gates, review, closure — all in the main thread.
 2. Dispatch a subagent ONLY when the work is genuinely parallel or background: an independent `[PARALLEL]` task batch (Zoro's WORKER subagents, Wave 3), parallel fixes (Brook, Wave 8), or a long-running check that would stall the conversation. Subagent results return to the main thread as a report; the main thread summarizes the outcome inline with evidence pointers.
 3. Crew members NEVER dispatch another crew member. A crew role that must split work returns the split plan to the main thread, which spawns the workers.
@@ -45,7 +56,7 @@ At session start, after context loss, or on any "where were we?" — embody `res
 
 ## Wave 0 — Luffy Triage (always first)
 
-Front door: embody `using-mugiwara` inline (the router) — it routes to the right crew member and records the route. For a full triage embody `luffy-orchestrator` inline. NEVER start directly with brainstorming or planning. Luffy classifies every request 5 ways (Trivial / Explicit / Exploratory / Open-ended / Ambiguous) and routes: Trivial and Explicit → Wave 2 directly; Exploratory, Open-ended, and Ambiguous → Wave 1 brainstorm first. The user may summon any crew member directly — Luffy still records the route.
+Front door: embody `using-mugiwara` inline (the router) — it routes to the right crew member and records the route. For a full triage embody `luffy-orchestrator` inline. NEVER start directly with brainstorming or planning. Luffy classifies every request 5 ways (Trivial / Explicit / Exploratory / Open-ended / Ambiguous) and routes: Trivial and Explicit → Wave 2 directly; Exploratory, Open-ended, and Ambiguous → Wave 1 brainstorm first. Alongside the class, Luffy sizes the mission and picks a lane (0 Direct / 1 Lean / 2 Standard / 3 Full / 4 Spike) — small work skips the pipeline, sensitive work never sneaks through the lean path. The user may summon any crew member directly — Luffy still records the route.
 
 Alongside triage, read the mode config per `mugiwara-mode`: `.mugiwara/config` (project) then `~/.mugiwara/config` (global); a key missing from both = `guided`. Lazy-create the project config on first WRITE only, never auto-create on read.
 
@@ -77,12 +88,12 @@ Never silently work around a blocker. Brook reads this ledger at Wave 8 to decid
 
 ## Cleanup
 
-At closure (Wave 9), delete unused intermediate markdown files in `.mugiwara/` — superseded results, review, issues reports, and the per-mission decision log in `logs/`. Keep the plan doc and the closure report.
+At closure (Wave 9), after the terminal step, run the cleanup procedure in `mugiwara-ship`: delete consumed intermediates — superseded results, review, issues reports, the per-mission decision log in `logs/`, and the consumed spec. Keep the plan doc, the closure report, the PR verdict, `config`, and cross-mission state (`logs/lessons.md`, `backup/`, `manifest.json`). List candidates before deleting.
 
 ## Rules
 
 1. Evidence over claims: no wave passes on assertion. The owning agent runs the checks and shows output.
-2. No wave skipped without the reason recorded in the decision log (`.mugiwara/logs/`).
+2. No wave skipped without the reason recorded in the decision log (`.mugiwara/logs/`) — name the wave, owner, and reason at the moment of omission.
 3. Heal loop is bounded: Wave 8 → Wave 4, max 3 cycles. After that, escalate to the human with full history.
 4. Any agent may consult Luffy mid-flight (embody `luffy-orchestrator` inline) for decisions and escalations.
 5. Wave 7 runs Robin and Jinbe review passes in parallel — both are inline passes over the same diff, or parallel review subagents for large diffs.

package/content/skills/mugiwara-writing-skills/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: mugiwara-writing-skills
+description: Use when authoring a new mugiwara skill or revising an existing one. Enforces the skill anatomy (name/description 20-500 chars, when-to-use, process, rationalizations, red flags, verification), the 120-line body ceiling, and progressive disclosure of detail into a references/ file. Meta-skill: governs the other skills.
+---
+
+# Writing Mugiwara Skills
+
+## Skip when
+
+- Not authoring or revising a mugiwara skill — plain application code change.
+- Skill change is a one-line description fix with no anatomy impact.
+
+A skill is a process workflow the agent runs on cue, not a reference guide. If it reads like a wiki page, it fails. The description decides when the skill loads; the body decides what happens next. Both must justify their size.
+
+## Skill anatomy
+
+Every skill is a single `SKILL.md` at `content/skills/<name>/`, plus an optional `references/` folder for pulled-out detail. The name is the directory name; the validator checks that exact match.
+
+| Part | Requirement |
+|------|-------------|
+| name | equals the directory name, `mugiwara-<domain>` |
+| description | one "Use when..." sentence, 20-500 chars, loads the right skill and rejects the wrong ones |
+| body | `# title` + sections below, 120 lines max |
+| references/ | overflow detail, linked from the body |
+
+## When to use
+
+Use this skill the moment you start authoring a new skill file or restructuring an existing one. Skip it only for edits so small they cannot touch anatomy, limits, or wording.
+
+## Process
+
+1. **Confirm the niche.** Grep `content/skills/` for overlap; a new skill must not duplicate an existing one. Name it `mugiwara-<domain>`.
+2. **Write the description first.** One "Use when..." sentence naming the trigger, the behavior, and the boundary of what the skill is not for. Target 60-120 chars; the 500-char cap is a ceiling, not a goal.
+3. **Draft the body as a workflow.** Concrete numbered steps the agent executes, in order, with decisions and branches embedded. Name the skills it reads or dispatches. Use tables for excusable patterns and quick comparisons.
+4. **Cut to the ceiling.** Body must end at 120 lines or fewer. Section-by-section trim: merge subsections, kill throat-clearing, convert prose to tables. `ponytail` and `caveman` instincts apply — the body is command output, not a report.
+5. **Disclose progressively.** If a section exceeds roughly 15-20 lines, move it to `references/<topic>.md`, drop a one-line pointer in the body, and keep the pointer actionable (what to read and why).
+6. **Check the anatomy list.** Each required section present, in order: title, When to use, Process, Rationalizations, Red flags, Verification.
+7. **Validate.** Run `bun scripts/validate-content.ts --check content/skills/<name>/SKILL.md` and leave it exiting 0.
+
+## Rationalizations
+
+| Excuse | Rebuttal |
+|--------|----------|
+| "It's a guide, not a checklist" | A skill the agent cannot execute is decoration. Rewrite every paragraph as a step or a criterion. |
+| "The detail is essential" | Then move it to `references/` and keep the body a decision tree, not a dump. |
+| "More lines mean more coverage" | 120 lines enforce focus. Cover the decision, not the encyclopedia. |
+| "Long description catches more triggers" | A description that matches everything loads on nothing specific and trains the agent to ignore the skill. |
+| "Patterns are the same everywhere, I'll mirror another skill's text" | Wording must be original. Mirror the shape, never the sentences. |
+| "It's fine for now, I'll validate later" | Validation is the last step of the write, not a follow-up task. |
+
+## Red flags
+
+- Body over 120 lines or a description outside 20-500 chars.
+- No "Use when..." trigger sentence, or a description that names no boundary.
+- A section that reads as a lecture instead of steps the agent can run.
+- Required sections missing or out of order.
+- Text copied from another skill, superpowers, or agent-skills.
+- A `references/` file that is unreferenced, or a body so crammed it needed none.
+- An unvalidated file reported as done.
+
+Any of these: revise the skill, re-run validation, and confirm both before reporting.
+
+## Verification
+
+Evidence of a complete skill: the file passes `--check` with exit 0; `wc -l` on the body is at or under 120; the description triggers only its intended cases; every required section is present and original; and any overflow sits in a linked `references/` file.

package/dist/mugiwara.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { existsSync as existsSync4, readFileSync as readFileSync3, readdirSync as readdirSync2, realpathSync, rmSync as rmSync2 } from "node:fs";
+import { existsSync as existsSync6, realpathSync, rmSync as rmSync3 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { join as join7, resolve } from "node:path";
+import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 
 // src/args.ts
@@ -14,6 +14,7 @@ var BOOL_FLAGS = {
   "-y": "yes",
   "--force": "force",
   "--dry-run": "dryRun",
+  "--keep-logs": "keepLogs",
   "--help": "help",
   "-h": "help",
   "--version": "version",
@@ -79,7 +80,9 @@ async function confirm(rl, question) {
 }
 
 // src/targets/claude.ts
-import { join } from "node:path";
+import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 
 // src/frontmatter.ts
 function parseFrontmatter(text) {
@@ -107,6 +110,8 @@ ${body}`;
 }
 
 // src/targets/claude.ts
+var here = dirname(fileURLToPath(import.meta.url));
+var HOOK_SRC = join(here, "..", "..", "hooks", "session-start.ts");
 var target = {
   id: "claude",
   label: "Claude Code",
@@ -126,6 +131,22 @@ var target = {
     if (data.tools)
       fm.tools = data.tools;
     return { relPath: `${data.name}.md`, text: stringifyFrontmatter(fm, body) };
+  },
+  refsDir({ scope, projectDir, home }, skillName) {
+    const root = scope === "global" ? join(home, ".claude") : join(projectDir, ".claude");
+    return join(root, "skills", skillName, "references");
+  },
+  postInstall({ scope, projectDir, home, dryRun }) {
+    const root = scope === "global" ? join(home, ".claude") : join(projectDir, ".claude");
+    const hookFile = join(root, "hooks", "session-start.ts");
+    if (dryRun)
+      return { written: [], notes: [] };
+    if (existsSync(HOOK_SRC) && !existsSync(hookFile)) {
+      mkdirSync(dirname(hookFile), { recursive: true });
+      copyFileSync(HOOK_SRC, hookFile);
+      return { written: [hookFile], notes: [] };
+    }
+    return { written: [], notes: [] };
   }
 };
 
@@ -150,6 +171,10 @@ var target2 = {
     if (data.tools)
       fm.tools = data.tools;
     return { relPath: `${data.name}.md`, text: stringifyFrontmatter(fm, body) };
+  },
+  refsDir({ scope, projectDir, home }, skillName) {
+    const root = scope === "global" ? join2(home, ".config", "opencode") : join2(projectDir, ".opencode");
+    return join2(root, "skills", skillName, "references");
   }
 };
 
@@ -174,18 +199,23 @@ var target3 = {
       relPath: `${data.name}.md`,
       text: stringifyFrontmatter({ name: data.name, description: data.description }, body)
     };
+  },
+  refsDir(_opts, skillName) {
+    return join3(_opts.projectDir, ".mugiwara", "refs", skillName);
   }
 };
 
 // src/targets/generic.ts
-import { existsSync, writeFileSync } from "node:fs";
+import { existsSync as existsSync2, writeFileSync } from "node:fs";
 import { join as join4 } from "node:path";
 function makeGeneric(opts) {
-  const { id, label, rulesDir, bootstrapFile, bootstrapPointer } = opts;
+  const { id, label, rulesDir, bootstrapFile, bootstrapPointer, tier = bootstrapPointer ? 2 : 3 } = opts;
+  const stubOnly = tier === 3;
   return {
     id,
     label,
     native: false,
+    tier,
     paths({ scope, projectDir }) {
       if (scope === "global")
         throw new Error(`${label} supports project scope only`);
@@ -193,6 +223,27 @@ function makeGeneric(opts) {
       return { skillsDir: dir, agentsDir: dir };
     },
     transformSkill(data, body) {
+      if (stubOnly) {
+        return {
+          relPath: `${data.name}.md`,
+          text: `# ${data.name}
+
+> ${data.description}
+
+## Skip when
+
+Full skill: \`${data.name}\` — read \`.mugiwara/refs/${data.name}.md\` when the crew invokes this role.`
+        };
+      }
+      return { relPath: `${data.name}.md`, text: `# ${data.name}
+
+> ${data.description}
+
+${body}` };
+    },
+    transformSkillFull(data, body) {
+      if (!stubOnly)
+        return null;
       return { relPath: `${data.name}.md`, text: `# ${data.name}
 
 > ${data.description}
@@ -200,6 +251,16 @@ function makeGeneric(opts) {
 ${body}` };
     },
     transformAgent(data, body) {
+      if (stubOnly) {
+        return {
+          relPath: `agent-${data.name}.md`,
+          text: `# Agent: ${data.name}
+
+> ${data.description}
+
+Skills: ${data.skills ?? ""}. Read \`.mugiwara/refs/${data.name}.md\` when embodying this role.`
+        };
+      }
       return { relPath: `agent-${data.name}.md`, text: `# Agent: ${data.name}
 
 > ${data.description}
@@ -208,13 +269,27 @@ Skills used: ${data.skills ?? ""}
 
 ${body}` };
     },
+    transformAgentFull(data, body) {
+      if (!stubOnly)
+        return null;
+      return { relPath: `${data.name}.md`, text: `# Agent: ${data.name}
+
+> ${data.description}
+
+Skills used: ${data.skills ?? ""}
+
+${body}` };
+    },
+    refsDir({ projectDir }) {
+      return join4(projectDir, ".mugiwara", "refs");
+    },
     postInstall({ projectDir, dryRun }) {
       if (!bootstrapFile)
         return { written: [], notes: [] };
       const notes = [];
       const written = [];
       const file = join4(projectDir, bootstrapFile);
-      if (!existsSync(file)) {
+      if (!existsSync2(file)) {
         if (!dryRun)
           writeFileSync(file, `${bootstrapPointer}
 `);
@@ -233,7 +308,7 @@ var target4 = makeGeneric({
   label: "Gemini",
   rulesDir: ".gemini/mugiwara",
   bootstrapFile: "GEMINI.md",
-  bootstrapPointer: "Mugiwara crew installed in .gemini/mugiwara/ — read .gemini/mugiwara/mugiwara-workflow.md to run the pipeline."
+  bootstrapPointer: "Mugiwara crew installed in .gemini/mugiwara/ — read .gemini/mugiwara/mugiwara-workflow.md to run the pipeline inline in the main conversation."
 });
 
 // src/targets/codex.ts
@@ -242,7 +317,7 @@ var target5 = makeGeneric({
   label: "Codex",
   rulesDir: ".codex/mugiwara",
   bootstrapFile: "AGENTS.md",
-  bootstrapPointer: "Mugiwara crew installed in .codex/mugiwara/ — read .codex/mugiwara/mugiwara-workflow.md to run the pipeline."
+  bootstrapPointer: "Mugiwara crew installed in .codex/mugiwara/ — read .codex/mugiwara/mugiwara-workflow.md to run the pipeline inline in the main conversation."
 });
 
 // src/targets/windsurf.ts
@@ -273,7 +348,8 @@ var target8 = makeGeneric({
   "instructions": [
     ".kilo/rules/*.md"
   ]
-}`
+}`,
+  tier: 3
 });
 
 // src/targets/antigravity.ts
@@ -290,24 +366,30 @@ var targets = { claude: target, opencode: target2, copilot: target3, gemini: tar
 var TARGET_IDS = Object.keys(targets);
 
 // src/installer.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync, readdirSync, writeFileSync as writeFileSync2, copyFileSync, rmSync } from "node:fs";
-import { dirname, join as join5 } from "node:path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, readdirSync, writeFileSync as writeFileSync2, copyFileSync as copyFileSync2, rmSync } from "node:fs";
+import { dirname as dirname2, join as join5 } from "node:path";
 import { homedir } from "node:os";
 var CONTENT_DIR = join5(import.meta.dirname, "..", "content");
-var pkg = JSON.parse(readFileSync(join5(import.meta.dirname, "..", "package.json"), "utf8"));
+var pkg = JSON.parse(readFileSync2(join5(import.meta.dirname, "..", "package.json"), "utf8"));
 var VERSION = pkg.version;
 function collectContent() {
   const skillNames = readdirSync(join5(CONTENT_DIR, "skills"), { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
   const skills = skillNames.map((name) => {
-    const { data, body } = parseFrontmatter(readFileSync(join5(CONTENT_DIR, "skills", name, "SKILL.md"), "utf8"));
-    return { name, data, body };
+    const { data, body } = parseFrontmatter(readFileSync2(join5(CONTENT_DIR, "skills", name, "SKILL.md"), "utf8"));
+    return { name, data, body, refs: collectRefs(join5(CONTENT_DIR, "skills", name)) };
   });
   const agents = readdirSync(join5(CONTENT_DIR, "agents")).filter((f) => f.endsWith(".md")).map((f) => {
-    const { data, body } = parseFrontmatter(readFileSync(join5(CONTENT_DIR, "agents", f), "utf8"));
-    return { name: f.replace(/\.md$/, ""), data, body };
+    const { data, body } = parseFrontmatter(readFileSync2(join5(CONTENT_DIR, "agents", f), "utf8"));
+    return { name: f.replace(/\.md$/, ""), data, body, refs: [] };
   });
   return { skills, agents };
 }
+function collectRefs(skillDir) {
+  const refsDir = join5(skillDir, "references");
+  if (!existsSync3(refsDir))
+    return [];
+  return readdirSync(refsDir, { recursive: true }).map((f) => String(f)).filter((f) => f.endsWith(".md")).map((rel) => ({ relPath: rel, text: readFileSync2(join5(refsDir, rel), "utf8") }));
+}
 function installTo(target10, opts) {
   const { scope, projectDir, dryRun = false, force = false } = opts;
   const home = opts.home ?? homedir();
@@ -316,8 +398,8 @@ function installTo(target10, opts) {
   const backupRoot = join5(scope === "global" ? home : projectDir, ".mugiwara");
   const result = { written: [], skipped: [], backedUp: [], notes: [] };
   const writeOne = (absPath, text) => {
-    if (existsSync2(absPath)) {
-      if (readFileSync(absPath, "utf8") === text) {
+    if (existsSync3(absPath)) {
+      if (readFileSync2(absPath, "utf8") === text) {
         result.skipped.push(absPath);
         return;
       }
@@ -329,13 +411,13 @@ function installTo(target10, opts) {
       const ts = new Date().toISOString().replace(/[:.]/g, "-");
       const backupFile = join5(backupRoot, "backup", ts, absPath.replace(/[^a-zA-Z0-9]+/g, "_"));
       if (!dryRun) {
-        mkdirSync(dirname(backupFile), { recursive: true });
-        copyFileSync(absPath, backupFile);
+        mkdirSync2(dirname2(backupFile), { recursive: true });
+        copyFileSync2(absPath, backupFile);
       }
       result.backedUp.push(absPath);
     }
     if (!dryRun) {
-      mkdirSync(dirname(absPath), { recursive: true });
+      mkdirSync2(dirname2(absPath), { recursive: true });
       writeFileSync2(absPath, text);
     }
     result.written.push(absPath);
@@ -344,11 +426,26 @@ function installTo(target10, opts) {
     const out = target10.transformSkill(s.data, s.body);
     if (out)
       writeOne(join5(dirs.skillsDir, out.relPath), out.text);
+    if (target10.transformSkillFull) {
+      const full = target10.transformSkillFull(s.data, s.body);
+      if (full && target10.refsDir)
+        writeOne(join5(target10.refsDir({ scope, projectDir, home }, s.name), full.relPath), full.text);
+    }
+    if (s.refs.length && target10.refsDir) {
+      const refsRoot = target10.refsDir({ scope, projectDir, home }, s.name);
+      for (const r of s.refs)
+        writeOne(join5(refsRoot, r.relPath), r.text);
+    }
   }
   for (const a of agents) {
     const out = target10.transformAgent(a.data, a.body);
     if (out)
       writeOne(join5(dirs.agentsDir, out.relPath), out.text);
+    if (target10.transformAgentFull) {
+      const full = target10.transformAgentFull(a.data, a.body);
+      if (full && target10.refsDir)
+        writeOne(join5(target10.refsDir({ scope, projectDir, home }, a.name), full.relPath), full.text);
+    }
   }
   if (target10.postInstall) {
     const post = target10.postInstall({ scope, projectDir, home, dryRun, files: result.written });
@@ -360,7 +457,7 @@ function installTo(target10, opts) {
 function removeInstalled(manifest, { dryRun = false } = {}) {
   const removed = [];
   for (const f of manifest.files) {
-    if (existsSync2(f)) {
+    if (existsSync3(f)) {
       if (!dryRun)
         rmSync(f);
       removed.push(f);
@@ -368,10 +465,10 @@ function removeInstalled(manifest, { dryRun = false } = {}) {
   }
   if (!dryRun) {
     for (const f of manifest.files) {
-      let d = dirname(f);
-      while (existsSync2(d) && readdirSync(d).length === 0) {
+      let d = dirname2(f);
+      while (existsSync3(d) && readdirSync(d).length === 0) {
         rmSync(d, { recursive: true });
-        const parent = dirname(d);
+        const parent = dirname2(d);
         if (parent === d)
           break;
         d = parent;
@@ -382,20 +479,52 @@ function removeInstalled(manifest, { dryRun = false } = {}) {
 }
 
 // src/manifest.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname as dirname2, join as join6 } from "node:path";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { dirname as dirname3, join as join6 } from "node:path";
 function manifestPath({ scope, projectDir, home }) {
   return scope === "global" ? join6(home, ".mugiwara", "manifest.json") : join6(projectDir, ".mugiwara", "manifest.json");
 }
 function readManifest(file) {
-  return existsSync3(file) ? JSON.parse(readFileSync2(file, "utf8")) : null;
+  return existsSync4(file) ? JSON.parse(readFileSync3(file, "utf8")) : null;
 }
 function writeManifest(file, data) {
-  mkdirSync2(dirname2(file), { recursive: true });
+  mkdirSync3(dirname3(file), { recursive: true });
   writeFileSync3(file, JSON.stringify(data, null, 2) + `
 `);
 }
 
+// src/mission.ts
+import { existsSync as existsSync5, rmSync as rmSync2 } from "node:fs";
+import { join as join7 } from "node:path";
+function resetMission(projectDir, keepLogs) {
+  const root = join7(projectDir, ".mugiwara");
+  if (!existsSync5(root))
+    return { removed: [], kept: [] };
+  const removed = [];
+  const kept = [];
+  for (const dir of ["spec", "plans", "results", "review", "issues"]) {
+    const p = join7(root, dir);
+    if (existsSync5(p)) {
+      rmSync2(p, { recursive: true, force: true });
+      removed.push(dir);
+    }
+  }
+  if (!keepLogs) {
+    const p = join7(root, "logs");
+    if (existsSync5(p)) {
+      rmSync2(p, { recursive: true, force: true });
+      removed.push("logs");
+    }
+  } else if (existsSync5(join7(root, "logs"))) {
+    kept.push("logs");
+  }
+  for (const f of ["config", "manifest.json", "backup"]) {
+    if (existsSync5(join7(root, f)))
+      kept.push(f);
+  }
+  return { removed, kept };
+}
+
 // src/cli.ts
 var str = (v) => typeof v === "string" ? v : undefined;
 var flag = (v) => v === true;
@@ -416,12 +545,22 @@ async function run(argv) {
       return uninstall(flags);
     case "list":
       return list(flags);
-    case "skills":
-      return skills();
+    case "reset":
+      return resetCmd(flags);
     default:
       throw new Error(`Unknown command: ${command}`);
   }
 }
+function resetCmd(flags) {
+  const projectDir = resolve(str(flags.project) ?? process.cwd());
+  const { removed, kept } = resetMission(projectDir, flag(flags.keepLogs));
+  if (removed.length)
+    console.log(`removed: ${removed.join(", ")}`);
+  else
+    console.log("nothing to remove.");
+  if (kept.length)
+    console.log(`kept: ${kept.join(", ")}`);
+}
 async function resolveOptions(flags) {
   const interactive = !flag(flags.yes);
   const rl = interactive ? createRl() : null;
@@ -433,7 +572,7 @@ async function resolveOptions(flags) {
       scope = await choose(rl, "Install scope?", ["global (user-wide)", "project (this repo)"]) === 0 ? "global" : "project";
     }
     const projectDir = resolve(str(flags.project) ?? process.cwd());
-    if (scope === "project" && !existsSync4(projectDir))
+    if (scope === "project" && !existsSync6(projectDir))
       throw new Error(`Project dir not found: ${projectDir}`);
     let targetIds = str(flags.target)?.split(",").map((s) => s.trim()) ?? null;
     if (targetIds && targetIds.includes("all"))
@@ -517,7 +656,7 @@ async function uninstall(flags) {
   }
   const removed = removeInstalled(manifest, { dryRun: flag(flags.dryRun) });
   if (!flag(flags.dryRun))
-    rmSync2(file);
+    rmSync3(file);
   console.log(`OK removed ${removed.length} files`);
 }
 function list(flags) {
@@ -537,22 +676,6 @@ function list(flags) {
   if (!found)
     console.log("No mugiwara installation found.");
 }
-function skills() {
-  const dir = join7(CONTENT_DIR, "skills");
-  const names = readdirSync2(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
-  const rows = names.map((name) => {
-    const { data } = parseFrontmatter(readFileSync3(join7(dir, name, "SKILL.md"), "utf8"));
-    return [name, data.description ?? ""];
-  });
-  const w = Math.max(...rows.map((r) => r[0].length)) + 2;
-  console.log(`mugiwara ${VERSION} — ${rows.length} skills (agentskills.io format):
-`);
-  for (const [name, description] of rows)
-    console.log(`  ${name.padEnd(w)}${description}`);
-  console.log(`
-Install skills into any agent via skills.sh:
-  npx skills add ionivetech/mugiwara`);
-}
 function help() {
   console.log(`mugiwara ${VERSION} — the Straw Hat crew for AI agents
 
@@ -561,7 +684,7 @@ Usage:
   mugiwara update        replace existing files (backs up differences first)
   mugiwara uninstall     remove installed files via manifest
   mugiwara list          show installations
-  mugiwara skills        list installable skills (agentskills.io)
+  mugiwara reset         wipe mission state (spec/plans/results/review/issues[/logs])
   mugiwara --help        this help
   mugiwara --version     print version
 
@@ -571,7 +694,8 @@ Flags:
   --target <ids|all>     comma-separated: ${TARGET_IDS.join(", ")}
   --yes, -y              non-interactive (needs --global/--project, --target)
   --force                overwrite differing files (with backup)
-  --dry-run              print actions without writing`);
+  --dry-run              print actions without writing
+  --keep-logs            with reset: keep .mugiwara/logs (lessons ledger survives)`);
 }
 var entry = process.argv[1] !== undefined ? resolve(process.argv[1]) : undefined;
 if (entry !== undefined) {

package/docs/adoption-guide.md

@@ -16,7 +16,7 @@ markdown rule files everywhere else.
 
 Native targets (Claude Code, opencode, Copilot) register the 15 agents directly.
 Rule-based targets (Gemini, Codex, Cursor, Windsurf, Cline, Kilo, Antigravity)
-get the same 25 skills as markdown rules plus a bootstrap pointer, so the crew
+get the same 32 skills as markdown rules plus a bootstrap pointer, so the crew
 is still steered even where subagents don't exist.
 
 ## Pick your mode
@@ -43,8 +43,8 @@ mid-wave.
 
 ## Fit the crew to your workflow
 
-- **Trivial one-liners** don't need the crew — Luffy routes them straight to
-  execution.
+- **Trivial one-liners** don't need the crew's full pipeline — Luffy routes them
+  to Lane 0 and they run with zero waves. The process scales to the work.
 - **Medium features** run the standard pipeline: triage → plan → execute →
   checkpoint → quality → gates → review → closure.
 - **High-stakes work** (money, security, data, public API) always gets the full

package/docs/agents.md

@@ -44,8 +44,8 @@ check-ins. The harness stays coherent either way.
 
 ## The crew ships whole
 
-Every install gets all 15 agents and all 25 skills. No project-type selection —
+Every install gets all 15 agents and all 32 skills. No project-type selection —
 the harness routes each task to the right specialist.
 
-See [skills.md](skills.md) for the 25 techniques, or
+See [skills.md](skills.md) for the 32 techniques, or
 [workflow.md](workflow.md) for the pipeline.

package/docs/claude-setup.md

@@ -20,19 +20,24 @@ npx @ionivetech/mugiwara@latest --global --target claude --yes
 npx @ionivetech/mugiwara@latest --project ./my-app --target claude --yes
 ```
 
+**Update** — re-install from the marketplace (or `mugiwara update` via CLI).
+
+**Uninstall** — `/plugin uninstall mugiwara`, or `mugiwara uninstall` via CLI.
+
 ## What you get
 
-- 25 skills in `~/.claude/skills/` (global) or `.claude/skills/` (project).
+- 32 skills in `~/.claude/skills/` (global) or `.claude/skills/` (project).
 - 15 agents in `~/.claude/agents/` or `.claude/agents/`.
-- A SessionStart hook that announces the crew.
+- A SessionStart hook that announces the crew and auto-activates the workflow —
+  a non-trivial request runs the pipeline by itself. `/using-mugiwara` is an
+  optional explicit router if you want to hand-route a mission.
 
 ## Use it
 
 ```
-> use mugiwara
 > add dark mode to the settings page
 ```
 
 The crew runs inline in your main conversation; subagents only for parallel
 batches. At closure the crew pushes the branch and hands you the PR verdict
-file — you open the PR.
+file with a ready PR summary block — you open the PR, in every mode.

package/docs/codex-setup.md

@@ -13,9 +13,11 @@ Or via the CLI:
 npx @ionivetech/mugiwara@latest --project ./my-app --target codex --yes
 ```
 
+**Update** — `codex plugin update mugiwara`. **Uninstall** — `codex plugin remove mugiwara`.
+
 ## What you get
 
-- 25 skills as markdown rules in `.codex/mugiwara/`.
+- 32 skills as markdown rules in `.codex/mugiwara/`.
 - An `AGENTS.md` bootstrap pointer (created if missing).
 
 ## Notes