Agent Sync Template — Development skill for Claude Code

Agent Sync Template

This is a small toolkit for keeping Claude Code and Codex configuration in sync without requiring a particular directory layout. It is a companion to my note [How I keep Claude Code and Codex in sync](https://stafforini.com/notes/how-i-keep-claude-code-and-codex-in-sync/).

The setup agent infers where your Claude files live and where your Codex files live, records those paths in a small config file, ports missing counterparts, and registers hook commands that remind or block an agent when it edits only one side.

It does not install sample skills. It does not require symlinks. It does not assume that your configuration lives inside this repository. It is directory-agnostic: the bootstrap must implement the same synchronization contract using the user's existing topology, not a hardcoded dotfiles layout.

Quick start

Give Claude Code or Codex this prompt:

Set up Claude Code <> Codex synchronization using https://github.com/benthamite/agent-sync-template.

- Clone the repository to a sensible local location if it is not already available.
- Run its smoke test before touching my live Claude or Codex configuration.
- Then follow BOOTSTRAP.md exactly.

What the agent writes

The generated `ai-config-sync.json` maps your real Claude and Codex files. It will look roughly like this, but with paths inferred from your machine:

{
  "global": {
    "file_pairs": [
      {
        "name": "global instructions",
        "claude": "~/.claude/CLAUDE.md",
        "codex": "~/.codex/AGENTS.md",
        "normalizer": "instructions"
      }
    ],
    "skill_roots": [
      {
        "name": "global skills",
        "claude": "~/.claude/skills",
        "codex": "~/.codex/skills"
      }
    ],
    "hook_roots": [
      {
        "name": "global hooks",
        "claude": "~/.claude/hooks",
        "codex": "~/.codex/hooks"
      }
    ]
  },
  "project_local": {
    "project_roots": [],
    "instruction_pairs": [
      {
        "nam