AGENTS.md examples from real projects

clawdbotAGENTS.md

clawdbot / ui

clawdbot/clawdbot/ui/AGENTS.md

Control UI Guide ## Solid - Before writing, reviewing, or refactoring any Solid code here, read the [Solid skill](../.agents/skills/solid/SKILL.md) in full, the installed `node_modules/solid-js/CHEATSHEET.md` it points to, and the references

molt-botAGENTS.md

clawdbot

molt-bot/clawdbot/AGENTS.md

merge or completion ([gate](.agents/skills/openclaw-pr-maintainer/references/media.md#screenshot-completion-gate)). - Before committing or landing nontrivial code, get fresh review through the permitted workflow and resolve actionable findings unless the user opts

No other project uses it yet

molt-botReads credentialsAGENTS.md

clawdbot / scripts

molt-bot/clawdbot/scripts/AGENTS.md

Actions run URL land in `.local/gates.env` (`REMOTE_GATES_*`) and `.local/prep.md`. Use it for reviewed trusted code when a loaded host makes the local 88-shard run stall-kill; contributor/fork code

molt-botAGENTS.md

clawdbot / ui

molt-bot/clawdbot/ui/AGENTS.md

separate `control-ui-boot-*` groups in `ui/config/control-ui-chunking.ts`, reducing requests without pulling chat-only code into New Session. Its `entries` record contains the dynamic entry points actually requested by each route

obraAGENTS.md

superpowers

obra/superpowers/AGENTS.md

theoretical fixes Every PR must solve a real problem that someone actually experienced. "My review agent flagged this" or "this could theoretically cause issues" is not a problem statement

No other project uses it yet

DeepSeekReads credentialsAGENTS.md

deepseek-harness

deepseek-ai/deepseek-harness/AGENTS.md

component or state, conversation or Session behavior, or lifecycle, concurrency, subprocess, and teardown code. Its [review principles](docs/defensive-patterns/README.md#why-these-rules) apply per artifact. ## Type safety and documentation Everything compiles

DeepSeekAGENTS.md

deepseek-harness

deepseek-ai/deepseek-harness/docs/AGENTS.md

timing, ownership, modality, exceptions, consequences, and non-obvious orientation; delete narration, test walkthroughs, review analysis, and code restatement. Keep the local contract and link its rationale. Use [dsh-prose-standard

DeepSeekAGENTS.md

deepseek-harness / system

deepseek-ai/deepseek-harness/native/system/AGENTS.md

packages have one independent version and release workflow. ## Runtime rules - Landlock's argv, exit codes, diagnostics, and fail-closed confinement are defined in [docs/cli-contract.md](docs/cli-contract.md). Do not change them when

No other project uses it yet

DeepSeekReads credentialsAGENTS.md

deepseek-harness / client

deepseek-ai/deepseek-harness/packages/client/AGENTS.md

current design; these are the rules you must not violate when writing or reviewing client code: 1. **Two declaration forms**: use `ctx.slots.register({ name, children?, store?, inject? }, Component)` for a parent

NousResearchAGENTS.md

hermes-agent / agent

NousResearch/hermes-agent/agent/AGENTS.md

name == ...` chain); `tools/todo_tool.py` is the pattern. ## Message-flow invariants (every change is reviewed against these) - **Prompt caching must not break.** Never alter past context, change toolsets, reload memories, or rebuild

No other project uses it yet

NousResearchReads credentialsAGENTS.md

hermes-agent

NousResearch/hermes-agent/AGENTS.md

core. Two invariants shape almost every design decision and are the lens for reviewing any change: - **Per-conversation prompt caching is sacred.** Mutating past context, swapping toolsets, reloading memories

NousResearchReads credentialsAGENTS.md

hermes-agent / cron

NousResearch/hermes-agent/cron/AGENTS.md

pool is keyed by home (`cron.max_parallel_jobs` is per profile); and the stale-code yield gate asks `scheduler_ownership.owns_cron_tick_for(home)` / `live_gateway_ticking(home)` instead

No other project uses it yet

NousResearchAGENTS.md

hermes-agent / tests

NousResearch/hermes-agent/tests/AGENTS.md

keep it. Reviewers reject new change-detectors; authors convert them before re-review. ## Never read source code in tests A test that reads a `.py`/`.ts`/`.tsx` file's text

affaan-mAGENTS.md

ECC

affaan-m/ECC/AGENTS.md

design and scalability | Architectural decisions | | tdd-guide | Test-driven development | New features, bug fixes | | code-reviewer | Code quality and maintainability | After writing/modifying code | | security-reviewer | Vulnerability detection | Before commits, sensitive

No other project uses it yet

affaan-mReads credentialsAGENTS.md

ECC

affaan-m/ECC/.codex/AGENTS.md

metadata Available skills: - tdd-workflow — Test-driven development with 80%+ coverage - security-review — Comprehensive security checklist - coding-standards — Universal coding standards - frontend-patterns — React/Next.js patterns - frontend-slides — Viewport-safe HTML

TheAlgorithmsAGENTS.md

Python

TheAlgorithms/Python/AGENTS.md

algorithm file per PR.** Split unrelated changes into separate PRs to keep review focused. - **Don't change code and its doctests in the same PR.** If you're only updating

No other project uses it yet

n8n-ioReads credentialsAGENTS.md

n8n

n8n-io/n8n/AGENTS.md

comprehensive lint, typechecks, and test suites. - For documentation-only changes, review the diff and run `git diff --check`. Skip code tests when no behavior changed. - Report which checks

MicrosoftAGENTS.md

vscode / references

microsoft/vscode/extensions/copilot/assets/prompts/skills/agent-customization/references/agents.md

Supported Events `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `PreCompact`, `SubagentStart`, `SubagentStop`, `Stop` ### Example ```yaml --- description: "Secure code reviewer that blocks dangerous commands" tools: [read, search, execute] hooks: PreToolUse: - type: command command: "./scripts/block-dangerous-cmds.sh

No other project uses it yet

MicrosoftAGENTS.md

vscode / copilotcli

microsoft/vscode/extensions/copilot/src/extension/chatSessions/copilotcli/AGENTS.md

Copilot CLI agent: * File Operations * Shell Operations * Search Operations * Agent & Task Operations * User Interaction * Code Review & Git * Data, Memory & MCP * Security ### `common/copilotCLIPrompt.ts` Parses raw user prompts and extracts structured chat

No other project uses it yet

MicrosoftAGENTS.md

vscode / agentHost

microsoft/vscode/src/vs/platform/agentHost/AGENTS.md

exports the public provider types from `agent.ts` for call-site compatibility; new provider code should import directly from `agent.ts`. ### Customization installation (Skills, MCP servers, catalog plugins) Installation is local-only