Project instructions
Give RedCell standing instructions for a project or for all your work with AGENTS.md.
AGENTS.md is a Markdown file of instructions RedCell reads at the start of every session. Use it for things you'd otherwise repeat in every prompt: scope, rules of engagement, tools to prefer, report format.
Create one for a project
In a session in your project folder, run:
/initRedCell looks at the project and writes an AGENTS.md for you. Edit it to fit.
Or write it yourself in the project root:
# Engagement: ACME staging
## Scope
- In scope: *.staging.acme.example, 10.20.0.0/24
- Out of scope: production, anything under acme.example without "staging"
## Rules
- No denial-of-service or destructive tests.
- Rate-limit scans to 50 requests per second.
## Reporting
- Save findings to ./findings/ as one Markdown file per issue.Instructions for all your work
Put an AGENTS.md in ~/.redcell/. RedCell includes it in every session, before any project instructions.
How RedCell finds them
- It reads every
AGENTS.mdfrom the project root down to the folder you started in, in that order. The project root is the nearest folder with a.gitfolder. - If a folder has an
AGENTS.override.md, RedCell reads it instead of that folder'sAGENTS.md. Use it for local changes you don't want to commit.