@AGENTS.md
The rules above are shared with Codex and are the single source of truth. Do not
restate or paraphrase them here — a second copy drifts, and the two agents then
work from different instructions. Repo rules go in AGENTS.md; only the
Claude-specific handoff rules below belong in this file.
This repo is edited by both Codex and Claude, sometimes on the same day.
- Before starting, read the newest
handoffs/_registry.mdentry and check itsOwnerandBranch. - If an
Activeentry is owned by the other agent, do not edit the same files on the shared branch. Work onclaude/<topic>or pick up different work. - When you finish something durable, write a handoff with
Owner: claudeand the branch you worked on. Conversation-only context is not a release record. - State what you actually verified and what you did not. The other agent will treat your handoff as fact.
Both agents query the same index through the flyto-indexer MCP server —
registered in .mcp.json for Claude and ~/.codex/config.toml for Codex.
- A
post-commithook reindexes this repo automatically, so committed work by the other agent is visible to you. Uncommitted work is not. - If
searchorimpactresults look stale, runflyto-index scan .first. - Agent scratch checkouts under
.claude/worktrees/are excluded from the index. Delete them when the work is merged; they are full copies of the repo.