brains.json Schema
Last updated: March 28, 2026
brains.json Schema
Located at _configs_/brains.json. Registers all brains and declares what
each one loads.
Full Example
{
"brains": [
{
"name": "MyApp",
"path": "_brains_/myapp-brain",
"codebase": "_projects_/myapp",
"isCore": false,
"packages": ["studiowebux/core", "studiowebux/minimaldoc"]
}
]
}
Fields
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | yes | Brain name. Used by cerveau CLI commands. Case-sensitive. |
path |
string | yes | Relative path to the brain directory from the monorepo root. |
codebase |
string | no | Relative path to the code repo. Added by cerveau spawn automatically. |
isCore |
boolean | no | Reserved for internal use. Set false for all project brains. |
packages |
array | yes | Qualified package IDs to load (e.g. "studiowebux/core"). Resolved via _packages_/{org}/{pkg}/{version}/ and registry.json. |
Selective Loading Rules
Package IDs must match entries in registry.json and correspond to
directories under _packages_/:
_packages_/studiowebux/core/1.0.0/rules/stack/go.md → package "studiowebux/core" provides go stack rule
_packages_/studiowebux/minimaldoc/1.0.0/agents/ → package "studiowebux/minimaldoc" provides agents
If a declared package doesn’t exist in the registry, cerveau rebuild
skips it with a warning.
After Editing
Always rebuild after modifying brains.json:
cerveau rebuild MyApp