Files
amethyst/tools/agent-hooks/pre-push-agent-config.sh
Vitor PamplonaandClaude Opus 5.5 d6a5382e58 chore(agents): share rules, skills and push checks between Claude Code and Codex
Codex (run locally) added AGENTS.md, .agents/skills symlinks and a .codex push
hook; this makes both agents read one copy of everything:

- AGENTS.md is now the single source of the project rules. .claude/CLAUDE.md
  imports it with @../AGENTS.md and keeps only Claude-specific notes; the res/
  guide moves to amethyst/src/main/res/AGENTS.md the same way.
- .agents/skills/<name> are symlinks to .claude/skills/<name>, never copies.
- The push checks move to tools/agent-hooks/, run by .claude/settings.json,
  .codex/hooks.json (matched to Bash and the PR tool) and CI. The Codex hook
  now also runs spotless. The shared gate accepts Codex's payloads.
- New agent_config_check.py (pre-push and CI) enforces the layout: symlinks,
  CLAUDE.md imports, AGENTS.md under Codex's 32 KiB doc limit, description
  length, the combined skill-list budget, and that every path a skill cites
  exists.
- Fixes the Compose-escaping pre-push hook, which exited 1 on a hit and so
  never blocked a push (PreToolUse blocks only on exit 2).
- Live docs point at AGENTS.md instead of .claude/CLAUDE.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 12:20:49 -04:00

32 lines
1.2 KiB
Bash
Executable File

#!/bin/bash
# PreToolUse gate: Claude Code and Codex must keep reading the same rules and skills.
#
# Fires on `git push` (Claude's Bash tool or Codex's shell tool) and on the
# create_pull_request MCP tool. Delegates to agent_config_check.py, which checks
# that AGENTS.md holds the rules and every CLAUDE.md only imports it, that every
# skill in .claude/skills/ is symlinked (not copied) from .agents/skills/, and
# that no skill description lost most of its triggers. See "Agent Configuration"
# in AGENTS.md.
#
# Run the check by hand any time with: tools/agent-hooks/agent_config_check.py
set -uo pipefail
hook_dir="$(cd "$(dirname "$0")" && pwd)"
# Shared by Claude Code (.claude/settings.json) and Codex (.codex/hooks.json):
# resolve the repo from this script, not from either tool's env vars.
cd "$hook_dir/../.." || exit 0
payload="$(cat)"
# Cheap pure-bash pre-filter: only a payload mentioning "push" or "pull_request"
# can be a boundary, and this hook runs on every shell tool call.
case "$payload" in
*push*|*pull_request*) ;;
*) exit 0 ;;
esac
printf '%s' "$payload" | python3 "$hook_dir/lib/git_push_gate.py" || exit 0
# A PreToolUse hook blocks the call only on exit 2.
python3 "$hook_dir/agent_config_check.py" || exit 2