@ionivetech/mugiwara 0.5.5 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +3 -2
- package/.codex-plugin/plugin.json +1 -1
- package/.cursor-plugin/plugin.json +1 -1
- package/.kimi-plugin/plugin.json +1 -1
- package/.opencode/commands/mugiwara-continue.md +16 -0
- package/.opencode/commands/mugiwara-execute.md +6 -4
- package/.opencode/commands/mugiwara-heal.md +6 -4
- package/.opencode/commands/mugiwara-plan.md +6 -4
- package/.opencode/commands/mugiwara-review.md +6 -4
- package/.opencode/commands/mugiwara-security.md +6 -4
- package/.opencode/commands/mugiwara-ship.md +6 -4
- package/.opencode/commands/mugiwara.md +4 -2
- package/.opencode/commands/using-mugiwara.md +7 -13
- package/.opencode/plugins/mugiwara.mjs +18 -6
- package/AGENTS.md +1 -1
- package/GEMINI.md +1 -1
- package/README.md +251 -120
- package/content/agents/brook-healing.md +17 -3
- package/content/agents/chopper-checkpoint.md +17 -3
- package/content/agents/eval-runner.md +17 -2
- package/content/agents/franky-gates.md +19 -5
- package/content/agents/jinbe-security.md +19 -3
- package/content/agents/luffy-orchestrator.md +6 -3
- package/content/agents/memory-keeper.md +15 -0
- package/content/agents/nami-planner.md +21 -6
- package/content/agents/onboarding-guide.md +145 -0
- package/content/agents/resume-coordinator.md +21 -5
- package/content/agents/robin-reviewer.md +18 -3
- package/content/agents/sanji-quality.md +19 -4
- package/content/agents/skeptic-verifier.md +18 -3
- package/content/agents/usopp-brainstorm.md +17 -3
- package/content/agents/zoro-execution.md +18 -3
- package/content/skills/mugiwara-backend/SKILL.md +1 -1
- package/content/skills/mugiwara-brainstorm/SKILL.md +5 -1
- package/content/skills/mugiwara-checkpoint/SKILL.md +2 -2
- package/content/skills/mugiwara-contract-first/SKILL.md +2 -36
- package/content/skills/mugiwara-contract-first/references/process.md +37 -0
- package/content/skills/mugiwara-execution/SKILL.md +30 -13
- package/content/skills/mugiwara-execution/references/resume-batching.md +32 -0
- package/content/skills/mugiwara-frontend/SKILL.md +1 -1
- package/content/skills/mugiwara-gates/SKILL.md +32 -30
- package/content/skills/mugiwara-healing/SKILL.md +1 -1
- package/content/skills/mugiwara-orchestration/SKILL.md +41 -25
- package/content/skills/mugiwara-orchestration/references/delegation-pillars.md +40 -0
- package/content/skills/mugiwara-orchestration/references/triage-escalation.md +96 -0
- package/content/skills/mugiwara-planning/SKILL.md +23 -27
- package/content/skills/mugiwara-planning/references/plan-template.md +42 -0
- package/content/skills/mugiwara-pr/SKILL.md +2 -2
- package/content/skills/mugiwara-quality/SKILL.md +10 -6
- package/content/skills/mugiwara-resume/SKILL.md +7 -2
- package/content/skills/mugiwara-review/SKILL.md +20 -1
- package/content/skills/mugiwara-review/references/code-attributes.md +38 -0
- package/content/skills/mugiwara-root-cause/SKILL.md +3 -30
- package/content/skills/mugiwara-root-cause/references/process.md +35 -0
- package/content/skills/mugiwara-security/SKILL.md +17 -32
- package/content/skills/mugiwara-security/references/owasp-top10.md +12 -0
- package/content/skills/mugiwara-security/references/rationalizations.md +8 -0
- package/content/skills/mugiwara-ship/SKILL.md +5 -4
- package/content/skills/mugiwara-workflow/SKILL.md +74 -77
- package/content/skills/mugiwara-workflow/references/workspace-layout.md +50 -0
- package/content/skills/using-mugiwara/SKILL.md +8 -19
- package/dist/mugiwara.js +107 -41
- package/gemini-extension.json +1 -1
- package/hooks/session-start.ts +1 -1
- package/package.json +11 -4
- package/plugin.json +1 -1
- package/references/multi-actor.md +1 -1
- package/scripts/evidence.sh +12 -5
- package/scripts/gate-selftest.ts +266 -0
- package/scripts/initiative.ts +248 -0
- package/scripts/lane.sh +15 -0
- package/scripts/mission-report.sh +90 -12
- package/scripts/onboard.ts +292 -0
- package/scripts/release-notes.ts +42 -13
- package/scripts/savepoint.sh +97 -50
- package/scripts/validate-content.ts +77 -0
- package/scripts/verify-install.ts +72 -0
- package/src/installer.ts +34 -7
- package/src/mission.ts +7 -5
- package/src/targets/claude.ts +20 -3
- package/src/targets/generic.ts +1 -1
- package/src/targets/opencode.ts +31 -10
- package/docs/concepts/agents.md +0 -53
- package/docs/concepts/audit-trail.md +0 -65
- package/docs/concepts/comparison.md +0 -58
- package/docs/concepts/config.md +0 -55
- package/docs/concepts/cost.md +0 -45
- package/docs/concepts/execution-model.md +0 -92
- package/docs/concepts/git-strategy.md +0 -62
- package/docs/concepts/lanes.md +0 -82
- package/docs/concepts/modes.md +0 -73
- package/docs/concepts/pr-summary.md +0 -54
- package/docs/concepts/skills.md +0 -55
- package/docs/concepts/workflow.md +0 -89
- package/docs/getting-started.md +0 -158
- package/docs/index.md +0 -56
- package/docs/install/antigravity.md +0 -45
- package/docs/install/claude.md +0 -77
- package/docs/install/cli.md +0 -115
- package/docs/install/codex.md +0 -44
- package/docs/install/copilot.md +0 -45
- package/docs/install/cursor.md +0 -45
- package/docs/install/gemini.md +0 -44
- package/docs/install/index.md +0 -53
- package/docs/install/kimi.md +0 -45
- package/docs/install/opencode.md +0 -143
- package/docs/install/pi.md +0 -46
- package/docs/reference/adoption-guide.md +0 -72
- package/docs/reference/agent-anatomy.md +0 -72
- package/docs/reference/compliance-matrix.md +0 -81
- package/docs/reference/developer-onboarding.md +0 -89
- package/docs/reference/enforcement.md +0 -35
- package/docs/reference/harness-matrix.md +0 -41
- package/docs/reference/skill-anatomy.md +0 -71
- package/docs/troubleshooting.md +0 -91
- package/evals/cases/_no-skill.json +0 -16
- package/evals/cases/adversarial-pressure-fake-pass.json +0 -25
- package/evals/cases/adversarial-pressure-skip-review.json +0 -25
- package/evals/cases/lane-exploratory-vague.json +0 -24
- package/evals/cases/lane-sensitivity-payment.json +0 -24
- package/evals/cases/positive-refactor-existing-tests.json +0 -25
- package/evals/cases/positive-resume-mid-mission.json +0 -24
- package/evals/cases/routing-agent-security.json +0 -25
- package/evals/cases/routing-auth-feature.json +0 -26
- package/evals/cases/routing-backend.json +0 -25
- package/evals/cases/routing-bug-one-file.json +0 -26
- package/evals/cases/routing-claim-audit.json +0 -25
- package/evals/cases/routing-context-budget.json +0 -25
- package/evals/cases/routing-contract-first.json +0 -25
- package/evals/cases/routing-execution.json +0 -25
- package/evals/cases/routing-frontend.json +0 -26
- package/evals/cases/routing-gates.json +0 -25
- package/evals/cases/routing-git.json +0 -25
- package/evals/cases/routing-healing.json +0 -25
- package/evals/cases/routing-lessons.json +0 -25
- package/evals/cases/routing-orchestration.json +0 -25
- package/evals/cases/routing-planning.json +0 -26
- package/evals/cases/routing-pr.json +0 -25
- package/evals/cases/routing-quality.json +0 -25
- package/evals/cases/routing-ship.json +0 -26
- package/evals/cases/routing-sunset.json +0 -25
- package/evals/cases/routing-using-mugiwara.json +0 -25
- package/evals/cases/routing-workflow.json +0 -25
- package/evals/floor.json +0 -6
package/docs/concepts/skills.md
DELETED
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
# The Techniques — 26 Skills
|
|
2
|
-
|
|
3
|
-
Each skill is a portable markdown playbook — the "how to" the crew follows when
|
|
4
|
-
it embodies a role.
|
|
5
|
-
|
|
6
|
-
## Core pipeline
|
|
7
|
-
|
|
8
|
-
| Skill | Teaches |
|
|
9
|
-
|-------|---------|
|
|
10
|
-
| `mugiwara-workflow` | Harness entry: inline execution, gateway triage, wave pipeline, workspace, blocker protocol, cleanup |
|
|
11
|
-
| `mugiwara-orchestration` | Captain: 5-way classifier, check-ins, work splitting, decision log, closure |
|
|
12
|
-
| `mugiwara-brainstorm` | Critical sparring: interrogate, research facts, cut over-engineering, recommend |
|
|
13
|
-
| `mugiwara-planning` | Interview-first, full-context scan, wave plans with parallel/sequential markers |
|
|
14
|
-
| `mugiwara-execution` | Todo list, sequential inline + parallel worker batches, 6-field delegation, one commit per task |
|
|
15
|
-
| `mugiwara-checkpoint` | Verify-everything audit — deduped re-runs scoped to wave diff; failure rows to blocker ledger |
|
|
16
|
-
| `mugiwara-quality` | Discover project tooling; formatter, linter, unit tests under consent matrix |
|
|
17
|
-
| `mugiwara-gates` | Coverage ≥90% new / ≥80% modified, build, Definition of Done |
|
|
18
|
-
| `mugiwara-review` | Doubt-driven review: breaking-change map, five-axis, severity-tagged findings |
|
|
19
|
-
| `mugiwara-security` | STRIDE-first security review, OWASP Top 10, authn/authz, secrets, untrusted-data |
|
|
20
|
-
| `mugiwara-healing` | Reads the ledger, Stop-the-Line + Prove-It root-cause fixes, rollback prep |
|
|
21
|
-
|
|
22
|
-
## Mission control
|
|
23
|
-
|
|
24
|
-
| Skill | Teaches |
|
|
25
|
-
|-------|---------|
|
|
26
|
-
| `mugiwara-git` | Atomic commits, save-points, multi-commit splitting, bisect/blame debugging |
|
|
27
|
-
| `mugiwara-testcases` | User-test intake: immutable-gold rule, declarative-AC routing, consent, failure adjudication |
|
|
28
|
-
| `mugiwara-pr` | Terminal: push + verdict file with ready PR summary; never creates a PR |
|
|
29
|
-
| `mugiwara-ship` | GO/NO-GO ship gate: pre-launch checklist, feature flags, rollback plan |
|
|
30
|
-
| `mugiwara-sunset` | Sunset & migration: keep-or-retire gate, cutover playbooks, safe schema changes |
|
|
31
|
-
| `mugiwara-resume` | Session resume: rebuild state from `.mugiwara/state.json`; never restart |
|
|
32
|
-
| `mugiwara-lessons` | Cross-mission memory: actionable lessons ledger, read at triage, written at closure |
|
|
33
|
-
|
|
34
|
-
## Engineering practice
|
|
35
|
-
|
|
36
|
-
| Skill | Teaches |
|
|
37
|
-
|-------|---------|
|
|
38
|
-
| `using-mugiwara` | Front-door router — explains the crew, classifies missions, routes to specialist |
|
|
39
|
-
| `mugiwara-root-cause` | 4-phase: reproduce → localize → reduce → fix + guard; stop-the-line |
|
|
40
|
-
| `mugiwara-contract-first` | Contract-first design, error semantics, boundary validation, backward compatibility |
|
|
41
|
-
| `mugiwara-claim-audit` | Adversarial verification: CLAIM → EXTRACT → DOUBT → RECONCILE → STOP |
|
|
42
|
-
| `mugiwara-context-budget` | Token/context management: feed selectively, trust-sort sources, the window is a budget |
|
|
43
|
-
|
|
44
|
-
## Domain
|
|
45
|
-
|
|
46
|
-
| Skill | Teaches |
|
|
47
|
-
|-------|---------|
|
|
48
|
-
| `mugiwara-frontend` | Anti-slop frontend: audit-first redesigns, design-system extraction, WCAG 2.1 AA |
|
|
49
|
-
| `mugiwara-backend` | Backend/server code: repo standards first, source-backed code, data integrity |
|
|
50
|
-
| `mugiwara-agent-security` | Agent layer: prompt injection, memory poisoning, excessive agency, MCP trust, sandboxing |
|
|
51
|
-
|
|
52
|
-
## Anatomy
|
|
53
|
-
|
|
54
|
-
Every skill is a `SKILL.md` with frontmatter + playbook body. See
|
|
55
|
-
[skill-anatomy.md](../reference/skill-anatomy.md).
|
|
@@ -1,89 +0,0 @@
|
|
|
1
|
-
# The Wave Pipeline
|
|
2
|
-
|
|
3
|
-
A mission runs as ten waves (plus one optional adversarial pass). Each wave is
|
|
4
|
-
owned by one crew member and runs **inline** in the main conversation.
|
|
5
|
-
|
|
6
|
-
| Wave | Owner | Skill | Output |
|
|
7
|
-
|------|-------|-------|--------|
|
|
8
|
-
| 0 Triage | Luffy | `mugiwara-orchestration` | 5-way route decision + reason |
|
|
9
|
-
| 1 Brainstorm | Usopp | `mugiwara-brainstorm` | refined direction, options, recommendation |
|
|
10
|
-
| 2 Planning | Nami | `mugiwara-planning` | plan doc: waves, tasks, acceptance criteria |
|
|
11
|
-
| 3 Execution | Zoro | `mugiwara-execution` | implemented tasks with evidence |
|
|
12
|
-
| 4 Checkpoint | Chopper | `mugiwara-checkpoint` | audit report + failure ledger |
|
|
13
|
-
| 4.5 Adversarial | Skeptic | `mugiwara-dynamic-workflow` | findings report (optional) |
|
|
14
|
-
| 5 Quality | Sanji | `mugiwara-quality` | formatter/linter/test results |
|
|
15
|
-
| 6 Gates | Franky | `mugiwara-gates` | coverage + build verdict |
|
|
16
|
-
| 7 Review | Robin ∥ Jinbe | `mugiwara-review` + `mugiwara-security` | severity-tagged findings |
|
|
17
|
-
| 8 Healing | Brook | `mugiwara-healing` | fixes; loops back to Wave 4, max 3 cycles |
|
|
18
|
-
| 9 Closure | Luffy | `mugiwara-orchestration` | closure report + push + PR verdict handed to you |
|
|
19
|
-
|
|
20
|
-
## Wave 0 — Triage
|
|
21
|
-
|
|
22
|
-
Every mission starts at the Luffy gateway, which classifies the request 5 ways
|
|
23
|
-
and sizes it to a **lane**:
|
|
24
|
-
|
|
25
|
-
| Class | Signal | Route |
|
|
26
|
-
|-------|--------|-------|
|
|
27
|
-
| Trivial | one obvious small change, no ambiguity | Lane 0/1 — Wave 2 directly |
|
|
28
|
-
| Explicit | clear requirements, written spec exists | Wave 2 directly |
|
|
29
|
-
| Exploratory | needs direction, options, research | Wave 1 first |
|
|
30
|
-
| Open-ended | broad goal, undefined scope | Wave 1 first |
|
|
31
|
-
| Ambiguous | requirements, APIs, scope unclear | Wave 1 first |
|
|
32
|
-
|
|
33
|
-
A clear-work route straight to Wave 2 still writes a short **spec bridge** to
|
|
34
|
-
`.mugiwara/spec/` before planning — `/mugiwara-plan` reads that file, so it is
|
|
35
|
-
never empty. The decision + reason is logged in `.mugiwara/logs/`. Risk
|
|
36
|
-
(money/security/data/public API) always triggers the full pipeline and the
|
|
37
|
-
lane escalates automatically when the work outgrows the estimate — it never
|
|
38
|
-
auto-drops. See [lanes.md](lanes.md).
|
|
39
|
-
|
|
40
|
-
## Wave 4 — Checkpoint (Chopper)
|
|
41
|
-
|
|
42
|
-
The verify-everything gate. After execution, Chopper re-runs every acceptance
|
|
43
|
-
criterion — but efficiently:
|
|
44
|
-
|
|
45
|
-
- **Deduped**: each unique check command runs once per wave, scoped to the
|
|
46
|
-
files this wave changed. No running `npm test` once per task.
|
|
47
|
-
- **Scoped by diff**: `git diff --name-only <wave-base>..HEAD` decides what
|
|
48
|
-
actually needs re-verification.
|
|
49
|
-
- **Commit hygiene**: one `git log --stat` pass, not per-commit.
|
|
50
|
-
- Failures land in the blocker ledger `.mugiwara/issues/` with honest
|
|
51
|
-
code-vs-env classification.
|
|
52
|
-
|
|
53
|
-
## Wave 7 — Review
|
|
54
|
-
|
|
55
|
-
Robin (doubt-driven review) and Jinbe (security) run in parallel. Robin maps
|
|
56
|
-
breaking changes to callers before reading the diff; Jinbe runs STRIDE + OWASP.
|
|
57
|
-
Findings are severity-tagged with path:line.
|
|
58
|
-
|
|
59
|
-
## Wave 8 — Healing
|
|
60
|
-
|
|
61
|
-
Brook reads the blocker ledger and fixes root causes, proving each fix by
|
|
62
|
-
re-running the failed check. The loop returns to Wave 4 — max 3 cycles, then
|
|
63
|
-
escalation to you.
|
|
64
|
-
|
|
65
|
-
## Wave 9 — Closure
|
|
66
|
-
|
|
67
|
-
Luffy runs the ship gate, writes the closure report, deletes superseded
|
|
68
|
-
intermediate files, then the terminal step in every mode: **save-point commit →
|
|
69
|
-
push the mission branch → write the PR verdict file → hand branch + verdict to
|
|
70
|
-
you**, who opens the PR. The crew never creates a PR, merges, or deploys.
|
|
71
|
-
|
|
72
|
-
## The two rules that hold it together
|
|
73
|
-
|
|
74
|
-
1. **Evidence over claims.** No wave passes on assertion — the owning agent
|
|
75
|
-
runs the checks and shows output. "Subagents lie. No evidence = not
|
|
76
|
-
complete." A skipped wave is recorded in the decision log, never silent.
|
|
77
|
-
2. **The plan is the source of truth.** From Wave 2 on, the plan doc in
|
|
78
|
-
`.mugiwara/plans/` holds the clean execution plan; the decision log holds the
|
|
79
|
-
who-and-why trace.
|
|
80
|
-
|
|
81
|
-
**Every skill has a skip gate.** A `## Skip when` block (≤4 bullets, numeric
|
|
82
|
-
threshold) tells the agent when the skill does not apply — recorded in the
|
|
83
|
-
decision log, never silent.
|
|
84
|
-
|
|
85
|
-
## Blocker protocol
|
|
86
|
-
|
|
87
|
-
Any agent that hits a blocker appends a row
|
|
88
|
-
(`wave | task | symptom | attempted | help-needed`) to the ledger and escalates.
|
|
89
|
-
Never a silent workaround. Brook heals what the ledger lists.
|
package/docs/getting-started.md
DELETED
|
@@ -1,158 +0,0 @@
|
|
|
1
|
-
# Getting Started
|
|
2
|
-
|
|
3
|
-
Install the crew, run your first mission, and understand what you're looking at
|
|
4
|
-
in the chat.
|
|
5
|
-
|
|
6
|
-
## 1. Install
|
|
7
|
-
|
|
8
|
-
Pick your harness — every major one is supported. The two easiest:
|
|
9
|
-
|
|
10
|
-
**opencode** — add the plugin to `opencode.json`:
|
|
11
|
-
|
|
12
|
-
```json
|
|
13
|
-
{ "plugin": ["@ionivetech/mugiwara"] }
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
**Claude Code** — via the marketplace:
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
/plugin marketplace add ionivetech/mugiwara
|
|
20
|
-
/plugin install mugiwara
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
| Harness | Install command |
|
|
24
|
-
|---------|----------------|
|
|
25
|
-
| Claude Code | `/plugin marketplace add ionivetech/mugiwara` then `/plugin install mugiwara` |
|
|
26
|
-
| opencode | `{ "plugin": ["@ionivetech/mugiwara"] }` in `opencode.json` |
|
|
27
|
-
| GitHub Copilot | `copilot plugin marketplace add ionivetech/mugiwara` then `copilot plugin install mugiwara` |
|
|
28
|
-
| Gemini CLI | `gemini extensions install https://github.com/ionivetech/mugiwara` |
|
|
29
|
-
| Codex | `codex plugin marketplace add ionivetech/mugiwara` then `codex plugin add mugiwara@mugiwara` |
|
|
30
|
-
| Cursor | `/add-plugin mugiwara` |
|
|
31
|
-
| Kimi Code | `/plugins install https://github.com/ionivetech/mugiwara` |
|
|
32
|
-
| pi | `pi install git:github.com/ionivetech/mugiwara` |
|
|
33
|
-
| Windsurf, Cline, Kilo, Antigravity | `npx @ionivetech/mugiwara@latest --project . --target <id> --yes` |
|
|
34
|
-
|
|
35
|
-
Or the CLI for any target:
|
|
36
|
-
|
|
37
|
-
```bash
|
|
38
|
-
npx @ionivetech/mugiwara@latest --project ./my-app --target all --yes
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
Requires **Node.js >= 20.11**. Bun is optional (build-from-source only).
|
|
42
|
-
|
|
43
|
-
## 2. Start a mission
|
|
44
|
-
|
|
45
|
-
The workflow **auto-activates** at session start. The crew announces itself,
|
|
46
|
-
then give any non-trivial request.
|
|
47
|
-
|
|
48
|
-
### Small: lane 0–1
|
|
49
|
-
|
|
50
|
-
```
|
|
51
|
-
> fix the date formatting bug in src/utils/format.ts
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
Luffy routes it to **Lane 1** (Lean). Zoro reproduces and fixes, Sanji runs
|
|
55
|
-
format + lint + tests. Two waves, visible as compact checkpoint reports. No
|
|
56
|
-
nine-wave ceremony for a one-file bug.
|
|
57
|
-
|
|
58
|
-
That's lane sizing: the process scales to the work. A typo (Lane 0) runs zero
|
|
59
|
-
waves — the fix happens directly.
|
|
60
|
-
|
|
61
|
-
### Medium: lane 2
|
|
62
|
-
|
|
63
|
-
```
|
|
64
|
-
> add a search bar to the products page
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
Touches frontend + API. Luffy routes to **Lane 2** (Standard). Nami plans 1
|
|
68
|
-
wave with 3-5 tasks, Zoro executes test-first, Chopper audits every criterion,
|
|
69
|
-
Sanji and Franky gate, Robin and Jinbe review.
|
|
70
|
-
|
|
71
|
-
### Large: lane 3
|
|
72
|
-
|
|
73
|
-
```
|
|
74
|
-
> add role-based access control to the API
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
Touches auth — Luffy routes to **Lane 3** (Full). All 9 waves run. Nami plans
|
|
78
|
-
the migration, Zoro executes, Chopper audits, Sanji tests, Franky gates, Robin
|
|
79
|
-
reviews the diff with a breaking-change map, Jinbe runs STRIDE + OWASP, Brook
|
|
80
|
-
heals any failures (max 3 cycles), Luffy closes with a mission report + push +
|
|
81
|
-
ready PR summary.
|
|
82
|
-
|
|
83
|
-
```
|
|
84
|
-
Wave 0 Luffy triage → route: full pipe (auth/ touched)
|
|
85
|
-
Wave 2 Nami plan → .mugiwara/plans/2026-08-10-rbac.md (2 waves, 5 tasks)
|
|
86
|
-
Wave 3 Zoro execute→ 5 tasks, evidence per task
|
|
87
|
-
Wave 4 Chopper audit → PASS: all criteria met, commit hygiene clean
|
|
88
|
-
Wave 5 Sanji quality → PASS: lint 0, 312 tests green
|
|
89
|
-
Wave 6 Franky gates → PASS: new 94%, modified 87%, build green
|
|
90
|
-
Wave 7 Robin review → 2 minor findings (batched)
|
|
91
|
-
Wave 7 Jinbe security→ PASS: STRIDE clean, 0 high
|
|
92
|
-
Wave 9 Luffy closure→ mission report + push + ready PR summary
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
The crew runs **inline** in your main conversation — every wave reports as a
|
|
96
|
-
compact checkpoint. Subagents only for parallel task batches.
|
|
97
|
-
|
|
98
|
-
Prefer to drive stages yourself? Every stage has a slash command:
|
|
99
|
-
`/mugiwara-plan`, `/mugiwara-execute`, `/mugiwara-review`,
|
|
100
|
-
`/mugiwara-security`, `/mugiwara-heal`, `/mugiwara-ship`. Jump into any stage.
|
|
101
|
-
|
|
102
|
-
## 3. What you do during a mission
|
|
103
|
-
|
|
104
|
-
Almost nothing in `guided` mode:
|
|
105
|
-
|
|
106
|
-
- Answer Nami's clarifying questions (one batched round before planning).
|
|
107
|
-
- Give the plan an explicit GO when presented.
|
|
108
|
-
- Review Brook's rollback note if a risky fix is proposed.
|
|
109
|
-
- In every mode, **open the PR at the end** — the crew pushes the branch and
|
|
110
|
-
hands you a verdict file with a ready PR summary. The crew never creates a
|
|
111
|
-
PR, merges, or deploys.
|
|
112
|
-
|
|
113
|
-
Switch to `semi` or `auto` if you want the crew to self-manage branch, commits,
|
|
114
|
-
and ambiguities. See [modes](concepts/modes.md).
|
|
115
|
-
|
|
116
|
-
## 4. The `.mugiwara/` workspace
|
|
117
|
-
|
|
118
|
-
Every mission writes to `.mugiwara/` at the repo root:
|
|
119
|
-
|
|
120
|
-
```
|
|
121
|
-
.mugiwara/
|
|
122
|
-
├── config # mode, branch, commit, base, coverage thresholds
|
|
123
|
-
├── state.json # computed at every wave boundary by scripts/savepoint.sh
|
|
124
|
-
├── spec/ # brainstorm output
|
|
125
|
-
├── plans/ # clean execution plan (source of truth from Wave 2)
|
|
126
|
-
├── results/ # audit, quality, gate, closure reports + evidence logs
|
|
127
|
-
├── reports/ # human-readable mission reports
|
|
128
|
-
├── review/ # review + security findings
|
|
129
|
-
├── issues/ # blocker ledger
|
|
130
|
-
├── refs/ # full skill/agent bodies for glob-loading harnesses
|
|
131
|
-
└── logs/ # decision log + cross-mission lessons
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
**Savepoint** runs at every wave boundary — `state.json` carries lane, wave,
|
|
135
|
-
files, blockers, heal cycle, and token budget. Resume reads one file instead of
|
|
136
|
-
six. See [audit-trail.md](concepts/audit-trail.md) for the full artifact map.
|
|
137
|
-
|
|
138
|
-
## 5. Configuration
|
|
139
|
-
|
|
140
|
-
`.mugiwara/config` (project) overrides `~/.mugiwara/config` (global):
|
|
141
|
-
|
|
142
|
-
| Key | Default | What it controls |
|
|
143
|
-
|-----|---------|-----------------|
|
|
144
|
-
| `mode` | guided | Autonomy: guided/semi/auto |
|
|
145
|
-
| `branch` | `feature/{type}-{issue}-{slug}` | Branch naming pattern |
|
|
146
|
-
| `commit` | conventional | Commit style: conventional/gitmoji/plain |
|
|
147
|
-
| `base` | main | PR target branch |
|
|
148
|
-
| `coverage_new` | 90 | Coverage % for new files |
|
|
149
|
-
| `coverage_modified` | 80 | Coverage % for modified files |
|
|
150
|
-
|
|
151
|
-
## 6. Next steps
|
|
152
|
-
|
|
153
|
-
- Meet the [crew](concepts/agents.md) — 14 agents with permission boundaries.
|
|
154
|
-
- Browse the [skills](concepts/skills.md) — 26 skills with the 3-layer disclosure model.
|
|
155
|
-
- Understand the [lanes](concepts/lanes.md) — how work is sized before it runs.
|
|
156
|
-
- Set your [mode](concepts/modes.md) — guided/semi/auto.
|
|
157
|
-
- Read the [audit trail](concepts/audit-trail.md) — every artifact and how to review it.
|
|
158
|
-
- See the [compliance matrix](reference/compliance-matrix.md) — rule compliance per model.
|
package/docs/index.md
DELETED
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
# Mugiwara Docs
|
|
2
|
-
|
|
3
|
-
The Straw Hat crew of AI agents and skills. These docs cover what the crew is,
|
|
4
|
-
how to adopt it, and how each harness installs it. The crew is markdown plus a
|
|
5
|
-
small Node CLI (`mugiwara`) — no daemons, nothing to host. It ships **15
|
|
6
|
-
agents** and **32 skills**, and the workflow **auto-activates** at session
|
|
7
|
-
start — a non-trivial request runs the pipeline by itself, with
|
|
8
|
-
`/using-mugiwara` as an optional explicit router. Work is **sized to a lane**
|
|
9
|
-
before it runs: small fixes skip the pipeline, sensitive changes run the full
|
|
10
|
-
nine waves, and every wave passes only on **evidence**, never on a spoken
|
|
11
|
-
claim.
|
|
12
|
-
|
|
13
|
-
## Start here
|
|
14
|
-
|
|
15
|
-
| Doc | What it covers |
|
|
16
|
-
|-----|----------------|
|
|
17
|
-
| [Getting started](getting-started.md) | Install, first mission, what you see in the chat |
|
|
18
|
-
| [Adoption guide](reference/adoption-guide.md) | Pick the harness, pick the mode, fit the crew to your workflow |
|
|
19
|
-
| [Modes](concepts/modes.md) | guided / semi / auto — the autonomy levels, what each asks you |
|
|
20
|
-
| [Config](concepts/config.md) | Full reference for `.mugiwara/config` keys and commit styles |
|
|
21
|
-
| [Auto-PR](concepts/pr-summary.md) | What the crew hands off at closure: push + a ready-to-paste PR summary (it never creates a PR) |
|
|
22
|
-
| [The crew](concepts/agents.md) | All 14 agents and when to summon each |
|
|
23
|
-
| [The techniques](concepts/skills.md) | All 32 skills and what each enforces |
|
|
24
|
-
| [The wave pipeline](concepts/workflow.md) | How a mission flows Wave 0 → Wave 9 |
|
|
25
|
-
| [Execution model](concepts/execution-model.md) | Inline-by-default: why the crew runs in your main conversation |
|
|
26
|
-
| [Lanes & sizing](concepts/lanes.md) | How Luffy sizes work at triage: Lane 0–4, escalation, budget |
|
|
27
|
-
| [Enforcement](reference/enforcement.md) | Skip gates, evidence over claims, and capability tiers |
|
|
28
|
-
| [Git discipline](concepts/git-strategy.md) | Commits, branches, save-points — and why the executor commits |
|
|
29
|
-
|
|
30
|
-
## Install by harness
|
|
31
|
-
|
|
32
|
-
| Harness | Guide |
|
|
33
|
-
|---------|-------|
|
|
34
|
-
| Claude Code | [install/claude.md](install/claude.md) |
|
|
35
|
-
| opencode | [install/opencode.md](install/opencode.md) |
|
|
36
|
-
| GitHub Copilot | [install/copilot.md](install/copilot.md) |
|
|
37
|
-
| Gemini CLI | [install/gemini.md](install/gemini.md) |
|
|
38
|
-
| Codex | [install/codex.md](install/codex.md) |
|
|
39
|
-
| Cursor | [install/cursor.md](install/cursor.md) |
|
|
40
|
-
| Windsurf | [install/cli.md](install/cli.md) |
|
|
41
|
-
| Cline / Kilo / Antigravity | [install/cli.md](install/cli.md) |
|
|
42
|
-
|
|
43
|
-
## Reference
|
|
44
|
-
|
|
45
|
-
| Doc | What it covers |
|
|
46
|
-
|-----|----------------|
|
|
47
|
-
| [Skill anatomy](reference/skill-anatomy.md) | How a mugiwara skill file is structured |
|
|
48
|
-
| [Agent anatomy](reference/agent-anatomy.md) | How a mugiwara agent file is structured |
|
|
49
|
-
| [Troubleshooting](troubleshooting.md) | Common problems and how to fix them |
|
|
50
|
-
| [Developer onboarding](reference/developer-onboarding.md) | Repo layout, validation, tests, contributing |
|
|
51
|
-
|
|
52
|
-
## Resources
|
|
53
|
-
|
|
54
|
-
- GitHub: <https://github.com/ionivetech/mugiwara>
|
|
55
|
-
- npm: <https://www.npmjs.com/package/@ionivetech/mugiwara>
|
|
56
|
-
- License: MIT
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
# Antigravity Install
|
|
2
|
-
|
|
3
|
-
Mugiwara installs as an Antigravity plugin from this repo.
|
|
4
|
-
|
|
5
|
-
## Prerequisites
|
|
6
|
-
|
|
7
|
-
- [Antigravity](https://antigravity.google) installed
|
|
8
|
-
|
|
9
|
-
## Install
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
agy plugin install https://github.com/ionivetech/mugiwara
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
## How it works
|
|
16
|
-
|
|
17
|
-
Antigravity reads `.agents/plugins/marketplace.json` and installs the plugin
|
|
18
|
-
from the repo root. Skills and agents are auto-discovered.
|
|
19
|
-
|
|
20
|
-
## Verify
|
|
21
|
-
|
|
22
|
-
Ask:
|
|
23
|
-
|
|
24
|
-
```
|
|
25
|
-
what mugiwara crew members are available?
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
## Update
|
|
29
|
-
|
|
30
|
-
Reinstall with the same command:
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
agy plugin install https://github.com/ionivetech/mugiwara
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## Uninstall
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
agy plugin uninstall mugiwara
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
## Configuration
|
|
43
|
-
|
|
44
|
-
After install, configure mugiwara in `.mugiwara/config` (project) or
|
|
45
|
-
`~/.mugiwara/config` (global). See [config.md](../concepts/config.md).
|
package/docs/install/claude.md
DELETED
|
@@ -1,77 +0,0 @@
|
|
|
1
|
-
# Claude Code Install
|
|
2
|
-
|
|
3
|
-
Mugiwara is a full Claude Code native plugin with agents, skills, and a
|
|
4
|
-
session-start hook.
|
|
5
|
-
|
|
6
|
-
## Prerequisites
|
|
7
|
-
|
|
8
|
-
- [Claude Code](https://claude.ai/code) installed
|
|
9
|
-
- Node.js >= 20.11
|
|
10
|
-
|
|
11
|
-
## Install
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
/plugin marketplace add ionivetech/mugiwara && /plugin install mugiwara
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
## How it works
|
|
18
|
-
|
|
19
|
-
Claude Code clones the repo and reads from:
|
|
20
|
-
|
|
21
|
-
- `skills/` and `agents/` — symlinks to `content/skills/` and
|
|
22
|
-
`content/agents/`. Claude Code auto-discovers all 26 skills and 14 agents.
|
|
23
|
-
- `hooks/hooks.json` — defines a SessionStart hook that runs
|
|
24
|
-
`hooks/session-start.ts`, injecting the crew announce header at every
|
|
25
|
-
session start.
|
|
26
|
-
|
|
27
|
-
The hook announces: "Mugiwara crew available. The workflow auto-activates
|
|
28
|
-
for non-trivial requests..."
|
|
29
|
-
|
|
30
|
-
## Verify
|
|
31
|
-
|
|
32
|
-
Ask:
|
|
33
|
-
|
|
34
|
-
```
|
|
35
|
-
what mugiwara crew members are available?
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
Or start any task — the crew auto-activates at session start.
|
|
39
|
-
|
|
40
|
-
## Update
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
/plugin update mugiwara
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
## Uninstall
|
|
47
|
-
|
|
48
|
-
```
|
|
49
|
-
/plugin uninstall mugiwara
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
## Configuration
|
|
53
|
-
|
|
54
|
-
After install, configure mugiwara in `.mugiwara/config` (project) or
|
|
55
|
-
`~/.mugiwara/config` (global). See [config.md](../concepts/config.md).
|
|
56
|
-
|
|
57
|
-
Switch autonomy mode with `/mugiwara-mode guided|semi|auto`.
|
|
58
|
-
|
|
59
|
-
Or set permanently in `.mugiwara/config`: `mode=guided`.
|
|
60
|
-
|
|
61
|
-
## Troubleshooting
|
|
62
|
-
|
|
63
|
-
### Plugin not showing up
|
|
64
|
-
|
|
65
|
-
1. Verify marketplace is registered: `/plugin marketplace list`
|
|
66
|
-
2. If not, re-run the marketplace add command
|
|
67
|
-
3. Check Claude Code is up to date
|
|
68
|
-
|
|
69
|
-
### Skills not found
|
|
70
|
-
|
|
71
|
-
1. Check that `skills/` and `agents/` symlinks resolve correctly
|
|
72
|
-
2. Reinstall: `/plugin uninstall mugiwara` then reinstall
|
|
73
|
-
|
|
74
|
-
### Hook not running
|
|
75
|
-
|
|
76
|
-
The session-start hook requires Claude Code plugin hook support. Ensure
|
|
77
|
-
you're on a recent Claude Code version.
|
package/docs/install/cli.md
DELETED
|
@@ -1,115 +0,0 @@
|
|
|
1
|
-
# CLI Install (Windsurf, Cline, Kilo)
|
|
2
|
-
|
|
3
|
-
These platforms don't have native plugin systems. Use the mugiwara CLI
|
|
4
|
-
installer to copy files into the platform's config directory.
|
|
5
|
-
|
|
6
|
-
## Prerequisites
|
|
7
|
-
|
|
8
|
-
- Node.js >= 20.11
|
|
9
|
-
|
|
10
|
-
## Install
|
|
11
|
-
|
|
12
|
-
```bash
|
|
13
|
-
npx @ionivetech/mugiwara@latest install --target <id> --yes
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
Replace `<id>` with one of: `windsurf`, `cline`, `kilo`.
|
|
17
|
-
|
|
18
|
-
Or install globally first:
|
|
19
|
-
|
|
20
|
-
```bash
|
|
21
|
-
npm i -g @ionivetech/mugiwara
|
|
22
|
-
mugiwara install --target <id> --yes
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
### What gets written
|
|
26
|
-
|
|
27
|
-
| Target | Skills/agents | References | Bootstrap |
|
|
28
|
-
|--------|---------------|------------|-----------|
|
|
29
|
-
| Windsurf | `.devin/rules/*.md` (stubs) | `.mugiwara/refs/*.md` | — |
|
|
30
|
-
| Cline | `.clinerules/*.md` (stubs) | `.mugiwara/refs/*.md` | — |
|
|
31
|
-
| Kilo | `.kilo/rules/*.md` (stubs) | `.mugiwara/refs/*.md` | `kilo.jsonc` |
|
|
32
|
-
|
|
33
|
-
Tier 3 targets use stubs (pointer + routing) to keep rule files small.
|
|
34
|
-
Full skill bodies live in `.mugiwara/refs/` — the agent loads them on demand.
|
|
35
|
-
|
|
36
|
-
### Interactive mode
|
|
37
|
-
|
|
38
|
-
Drop `--yes` for the interactive wizard:
|
|
39
|
-
|
|
40
|
-
```bash
|
|
41
|
-
npx @ionivetech/mugiwara install
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
Pick scope (global/project), target(s), and confirm before writing.
|
|
45
|
-
|
|
46
|
-
### Multiple targets
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
npx @ionivetech/mugiwara install --target windsurf,cline,kilo --yes
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
Or all available targets:
|
|
53
|
-
|
|
54
|
-
```bash
|
|
55
|
-
npx @ionivetech/mugiwara install --target all --yes
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
## Verify
|
|
59
|
-
|
|
60
|
-
Ask your agent:
|
|
61
|
-
|
|
62
|
-
```
|
|
63
|
-
what mugiwara crew members are available?
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
## Update
|
|
67
|
-
|
|
68
|
-
```bash
|
|
69
|
-
npx @ionivetech/mugiwara@latest update --project . --target <id> --yes
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
Or with global CLI:
|
|
73
|
-
|
|
74
|
-
```bash
|
|
75
|
-
mugiwara update --project . --target <id> --yes
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
## Uninstall
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
npx @ionivetech/mugiwara@latest uninstall --project .
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
Or with global CLI:
|
|
85
|
-
|
|
86
|
-
```bash
|
|
87
|
-
mugiwara uninstall --project .
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
## Global install
|
|
91
|
-
|
|
92
|
-
```bash
|
|
93
|
-
mugiwara install --global --target <id> --yes
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
Installs to `~/.devin/rules/` (Windsurf), `~/.clinerules/` (Cline), or
|
|
97
|
-
`~/.kilo/rules/` (Kilo).
|
|
98
|
-
|
|
99
|
-
## Configuration
|
|
100
|
-
|
|
101
|
-
After install, configure mugiwara in `.mugiwara/config` (project) or
|
|
102
|
-
`~/.mugiwara/config` (global). See [config.md](../concepts/config.md).
|
|
103
|
-
|
|
104
|
-
## CLI reference
|
|
105
|
-
|
|
106
|
-
```bash
|
|
107
|
-
mugiwara install # wizard (interactive)
|
|
108
|
-
npx @ionivetech/mugiwara@latest install --yes # non-interactive (project + all)
|
|
109
|
-
mugiwara update --project . --target <id> --yes # replace existing files
|
|
110
|
-
mugiwara uninstall --project . # remove what manifest recorded
|
|
111
|
-
mugiwara list # show installations
|
|
112
|
-
mugiwara list --check # health check (missing files)
|
|
113
|
-
mugiwara reset --keep-logs # wipe mission state, keep lessons
|
|
114
|
-
mugiwara reset --force # override multi-actor guard
|
|
115
|
-
```
|
package/docs/install/codex.md
DELETED
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
# Codex Install
|
|
2
|
-
|
|
3
|
-
Mugiwara installs as a native Codex plugin.
|
|
4
|
-
|
|
5
|
-
## Prerequisites
|
|
6
|
-
|
|
7
|
-
- [Codex](https://github.com/openai/codex) CLI or app installed
|
|
8
|
-
|
|
9
|
-
## Install
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
codex plugin marketplace add ionivetech/mugiwara && codex plugin add mugiwara@mugiwara
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
## How it works
|
|
16
|
-
|
|
17
|
-
Codex reads `.codex-plugin/plugin.json` which references `content/skills/`.
|
|
18
|
-
All 26 skills are auto-discovered. Agents come from `content/agents/` via the
|
|
19
|
-
`agents/` symlink.
|
|
20
|
-
|
|
21
|
-
## Verify
|
|
22
|
-
|
|
23
|
-
Ask:
|
|
24
|
-
|
|
25
|
-
```
|
|
26
|
-
what mugiwara crew members are available?
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
## Update
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
codex plugin update mugiwara
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
## Uninstall
|
|
36
|
-
|
|
37
|
-
```bash
|
|
38
|
-
codex plugin remove mugiwara
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
## Configuration
|
|
42
|
-
|
|
43
|
-
After install, configure mugiwara in `.mugiwara/config` (project) or
|
|
44
|
-
`~/.mugiwara/config` (global). See [config.md](../concepts/config.md).
|
package/docs/install/copilot.md
DELETED
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
# GitHub Copilot Install
|
|
2
|
-
|
|
3
|
-
Mugiwara installs as a Copilot plugin directly from the GitHub repo.
|
|
4
|
-
|
|
5
|
-
## Prerequisites
|
|
6
|
-
|
|
7
|
-
- [GitHub Copilot](https://docs.github.com/en/copilot) extension installed
|
|
8
|
-
|
|
9
|
-
## Install
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
copilot plugin install https://github.com/ionivetech/mugiwara
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
## How it works
|
|
16
|
-
|
|
17
|
-
Copilot clones the repo and auto-discovers skills from `content/skills/`
|
|
18
|
-
and agents from `content/agents/`.
|
|
19
|
-
|
|
20
|
-
## Verify
|
|
21
|
-
|
|
22
|
-
Ask:
|
|
23
|
-
|
|
24
|
-
```
|
|
25
|
-
what mugiwara crew members are available?
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
## Update
|
|
29
|
-
|
|
30
|
-
Reinstall with the same command:
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
copilot plugin install https://github.com/ionivetech/mugiwara
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## Uninstall
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
copilot plugin uninstall mugiwara
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
## Configuration
|
|
43
|
-
|
|
44
|
-
After install, configure mugiwara in `.mugiwara/config` (project) or
|
|
45
|
-
`~/.mugiwara/config` (global). See [config.md](../concepts/config.md).
|