anmoln7/agent-standard-oss

Agent Standard is a convention for keeping the instruction files that AI coding agents read, usually named AGENTS.md or CLAUDE.md, accurate and up to date as a codebase changes. These files tell agents how to work in a repository: what commands to run, what rules to follow, what pitfalls to avoid. The problem the project addresses is that these files drift. When a codebase has two instruction files, or when a README also documents some of the same rules, they fall out of sync and the agent starts following stale guidance confidently. The core of the standard is a small set of conventions. One file, AGENTS.md, is the single authoritative source. If you also have CLAUDE.md (the file Claude Code reads), it becomes a one-line reference pointing at AGENTS.md. A docs/solutions/ directory holds a separate file for each past bug or gotcha the team has encountered, making it searchable. A designated section in the main instruction file lists file pairs that must always agree, creating an explicit anti-drift contract that can be checked automatically. Beyond the documentation conventions, the project includes optional shell scripts and hooks for safer day-to-day work with AI agents: a pre-commit scan for secrets, session startup hooks that silently repair common configuration failures before they cause problems, commit identity rules, helpers for safe landing of changes, and a multi-account deploy guardrail. Adoption comes in layers. The docs-only approach requires no scripts and no automation: clone the repo, rename your instruction file, create the fix log directory, and run a read-only check. The fuller adoption adds shell scripts to your PATH and optional git hooks. An interactive wizard called adopt guides you through either path with a before-and-after scorecard and a question before every change. Nothing is deleted automatically. The standard works with Claude Code, Codex, Cursor, and Gemini. The AGENTS.md file is the format those tools read natively. A Claude Code plugin wraps the wizard in a slash command. The project is MIT licensed and includes a CI action that checks compliance automatically.