Open framework · CC BY 4.0
A practical security framework for teams that build and operate autonomous AI agents — the kind that plan, call tools, change real systems, and spawn sub-agents without a human reviewing each action.
BUILD-TIME · RUN-TIME · AGENT · CONFIGURATION · ECOSYSTEM
Why agent security needs its own framework.
Every control and observable splits into an agent-scoped half (configured per agent) and an ecosystem-scoped half (the shared substrate). You cannot secure one half alone.
Build-time — fixed when the agent is built
Environment and network isolation; bound the blast radius by topology.
Tokens grant specific capabilities, not wildcards.
Signed, minimal, kernel-isolated; the image hash is part of the agent's identity.
Which tools, which limits — and destructive actions blocked by default.
Run-time — active on every execution
Treat all external input as untrusted; assume injection sometimes succeeds.
Scope per instance and type; validate writes; keep per-entry provenance.
Security-anomaly monitoring, separate from quality monitoring.
Closure — stop and explain
A tested way to halt the agent and its sub-agents, leaving a safe state.
The full execution graph for every action — not just the output.
Observability — the data the controls depend on
Six fields per action, including a content-hashed agent-type-id.
Context size at decision time, so baselines can split by size.
Which sub-agent ran, and the prompt the parent gave it.
Most teams cannot build all twelve at once, and should not wait until they can.
Destructive-verb interception, capability-scoped tokens, a tested kill switch, an audit trail, and the six identity fields.
Environment and egress isolation, a signed minimal container, input validation, context-size logging.
Behavioral monitoring with sequence-pattern baselines, memory provenance, sub-agent and parent-prompt provenance.
Adopting only part of BRACE means you are accepting the rest of the risk on purpose, not removing it.
Use OWASP and MITRE to know what can go wrong. Use BRACE to know what to build, and in what order.
Pick the artifact that matches your job.
agent.* attributes for identity and provenance.Status. BRACE is a synthesis of agent-security practice already in production across the industry — not yet a validated standard. The individual controls are widely deployed; what BRACE adds is the unified organization and the agent-granularity instrumentation. It is an open, evolving project — apply it, critique it, and contribute.