AGENTS.md examples from real projects

DeepSeekAGENTS.md

deepseek-harness / notes

deepseek-ai/deepseek-harness/.agents/notes/AGENTS.md

Agent Notes are effectively RFCs written by agents: durable proposals and decision records that preserve rationale, alternatives, consequences, and required verification. Follow the documentation standard and the Agent Note rules. Every new Agent Note triggers a supersession check. Search the active tree for older notes covering the same decision or mechanism, classify any full or partial supersession with dsh-archive-agent-notes, and archive every qualifying implemented triplet in the same PR. Keep partial supersessions active and cross-linked. Files under archived/ are frozen…

DeepSeekAGENTS.md

deepseek-harness / archived

deepseek-ai/deepseek-harness/.agents/notes/archived/AGENTS.md

Archived Agent Note triplets under the kind directories are frozen historical snapshots, not current authority. Never edit, reformat, translate, repair, delete, or move a sealed artifact; use an active Agent Note or current documentation for new decisions and facts. The archival change may only relocate a complete English/Chinese/sidecar triplet, insert the identical Archived: YYYY-MM-DD line below both Status: implemented lines, re-record the sidecar, and repair or delete inbound links. Do not inspect, verify, or repair links out of archived notes.

DeepSeekAGENTS.md

deepseek-harness / implemented

deepseek-ai/deepseek-harness/.agents/notes/implemented/AGENTS.md

These Agent Notes describe shipped decisions. Follow the root instructions, documentation standard, and Agent Note format; verify-agent-note-format gates the lifecycle-specific structure. Keep paths, symbols, defaults, and mechanisms current in the same change that alters them. Rewrite stale facts in place; do not append change history. When a shipped note is unlikely to guide future work, archive its complete triplet through dsh-archive-agent-notes instead of continuing to maintain it. Update factual realization in place. A reversal of the decision or its rationale…

DeepSeekAGENTS.md

deepseek-harness / profiles

deepseek-ai/deepseek-harness/apps/cli/tests/profiles/AGENTS.md

This tree owns cross-package behavior of shipped dsh profiles. Start product scenarios through apps/cli/src/bin.ts with --profile <name> or the <name> shorthand; a test-only Loader driver is allowed only when the public profile output cannot expose the asserted internal evidence. Keep a composition here only when the CLI profile assembly is the subject. Move package-specific Loader configurations and drivers into that package's tests/fixtures/. Recorded-session replay belongs under top-level snapshots/; other expected output uses *.expected.e2e.ts and an owner-local expected/ directory. User-facing optional…

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / benchmarks

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

This tree owns required, repository-level performance gates whose measured user path crosses package ownership. Package-local diagnostics remain beside their owners and use the .perf.ts suffix instead of joining test:bench.

DeepSeekAGENTS.md

deepseek-harness

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

This file defines document structure, Markdown tiers, writing rules, and verify-doc-budgets ceilings. Use dsh-doc for placement and validation, and dsh-prose-standard for required coverage and editorial judgment; the archived doc-tiers Agent Note records the historical rationale. These rules apply to human-facing documentation; Agent Notes remain outside their scope. A postmortem is an incident-scoped reference; chronology records evidence, not a teaching sequence. A document's subject and tree position fix its scope: describe its own subject at appropriate detail and direct children only…

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness

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

Run jobs on Windows runners (windows-* labels) under native pwsh. Native Windows pull-request jobs live in ci-windows.yml and Python pull-request jobs in ci-python.yml, so each PR workflow can be re-run independently; their checks feed the required windows checks passed and python checks passed verdicts, as Linux jobs in ci.yml feed all checks passed; Wine runs Windows Node on hosted Linux only in ci-master.yml. Python runtime CI checks Linux/Windows x64 on pull requests and Linux ARM64 plus both macOS architectures on…

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / system

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

This workspace owns @deepseek-ai/node-addon-system: the Linux landlock-run confinement executable and the POSIX system.node binding. It shares the root pnpm workspace and lockfile; native packages have one independent version and release workflow. packages/entry/ owns JavaScript, types, and auditable C sources. Platform packages hold only binaries and metadata. scripts/ owns native builds, packing, validation, and release; test/ owns real process and lock behavior. Run pnpm build:ts, pnpm build:native, pnpm build:test-oracle, pnpm typecheck, and pnpm test in this directory. Linux full builds require…

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / packages

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

These package-specific rules supplement the repo-wide conventions.

DeepSeekAGENTS.md

deepseek-harness / experimental

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

These rules supplement the package rules. The experimental reference defines experimental, optional, and Official status; the rules below define dependency isolation and promotion.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / schedule

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

These rules supplement the repository and package instructions for packages/schedule/*.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / web

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

These rules supplement the package conventions in packages/AGENTS.md.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / scripts

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

Gate scripts invoke pnpm shell-free, normalize repository-relative glob paths to / at ingestion, and keep platform adaptation in the gate that needs it instead of a shared platform layer. Source-ownership gates use syntax-aware discovery, guard against an empty or narrowed corpus, and test every admitted/excluded form that changes their detection boundary. Script specs run in forked workers beside the rest of the suite and beside the other gate processes in their job, so own every port, temporary path, and child…

DeepSeekAGENTS.md

deepseek-harness / snapshots

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

This tree contains only tests whose committed session JSONL is replay input and expected persisted output. Keep non-session ARIA, geometry, generator, CLI, and unit expected output with its owning app, script, or package; use test:expected, test:web, or test for its owning tier. Every process under test starts through the dsh CLI with a shipped profile and optional scenario patches. Test clients may drive a public protocol or browser interface; do not add another application entrypoint, hidden CLI mode, or executable…

DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/agent-instructions-budget-chains/workspace/AGENTS.md

Project instructions for the budget snapshot workspace. Keep task.txt unchanged; the snapshot reads it as input. Use the read tool for files in this workspace instead of shell commands. Answer with DONE after the requested file has been read.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/agent-instructions-budget-chains/workspace/.dsh/AGENTS.md

Global user preferences for every project. Reply in short, plain sentences and state the result first. Run the narrowest test that covers a change before reporting it as done. Never commit, push, or delete branches unless the user asks for it.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/agent-instructions-budget/workspace/.agents/AGENTS.md

global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction global instruction…

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/agent-instructions-budget/workspace/AGENTS.md

Project budget snapshot instruction.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/agent-instructions-group-failure/workspace/.agents/AGENTS.md

Original global instruction A.

No other project uses it yet

DeepSeekAGENTS.md

deepseek-harness / workspace

deepseek-ai/deepseek-harness/snapshots/session/agent-instructions/workspace/.agents/AGENTS.md

Shared agents-root snapshot instruction.

No other project uses it yet