Conformance wave: setup-contract adoption (31 plugins)

[kyle-sexton]

Part of the plugin-conformance program — epic #313 (dimension 8 of its matrix).

31 plugins fail the uniform setup contract (skill named setup, disable-model-invocation: true, check read-only + apply idempotent actions, non-interactive when complete arguments are supplied). Two shapes:

A. Setup skill missing despite an external prerequisite or config surface (formatter/linter plugins owe a thin check-centric setup): actionlint, bash-format, biome-format, desktop-notification, disk-hygiene, eol-normalizer, firecrawl, guardrails, markdown-format, playwright, powershell-format, ruff-format.

B. Setup skill present but off-contract (interactive-only, no check/apply action split, no headless path): ai-briefing, bug-report, claude-config, claude-ops, code-tidying, codebase-health, context7, discovery, kindle-dedrm, knowledge, machine-health, miro, planning, repo-fleet-hygiene, skill-quality, songwriting, source-control, toolchain, work-items.

Remediation per plugin: add or refactor to the uniform contract; keep each setup limited to configuration the plugin owns; never write the plugin cache, user settings, or pluginConfigs. Where the only configuration is a Claude-owned userConfig scalar (bug-report, miro), the check action verifies and reports — doctrine may warrant a clarifying carve-out; raise it before mass-refactoring those.

Acceptance: every listed plugin either conforms or carries a documented doctrine-sanctioned exception; version bump + CHANGELOG entry per touched plugin; plugin contract gate green.

🤖 Generated with Claude Code

[kyle-sexton]

Tranches 1 + 2 are merged — 10 of the 31 plugins now conform to the uniform setup contract:

• feat(markdown-format): add setup skill on the uniform contract (0.5.0) #342 (tranche 1): markdown-format 0.5.0 — the fleet's first conforming exemplar, hardened through eight adversarial review rounds (package-manager respect incl. Plug'n'Play and npm-shrinkwrap, hook-source-as-truth probes, --version liveness, verify-after-remediation).
• feat: adopt the uniform setup contract across 9 formatter/CLI plugins #355 (tranche 2): actionlint, bash-format, powershell-format, biome-format, ruff-format, eol-normalizer, desktop-notification, firecrawl, playwright — the exemplar cloned with per-plugin adaptations, plus markdown-format 0.5.1 (disabled-toggle downgrade class fix). Review rounds on this PR produced several contract-level refinements now embedded in all ten: disabled toggle downgrades prerequisite FAILs to INFO; headless reconfigure states --config's fresh-install-only semantics (uninstall-then-reinstall); Python installs go through the repo's own dependency manager as ordered principles rather than a tool ladder; env-var remediations defer verification to a fresh session.

Deferred for lane ownership (org WIP survey): disk-hygiene (#286 touches its manifest/CHANGELOG) and guardrails (#305 ditto) — they join a later tranche once those PRs land.

Carried finding for the shape-B tranche: source-control's existing setup advertises the stale claude plugin install --config reconfigure path — fold the corrected semantics into its refactor.

Remaining: 19 shape-B refactors (tranche 3+), the bug-report/miro check-only carve-out (own PR with its one-line doctrine addition), then the contract-gate check/apply structural rule as the closing tranche.