# Continuous Improvement Plugin Bundle (Claude Code)

This directory is generated by `npm run build`.
Do not edit files here manually; edit the source files in the repo root and rebuild.

Included surfaces:
- `.claude-plugin/plugin.json`
- `.claude-plugin/marketplace.json`
- `skills/`
- `commands/`
- `agents/` — `code-reviewer`, `security-auditor`, `test-engineer` personas (auto-discovered Claude Code subagents; pattern from addy/agent-skills)
- `hooks/`
- `bin/mcp-server.mjs`
- `bin/observe.mjs`
- `bin/backfill.mjs`
- `lib/plugin-metadata.mjs`
- `lib/observe-event.mjs`
- `instinct-packs/`
- `templates/planning-with-files/`

## Required vs Optional companions

The `proceed-with-the-recommendation` skill (bundled here) routes each
recommendation it walks to a specialist skill. Some specialists ship in
this bundle; the rest live in external plugins. Every external routing
target has a concretely-worded inline fallback in the orchestrator skill,
so the plugin works on a clean install with no other plugins present —
the trade-off is fallback quality vs dedicated-skill quality.

**Bundled with this plugin (no extra install needed):**

- `continuous-improvement` — core 7 Laws skill
- `proceed-with-the-recommendation` — the orchestrator itself
- `ralph` — autonomous PRD-scale loop
- `tdd-workflow` — RED/GREEN/REFACTOR + 80% coverage gate
- `workspace-surface-audit` — environment + capability audit
- Tier-1/Tier-2 enforcement skills (`gateguard`, `verification-loop`,
  `safety-guard`, `token-budget-advisor`,
  `strategic-compact`, `wild-risa-balance`)

**Optional companions the orchestrator routes to (install separately if
you want the dedicated skill instead of the inline fallback):**

| Source plugin | Routing targets | Notes |
|---|---|---|
| `obra/superpowers` | `superpowers:brainstorming`, `:writing-plans`, `:systematic-debugging`, `:test-driven-development`, `:requesting-code-review`, `:verification-before-completion`, `:dispatching-parallel-agents`, `:finishing-a-development-branch`, `simplify`, `schedule`, `loop`, `update-config` | Largest external surface; covers planning, debugging, parallel dispatch, branch-finish |
| Claude Code host (Anthropic built-in) | `security-review` | Ships with the host CLI itself, not a separate plugin install |
| `code-review` plugin | `code-review` | Diff walk + severity tagging |
| `documentation-lookup` agent / `context7` MCP | `documentation-lookup` | Library docs lookup with citations |
| `frontend-design` plugin | `frontend-design:frontend-design` | Distinctive UI generation |
| `commit-commands` plugin | `commit-commands:commit`, `:commit-push-pr` | Conventional-commit + push-PR helpers |

Full per-target audit (license status, bundled flag, inline fallback,
risk-if-absent) lives in `docs/audits/2026-05-06-routing-target-gap.md`.
Per-target inline fallbacks are spelled out in the orchestrator skill at
`skills/proceed-with-the-recommendation/SKILL.md` § "Routing Table
(with Inline Fallbacks)".
