01
Read where the project lives
PasClaw walks from the current working directory up to the git root looking for AGENTS.md, so subdirectory invocations inherit the same project-level rules as a repo-root run.
// AGENTS.md
Project rules the whole agent ecosystem reads.
AGENTS.md is the cross-runtime project-rules convention shared with opencode, Codex, Cursor, and Zed. PasClaw walks from cwd up to the git root, picks up any AGENTS.md it finds, and injects it as the system prompt's ## Project Rules section so every turn respects the same conventions.
cwd → git root walk## Project Rulespasclaw init/init slash command
02
Injected as Project Rules
The file contents are inserted into the system prompt under ## Project Rules, alongside MEMORY.md and SCARS.md, so the model treats them as authoritative instructions.
03
Bootstrap with init
pasclaw init (and the /init slash command in the interactive agent) scans the current project and asks the model for a starter AGENTS.md, so existing repos get a project-rules file without hand-authoring.
04
Plays well with exports
pasclaw export renders the same operator rules to CLAUDE.md, .cursor/rules, GEMINI.md, .zed/agent.md, and AGENTS.md, so teammates on a different agent runtime pick up the same conventions.
From the documentation
Technical details
Implementation notes drawn from the PasClaw repository documentation.
Discovery + injection
PasClaw walks from cwd up to the git root for AGENTS.md and injects the contents as the system prompt's ## Project Rules section, alongside MEMORY.md and SCARS.md.
Init flow
pasclaw init and the /init slash command scan the current project and ask the model for a starter AGENTS.md. Refuses to clobber an existing AGENTS.md without --force.
Source documentation
Common questions
Frequently asked questions
Keep exploring
See how the rest of PasClaw fits together.