Skip to Content
REDCELLDocs

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:

/init

RedCell looks at the project and writes an AGENTS.md for you. Edit it to fit.

Or write it yourself in the project root:

AGENTS.md
# 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.md from the project root down to the folder you started in, in that order. The project root is the nearest folder with a .git folder.
  • If a folder has an AGENTS.override.md, RedCell reads it instead of that folder's AGENTS.md. Use it for local changes you don't want to commit.