Portable repository instructions · Updated July 2026

AGENTS.md and Agent Workflow Directory

AGENTS.md is a cross-tool convention for giving coding agents durable repository context. Place broad guidance at the root and more specific files deeper in the tree; the closest applicable file takes precedence. Browse community examples or publish your agents.md entry to help grow the directory.

Read the AGENTS.md reference

Commands that actually run

Include setup, development, test, lint, build, and focused-test commands with required prerequisites.

Repository-specific context

Explain architecture, important paths, generated files, conventions, and decisions an agent cannot infer safely.

Clear operating boundaries

Call out secrets, protected files, approval requirements, destructive actions, and changes that are out of scope.

A verifiable finish line

Define the checks, evidence, accessibility expectations, and user journey required before work is complete.

Want to help populate the directory?