Wave 5g ships zero-paste install for the matilha ecosystem.
Closes the friction + invisible-priority-rule gap surfaced in v1.1.0 smoke. Post-research finding: Claude Code exposes `claude plugin install` as a documented shell command and `/reload-plugins` as an in-session hot-reload command, so the true zero-paste flow is feasible.
5 SPs shipped
| SP | What |
|---|---|
| SP-B | Canonical CLAUDE.md snippet + merge-or-create contract at `docs/matilha/templates/` |
| SP-A | `matilha install-plugins` CLI with 4 presets + clipboard + paste-block mode |
| SP-C | `/matilha-install` interactive wizard with AskUserQuestion preset picker + CLAUDE.md bootstrap |
| SP-D | `matilha-compose` Step 0 preflight dependency check — advisory notice when CLAUDE.md is missing or orphan |
| SP-E | `--deep` zero-paste install mode — CLI runs `claude plugin install` per pack; wizard gains "Run it now" option via Bash |
Zero-paste install flow
```bash
npm install -g matilha@1.2.0
matilha install-plugins --full --deep --with-claudemd
→ claude plugin install ×8, CLAUDE.md populated at cwd
→ "next: open Claude Code and run /reload-plugins"
claude
/reload-plugins
✓ 8 plugins loaded
[any creative-work prompt]
♛ ← sigil on first try
```
Three-surface architecture
- CLI (`matilha` via npm) — phase commands + `install-plugins` subcommand
- Plugin (matilha-skills + 7 companion packs) — composition layer, SessionStart, sigil
- CLAUDE.md (per-repo) — activation-priority rule, ambient context for matilha-compose
Prior to v1.2.0, the third surface was invisible in docs. The install flows and compose preflight now make it explicit.
Compatibility
- No breaking changes. All v1.1.0 flows preserved as fallbacks.
- Pack versions unchanged (stay at 0.2.0).
- Validator: 1496 tests passing (+14 SP-E tests).
Companion CLI release: matilha v1.2.0 — the `--deep` flag and clipboard integration live there.
Full changelog: see `CHANGELOG.md` in this release.