Agents-router bridge branch: rebase onto main and adopt the #74 deploy gate #93

Context

feat/agents-router-bridge-28-09-2026 (3 commits, no PR) replaces the --agents install. Instead of a parallel .agents/ tree, it installs the normal .claude/ tree plus:

• AGENTS.md
• one router skill at .agents/skills/solana-ai-kit/SKILL.md
• .codex/hooks.json

The reason: Codex and opencode don't read .agents/commands/ or .agents/agents/. Also, Codex splits one ~22K-character skill-description budget across every registered skill.

Current state

• Conflicts: the branch is 3 ahead and 24 behind main, and now conflicts in .claude/bin/update.sh, .claude/commands/cleanup.md, README.md, install.sh, plugin/.claude-plugin/plugin.json and tests/test_install_agents_only.sh (deleted on the branch, modified on main).
• Release commit: it contains a 2.2.0 release commit (165295c) that should not land as-is; the release is tracked in Release 2.2.0: nothing merged since v2.1.0 has reached users #82.
• Deploy gate: it moves the old pre-deploy hook into .claude/bin/hooks/pre-deploy.sh. fix: Review permission gate and restrictive commits #74 (now merged) removed that hook and replaced it with an ask-based on-chain-write hook, so the branch needs to use the new gate, including in bridge/codex/hooks.json. Codex's shell tool is named shell/local_shell, not Bash, so the matcher must cover those names.
• Codex skill budget: smaller than when the branch was written. Since tiering, a default --agents install on main registers 7 SKILL.md files (about 2.3 KB of descriptions), measured on 6a21771. The budget problem comes back when a user adds large extensions; for example, trailofbits alone has 85 skills.
• Two open items on the branch:
  • update.sh --dry-run doesn't report the bridge step as [would update].
  • plugin/hooks/pre-deploy.sh is a symlink that points outside plugin/.

Decision / to do

• Decide whether the bridge is still wanted now that tiering shrank the skill list. The parallel .agents/agents and .agents/commands trees are still unused by Codex.
• If yes, rebase onto main (which includes fix: Review permission gate and restrictive commits #74), drop 165295c, fix the two open items, and open a PR.
• Re-measure the Codex skill budget with skills.sh add all.