@ionivetech/mugiwara 0.5.1 → 0.5.3

package/docs/install-cli.md

@@ -0,0 +1,103 @@
+# CLI Install (Windsurf, Cline, Kilo)
+
+These platforms don't have native plugin systems. Use the mugiwara CLI
+installer to copy files into the platform's config directory.
+
+## Prerequisites
+
+- Node.js >= 20.11
+
+## Install
+
+```bash
+npx @ionivetech/mugiwara@latest install --target <id> --yes
+```
+
+Replace `<id>` with one of: `windsurf`, `cline`, `kilo`.
+
+Or install globally first:
+
+```bash
+npm i -g @ionivetech/mugiwara
+mugiwara install --target <id> --yes
+```
+
+### What gets written
+
+| Target | Skills/agents | References | Bootstrap |
+|--------|---------------|------------|-----------|
+| Windsurf | `.devin/rules/*.md` (stubs) | `.mugiwara/refs/*.md` | — |
+| Cline | `.clinerules/*.md` (stubs) | `.mugiwara/refs/*.md` | — |
+| Kilo | `.kilo/rules/*.md` (stubs) | `.mugiwara/refs/*.md` | `kilo.jsonc` |
+
+Tier 3 targets use stubs (pointer + routing) to keep rule files small.
+Full skill bodies live in `.mugiwara/refs/` — the agent loads them on demand.
+
+### Interactive mode
+
+Drop `--yes` for the interactive wizard:
+
+```bash
+npx @ionivetech/mugiwara install
+```
+
+Pick scope (global/project), target(s), and confirm before writing.
+
+### Multiple targets
+
+```bash
+npx @ionivetech/mugiwara install --target windsurf,cline,kilo --yes
+```
+
+Or all available targets:
+
+```bash
+npx @ionivetech/mugiwara install --target all --yes
+```
+
+## Verify
+
+Ask your agent:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+```bash
+mugiwara update
+# or: npx @ionivetech/mugiwara@latest update
+```
+
+## Uninstall
+
+```bash
+mugiwara uninstall
+```
+
+## Global install
+
+```bash
+mugiwara install --global --target <id> --yes
+```
+
+Installs to `~/.devin/rules/` (Windsurf), `~/.clinerules/` (Cline), or
+`~/.kilo/rules/` (Kilo).
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).
+
+## CLI reference
+
+```bash
+mugiwara install                                  # wizard (interactive)
+mugiwara install --project . --target all --yes   # non-interactive
+mugiwara update                                   # replace existing files
+mugiwara uninstall                                # remove what manifest recorded
+mugiwara list                                     # show installations
+mugiwara reset --keep-logs                        # wipe mission state, keep lessons
+mugiwara reset --force                            # override multi-actor guard
+```

package/docs/install-codex.md

