rembric-plugin-developmentlisted
Install: claude install-skill susomejias/rembric
# Rembric plugin development
Authoritative specs: `openspec/specs/{claude-code-plugin,codex-distribution,hermes-agent-plugin,opencode-plugin,plugin-session-protocol}/`. Archived decisions: `openspec/changes/archive/`.
## Mandatory workflow
1. **OpenSpec change first.** Run `/opsx:propose` (or amend an existing change). Plugin work always touches ≥2 specs and ≥3 files. Skipping the change is the failure mode that produces drift.
2. **Per-component versioning.** Each `apps/plugin/.X-plugin/` is its own release-please component and bumps based on its own paths changing. The `claude-code` and `codex` components are **linked** via the `bridge-bundlers` linked-versions group, so shared changes under `apps/plugin/bin/`, `apps/plugin/hooks/`, `apps/plugin/commands/`, or `apps/plugin/scripts/` cascade-bump both together. The `hermes` and `opencode` components bump **independently** — their `install.sh` re-fetches from `main` at install time, so shared `bin/` changes reach those users on the next install without coordinated release. Removed the old lock-step rule that required bumping all four plugin manifests in the same commit.
3. **End-to-end against `pnpm run dev:docker:up`** before reporting done — see [E2E discipline](#end-to-end-validation-discipline) below.
4. **Docs sweep**: `README.md`, `docs/agents.md`, `apps/plugin/README.md`, the in-plugin `README.md`, `apps/plugin/CHANGELOG.md`. New-client checklist in [references/files-checklist.md](./references/files-checklist.md).