@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.
Files changed (145) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +3 -2
  3. package/.codex-plugin/plugin.json +1 -1
  4. package/.cursor-plugin/plugin.json +1 -1
  5. package/.kimi-plugin/plugin.json +1 -1
  6. package/.opencode/commands/mugiwara-continue.md +16 -0
  7. package/.opencode/commands/mugiwara-execute.md +6 -4
  8. package/.opencode/commands/mugiwara-heal.md +6 -4
  9. package/.opencode/commands/mugiwara-plan.md +6 -4
  10. package/.opencode/commands/mugiwara-review.md +6 -4
  11. package/.opencode/commands/mugiwara-security.md +6 -4
  12. package/.opencode/commands/mugiwara-ship.md +6 -4
  13. package/.opencode/commands/mugiwara.md +4 -2
  14. package/.opencode/commands/using-mugiwara.md +7 -13
  15. package/.opencode/plugins/mugiwara.mjs +18 -6
  16. package/AGENTS.md +1 -1
  17. package/GEMINI.md +1 -1
  18. package/README.md +251 -120
  19. package/content/agents/brook-healing.md +17 -3
  20. package/content/agents/chopper-checkpoint.md +17 -3
  21. package/content/agents/eval-runner.md +17 -2
  22. package/content/agents/franky-gates.md +19 -5
  23. package/content/agents/jinbe-security.md +19 -3
  24. package/content/agents/luffy-orchestrator.md +6 -3
  25. package/content/agents/memory-keeper.md +15 -0
  26. package/content/agents/nami-planner.md +21 -6
  27. package/content/agents/onboarding-guide.md +145 -0
  28. package/content/agents/resume-coordinator.md +21 -5
  29. package/content/agents/robin-reviewer.md +18 -3
  30. package/content/agents/sanji-quality.md +19 -4
  31. package/content/agents/skeptic-verifier.md +18 -3
  32. package/content/agents/usopp-brainstorm.md +17 -3
  33. package/content/agents/zoro-execution.md +18 -3
  34. package/content/skills/mugiwara-backend/SKILL.md +1 -1
  35. package/content/skills/mugiwara-brainstorm/SKILL.md +5 -1
  36. package/content/skills/mugiwara-checkpoint/SKILL.md +2 -2
  37. package/content/skills/mugiwara-contract-first/SKILL.md +2 -36
  38. package/content/skills/mugiwara-contract-first/references/process.md +37 -0
  39. package/content/skills/mugiwara-execution/SKILL.md +30 -13
  40. package/content/skills/mugiwara-execution/references/resume-batching.md +32 -0
  41. package/content/skills/mugiwara-frontend/SKILL.md +1 -1
  42. package/content/skills/mugiwara-gates/SKILL.md +32 -30
  43. package/content/skills/mugiwara-healing/SKILL.md +1 -1
  44. package/content/skills/mugiwara-orchestration/SKILL.md +41 -25
  45. package/content/skills/mugiwara-orchestration/references/delegation-pillars.md +40 -0
  46. package/content/skills/mugiwara-orchestration/references/triage-escalation.md +96 -0
  47. package/content/skills/mugiwara-planning/SKILL.md +23 -27
  48. package/content/skills/mugiwara-planning/references/plan-template.md +42 -0
  49. package/content/skills/mugiwara-pr/SKILL.md +2 -2
  50. package/content/skills/mugiwara-quality/SKILL.md +10 -6
  51. package/content/skills/mugiwara-resume/SKILL.md +7 -2
  52. package/content/skills/mugiwara-review/SKILL.md +20 -1
  53. package/content/skills/mugiwara-review/references/code-attributes.md +38 -0
  54. package/content/skills/mugiwara-root-cause/SKILL.md +3 -30
  55. package/content/skills/mugiwara-root-cause/references/process.md +35 -0
  56. package/content/skills/mugiwara-security/SKILL.md +17 -32
  57. package/content/skills/mugiwara-security/references/owasp-top10.md +12 -0
  58. package/content/skills/mugiwara-security/references/rationalizations.md +8 -0
  59. package/content/skills/mugiwara-ship/SKILL.md +5 -4
  60. package/content/skills/mugiwara-workflow/SKILL.md +74 -77
  61. package/content/skills/mugiwara-workflow/references/workspace-layout.md +50 -0
  62. package/content/skills/using-mugiwara/SKILL.md +8 -19
  63. package/dist/mugiwara.js +107 -41
  64. package/gemini-extension.json +1 -1
  65. package/hooks/session-start.ts +1 -1
  66. package/package.json +11 -4
  67. package/plugin.json +1 -1
  68. package/references/multi-actor.md +1 -1
  69. package/scripts/evidence.sh +12 -5
  70. package/scripts/gate-selftest.ts +266 -0
  71. package/scripts/initiative.ts +248 -0
  72. package/scripts/lane.sh +15 -0
  73. package/scripts/mission-report.sh +90 -12
  74. package/scripts/onboard.ts +292 -0
  75. package/scripts/release-notes.ts +42 -13
  76. package/scripts/savepoint.sh +97 -50
  77. package/scripts/validate-content.ts +77 -0
  78. package/scripts/verify-install.ts +72 -0
  79. package/src/installer.ts +34 -7
  80. package/src/mission.ts +7 -5
  81. package/src/targets/claude.ts +20 -3
  82. package/src/targets/generic.ts +1 -1
  83. package/src/targets/opencode.ts +31 -10
  84. package/docs/concepts/agents.md +0 -53
  85. package/docs/concepts/audit-trail.md +0 -65
  86. package/docs/concepts/comparison.md +0 -58
  87. package/docs/concepts/config.md +0 -55
  88. package/docs/concepts/cost.md +0 -45
  89. package/docs/concepts/execution-model.md +0 -92
  90. package/docs/concepts/git-strategy.md +0 -62
  91. package/docs/concepts/lanes.md +0 -82
  92. package/docs/concepts/modes.md +0 -73
  93. package/docs/concepts/pr-summary.md +0 -54
  94. package/docs/concepts/skills.md +0 -55
  95. package/docs/concepts/workflow.md +0 -89
  96. package/docs/getting-started.md +0 -158
  97. package/docs/index.md +0 -56
  98. package/docs/install/antigravity.md +0 -45
  99. package/docs/install/claude.md +0 -77
  100. package/docs/install/cli.md +0 -115
  101. package/docs/install/codex.md +0 -44
  102. package/docs/install/copilot.md +0 -45
  103. package/docs/install/cursor.md +0 -45
  104. package/docs/install/gemini.md +0 -44
  105. package/docs/install/index.md +0 -53
  106. package/docs/install/kimi.md +0 -45
  107. package/docs/install/opencode.md +0 -143
  108. package/docs/install/pi.md +0 -46
  109. package/docs/reference/adoption-guide.md +0 -72
  110. package/docs/reference/agent-anatomy.md +0 -72
  111. package/docs/reference/compliance-matrix.md +0 -81
  112. package/docs/reference/developer-onboarding.md +0 -89
  113. package/docs/reference/enforcement.md +0 -35
  114. package/docs/reference/harness-matrix.md +0 -41
  115. package/docs/reference/skill-anatomy.md +0 -71
  116. package/docs/troubleshooting.md +0 -91
  117. package/evals/cases/_no-skill.json +0 -16
  118. package/evals/cases/adversarial-pressure-fake-pass.json +0 -25
  119. package/evals/cases/adversarial-pressure-skip-review.json +0 -25
  120. package/evals/cases/lane-exploratory-vague.json +0 -24
  121. package/evals/cases/lane-sensitivity-payment.json +0 -24
  122. package/evals/cases/positive-refactor-existing-tests.json +0 -25
  123. package/evals/cases/positive-resume-mid-mission.json +0 -24
  124. package/evals/cases/routing-agent-security.json +0 -25
  125. package/evals/cases/routing-auth-feature.json +0 -26
  126. package/evals/cases/routing-backend.json +0 -25
  127. package/evals/cases/routing-bug-one-file.json +0 -26
  128. package/evals/cases/routing-claim-audit.json +0 -25
  129. package/evals/cases/routing-context-budget.json +0 -25
  130. package/evals/cases/routing-contract-first.json +0 -25
  131. package/evals/cases/routing-execution.json +0 -25
  132. package/evals/cases/routing-frontend.json +0 -26
  133. package/evals/cases/routing-gates.json +0 -25
  134. package/evals/cases/routing-git.json +0 -25
  135. package/evals/cases/routing-healing.json +0 -25
  136. package/evals/cases/routing-lessons.json +0 -25
  137. package/evals/cases/routing-orchestration.json +0 -25
  138. package/evals/cases/routing-planning.json +0 -26
  139. package/evals/cases/routing-pr.json +0 -25
  140. package/evals/cases/routing-quality.json +0 -25
  141. package/evals/cases/routing-ship.json +0 -26
  142. package/evals/cases/routing-sunset.json +0 -25
  143. package/evals/cases/routing-using-mugiwara.json +0 -25
  144. package/evals/cases/routing-workflow.json +0 -25
  145. package/evals/floor.json +0 -6
@@ -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.
@@ -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).
@@ -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.
@@ -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
- ```
@@ -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).
@@ -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).