Skip to content

AGENTS.md

Latest commit

 

History

History
31 lines (26 loc) · 1.49 KB

AGENTS.md

File metadata and controls

31 lines (26 loc) · 1.49 KB
Raw

Agent Instructions

CLAUDE.md is the source of truth for this repository's behavior, architecture, and Claude Code integration details. Codex-facing notes in this file are additive and must not rewrite, rename, or "translate" Claude-specific contracts into Codex-shaped ones.

When working on dual-agent support:

  • Treat Claude commands, hooks, MCP registration, markdown entry format, and transcript assumptions documented in CLAUDE.md as canonical.
  • Add Codex support through adapters, policy helpers, fixtures, and separate documentation.
  • Do not change Claude-facing field names or hook output text for Codex convenience.
  • If a Claude-specific section needs clarification, update a separate dual-agent note first and only edit CLAUDE.md when the Claude contract itself changes.
  • Prefer docs/03_dual_agent_support.md for Codex sidecar policy and execution notes.

Product and documentation ownership

  • Caveat must remain independently installable, configurable, diagnosable, recoverable, updatable, and releasable from this repository. dotagents may integrate Caveat into a factory, but it is not a runtime or control dependency.
  • docs/00_overview.md lists the only current documents. Completed plans, handoffs, audits, release ledgers, and announcement drafts belong in docs/archive/ and are not default reading.
  • Merge overlapping current guidance into the existing README, product contract, host contract, or release checklist instead of adding another parallel Markdown file.