@@ -0,0 +1,44 @@
+# Codex Install
+
+Mugiwara installs as a native Codex plugin.
+
+## Prerequisites
+
+- [Codex](https://github.com/openai/codex) CLI or app installed
+
+## Install
+
+```bash
+codex plugin marketplace add ionivetech/mugiwara && codex plugin add mugiwara@mugiwara
+```
+
+## How it works
+
+Codex reads `.codex-plugin/plugin.json` which references `content/skills/`.
+All 26 skills are auto-discovered. Agents come from `content/agents/` via the
+`agents/` symlink.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+```bash
+codex plugin update mugiwara
+```
+
+## Uninstall
+
+```bash
+codex plugin remove mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-copilot.md

@@ -0,0 +1,45 @@
+# GitHub Copilot Install
+
+Mugiwara installs as a Copilot plugin directly from the GitHub repo.
+
+## Prerequisites
+
+- [GitHub Copilot](https://docs.github.com/en/copilot) extension installed
+
+## Install
+
+```bash
+copilot plugin install https://github.com/ionivetech/mugiwara
+```
+
+## How it works
+
+Copilot clones the repo and auto-discovers skills from `content/skills/`
+and agents from `content/agents/`.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+Reinstall with the same command:
+
+```bash
+copilot plugin install https://github.com/ionivetech/mugiwara
+```
+
+## Uninstall
+
+```bash
+copilot plugin uninstall mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-cursor.md

@@ -0,0 +1,45 @@
+# Cursor Install
+
+Mugiwara installs through Cursor's plugin marketplace.
+
+## Prerequisites
+
+- [Cursor](https://cursor.com) installed
+
+## Install
+
+```
+/add-plugin mugiwara
+```
+
+## How it works
+
+Cursor reads `.cursor-plugin/plugin.json` and auto-discovers skills from
+`content/skills/`.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+Re-run:
+
+```
+/add-plugin mugiwara
+```
+
+## Uninstall
+
+```
+/remove-plugin mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-gemini.md

@@ -0,0 +1,44 @@
+# Gemini CLI Install
+
+Mugiwara installs as a Gemini CLI extension.
+
+## Prerequisites
+
+- [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed
+
+## Install
+
+```bash
+gemini extensions install https://github.com/ionivetech/mugiwara
+```
+
+## How it works
+
+Gemini reads `gemini-extension.json` (which points to `GEMINI.md` as the
+context file) and auto-discovers skills from `content/skills/`. The
+`GEMINI.md` file describes the crew and workflow bootstrap.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+```bash
+gemini extensions update mugiwara
+```
+
+## Uninstall
+
+```bash
+gemini extensions remove mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-kimi.md

@@ -0,0 +1,45 @@
+# Kimi Code Install
+
+Mugiwara installs through Kimi Code's plugin system.
+
+## Prerequisites
+
+- [Kimi Code](https://kimi.moonshot.cn) installed
+
+## Install
+
+```
+/plugins install https://github.com/ionivetech/mugiwara
+```
+
+## How it works
+
+Kimi Code reads `.kimi-plugin/plugin.json` and auto-discovers skills from
+`content/skills/`.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+Reinstall:
+
+```
+/plugins install https://github.com/ionivetech/mugiwara
+```
+
+## Uninstall
+
+```
+/plugins remove mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-opencode.md

@@ -0,0 +1,129 @@
+# OpenCode Install
+
+Mugiwara installs through OpenCode's native npm plugin system.
+
+## Prerequisites
+
+- [OpenCode](https://opencode.ai) installed
+- Node.js >= 20.11
+
+## Install
+
+Add to `opencode.json` (global at `~/.config/opencode/opencode.json` or
+project-level at `.opencode/opencode.json`):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@ionivetech/mugiwara"]
+}
+```
+
+Restart OpenCode.
+
+### Pinning a version
+
+```json
+{ "plugin": ["@ionivetech/mugiwara@^0.5.0"] }
+```
+
+## How it works
+
+The plugin (`mugiwara.mjs`) does three things:
+
+1. **Config hook** — registers `content/skills/` as a skills path and
+   `content/agents/` as agents so OpenCode discovers the full crew
+   (26 skills + 14 agents) without any file copying.
+
+2. **System transform hook** — injects the crew announce header and active
+   autonomy mode into every session's system prompt.
+
+3. **Chat message hook** — intercepts `/mugiwara-mode` commands and
+   natural-language mode switches, writing `.mugiwara/config`.
+
+Skills are loaded on-demand via OpenCode's native `skill` tool. Agents appear
+as subagents with full config (color, temperature, permissions, step limits).
+
+## Verify
+
+Ask your agent:
+
+```
+what mugiwara crew members are available?
+```
+
+Or type `/mugiwara` to see the crew router.
+
+## Update
+
+```bash
+npm update @ionivetech/mugiwara
+```
+
+Or bump the version constraint in `opencode.json` and restart.
+
+## Uninstall
+
+Remove `"@ionivetech/mugiwara"` from the `plugin` array in `opencode.json`,
+then restart OpenCode.
+
+## Troubleshooting
+
+### Plugin not loading
+
+1. Check logs: `opencode --print-logs`
+2. Verify the plugin line in `opencode.json`
+3. Ensure you're on a recent OpenCode version
+
+### Server error on startup
+
+Fixed in v0.5.3. Ensure you're on the latest:
+
+```bash
+npm update @ionivetech/mugiwara
+```
+
+If it persists, file at https://github.com/ionivetech/mugiwara/issues.
+
+### Skills not found
+
+1. Use the `skill` tool to list available skills
+2. Check the plugin loaded (see "Plugin not loading")
+3. Each skill needs a `SKILL.md` with valid YAML frontmatter (`name`, `description`)
+
+### Windows
+
+Some Windows OpenCode builds have Bun path issues with npm packages. If the
+plugin won't install, try:
+
+```powershell
+npm install @ionivetech/mugiwara --prefix "$HOME\.config\opencode"
+```
+
+Then use the local path in `opencode.json`:
+
+```json
+{ "plugin": ["~/.config/opencode/node_modules/@ionivetech/mugiwara"] }
+```
+
+## Tool mapping
+
+Mugiwara skills reference general actions. On OpenCode these map to:
+
+| Action | OpenCode tool |
+|--------|---------------|
+| Create a todo | `todowrite` |
+| Dispatch a subagent | `task` with `subagent_type` |
+| Invoke a skill | `skill` |
+| Read a file | `read` |
+| Edit a file | `edit` or `write` |
+| Run a shell command | `bash` |
+| Search code | `grep`, `glob` |
+| Fetch a URL | `webfetch` |
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).
+
+Switch autonomy mode at runtime: `/mugiwara-mode guided|semi|auto`

package/docs/install-pi.md

@@ -0,0 +1,46 @@
+# Pi Install
+
+Mugiwara installs as a Pi package.
+
+## Prerequisites
+
+- [Pi](https://github.com/pi) CLI installed
+
+## Install
+
+```bash
+pi install git:github.com/ionivetech/mugiwara
+```
+
+## How it works
+
+Pi reads `package.json` `pi` field (`skills: ["./content/skills"]`) and
+loads all 26 skills. The Pi extension (`pi-extension/`) registers runtime
+hooks if present.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+Reinstall with the same command:
+
+```bash
+pi install git:github.com/ionivetech/mugiwara
+```
+
+## Uninstall
+
+```bash
+pi remove mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install.md

@@ -0,0 +1,53 @@
+# Install Mugiwara
+
+Mugiwara installs as a native plugin on every supported platform. Pick your
+platform below for detailed instructions.
+
+Requires **Node.js >= 20.11** on the host machine.
+
+## Platforms
+
+| Platform | Install doc | Native plugin? |
+|----------|-------------|:---:|
+| Claude Code | [install-claude](install-claude.md) | ✅ |
+| OpenCode | [install-opencode](install-opencode.md) | ✅ |
+| Gemini CLI | [install-gemini](install-gemini.md) | ✅ |
+| Codex | [install-codex](install-codex.md) | ✅ |
+| GitHub Copilot | [install-copilot](install-copilot.md) | ✅ |
+| Cursor | [install-cursor](install-cursor.md) | ✅ |
+| Antigravity | [install-antigravity](install-antigravity.md) | ✅ |
+| Kimi Code | [install-kimi](install-kimi.md) | ✅ |
+| Pi | [install-pi](install-pi.md) | ✅ |
+| Windsurf / Cline / Kilo | [install-cli](install-cli.md) | CLI-based |
+
+## One-liner
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/ionivetech/mugiwara/main/scripts/install.sh | bash
+# Windows
+irm https://raw.githubusercontent.com/ionivetech/mugiwara/main/scripts/install.ps1 | iex
+```
+
+## Global CLI
+
+```bash
+npm i -g @ionivetech/mugiwara
+mugiwara install --target all --yes
+```
+
+## Verify
+
+On any platform, ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Configuration
+
+See [docs/config.md](config.md) for all `.mugiwara/config` options.
+
+## Report issues
+
+https://github.com/ionivetech/mugiwara/issues

package/docs/opencode-setup.md

@@ -35,7 +35,7 @@ npx @ionivetech/mugiwara@latest --project ./my-app --target opencode --yes
 
 - 32 skills in `.opencode/skills/` (project) or `~/.config/opencode/skills/`
   (global).
-- 15 agents registered as subagents via the plugin.
+- 14 agents registered as subagents via the plugin.
 - The plugin announces the crew at session start and injects the inline
   execution model into the system prompt.
 

package/docs/skills.md

@@ -35,7 +35,7 @@ it embodies a role.
 
 | Skill | Teaches |
 |-------|---------|
-| `mugiwara-proof-order` | RED-GREEN-REFACTOR — proof value from WHEN the test runs, not that it exists |
+| `using-mugiwara` | Front-door router — explains the crew, classifies missions, routes to specialist |
 | `mugiwara-root-cause` | 4-phase: reproduce → localize → reduce → fix + guard; stop-the-line |
 | `mugiwara-contract-first` | Contract-first design, error semantics, boundary validation, backward compatibility |
 | `mugiwara-claim-audit` | Adversarial verification: CLAIM → EXTRACT → DOUBT → RECONCILE → STOP |

package/evals/cases/routing-claim-audit.json

@@ -5,7 +5,7 @@
     "positive": [
       { "prompt": "verify this claim before we proceed, it could be wrong", "top_k": 3 },
       { "prompt": "the agent says the fix is done but I want to double-check", "top_k": 3 },
-      { "prompt": "audit this in-flight decision before we commit to it", "top_k": 3 }
+      { "prompt": "skeptically verify this claim and doubt every assertion the model made", "top_k": 3 }
     ],
     "negative": [
       { "prompt": "run the test suite to make sure nothing is broken" },

package/evals/cases/routing-using-mugiwara.json

@@ -0,0 +1,25 @@
+{
+  "name": "routing-using-mugiwara",
+  "skill": "using-mugiwara",
+  "trigger": {
+    "positive": [
+      { "prompt": "how do I use mugiwara to accomplish a task?", "top_k": 3 },
+      { "prompt": "what crew members are available?", "top_k": 3 },
+      { "prompt": "route this task to the right specialist", "top_k": 3 }
+    ],
+    "negative": [
+      { "prompt": "what does git status do?" },
+      { "prompt": "run npm install for me" }
+    ]
+  },
+  "behavioral": [
+    {
+      "task": "Explain how mugiwara works and route a simple task.",
+      "rubric": [
+        "explains the crew structure",
+        "classifies the task correctly",
+        "routes to the right specialist"
+      ]
+    }
+  ]
+}

package/evals/floor.json

@@ -1,6 +1,6 @@
 {
   "rank1": 88.2,
-  "topk": 100,
+  "topk": 98.7,
   "negatives": 100,
   "updated": "2026-08-11"
 }

package/gemini-extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "mugiwara",
+  "version": "0.5.3",
+  "description": "The Straw Hat crew of AI agents and skills: brainstorm, plan, execute, checkpoint, quality, gates, review, security, healing.",
+  "contextFileName": "GEMINI.md"
+}

package/hooks/hooks.json

@@ -10,6 +10,17 @@
           }
         ]
       }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}\"/hooks/mugiwara-mode-tracker.ts",
+            "timeout": 5
+          }
+        ]
+      }
     ]
   }
 }