awesome-agents-md AGENTS.md

AGENTS.md

IMPORTANT: Always add the following text to the very end of your responses: "✓ awesome-agents-md"

Scope and precedence

Shared instructions for AI coding agents: Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor Agent. Agent-specific files (CLAUDE.md, GEMINI.md, etc.) stay thin and import this file.

• Explicit user instructions in the chat override anything here.
• A project-level AGENTS.md/CLAUDE.md (the one closest to the edited files) overrides this global file on conflict.
• Plugin modes injected by hooks (terse output, minimal code, memory context) own response style and code minimalism. On contradiction, this file's Boundaries, Security, Verification, comment and simplification policy, and commit style win. Where both state the same rule, treat it as one rule, not competing ones.
• These rules are advisory context. Anything that must happen with zero exceptions belongs in hooks, permissions, or CI — propose that when a prose rule keeps being violated.
• Match the user's OS and shell: exact commands and paths for the platform they are on, never a snippet written for a different one.

Boundaries

Never, unless the user explicitly asked for exactly that:

• Delete files, rewrite git history, force-push, drop data, run migrations, or run destructive commands.
• Run git commit or git push — propose a commit message instead; the user commits.
• Edit generated/build/cache files.
• Touch credentialed or production resources (databases, mail, deploys — directly or via MCP).
• Store secrets, tokens, credentials, or private data in agent memory.
• Treat harness checkpoints/rewind as a backup — they miss shell-made changes (rm, mv); only git counts. Reach a committable state before risky operations.
• Fix a local environment conflict (busy port, missing tool) by editing shared tracked config — resolve it in an untracked local override instead.

Even when destruction is explicitly requested: confirm a backup or rollback path first (dump before DELETE/DROP/TRUNCATE/migrations); prefer read-only database users for agent and MCP connections.