Files

T

72869f2d9e docs: make AGENTS.md the canonical agent guide for Codex/Astra (#1742 )

Codex reads AGENTS.md by default, not CLAUDE.md. Move project guidance to
AGENTS.md (trim/nest long validation notes under docs/AGENTS.md), leave
CLAUDE.md as a thin @AGENTS.md wrapper for Claude Code, and document the
Codex project_doc_max_bytes raise needed for the ~35KiB root file.

Co-authored-by: Colby McHenry <colbymchenry@users.noreply.github.com>

2026-09-07 22:58:05 -05:00

735 B

Raw Blame History

CLAUDE.md

Claude Code project guidance for this repository.

Primary instructions live in the canonical agent guide — import it:

@AGENTS.md

Claude-only notes

Prefer the repo-root AGENTS.md as the source of truth for build/test/architecture/house rules. Edit that file (not this wrapper) when guidance changes.
Claude Code can @-import nested guides too (e.g. @docs/AGENTS.md) when working on design/eval docs; Codex loads nested AGENTS.md automatically when the session cwd is under that directory.
Do not reintroduce a duplicated ## CodeGraph MCP tool-guidance block here — src/mcp/server-instructions.ts is the single source of truth (issue #529); the installer strips legacy marker blocks on upgrade.

735 B Raw Blame History

CLAUDE.md

Claude-only notes

735 B

Raw Blame History