Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.decepticon.red/llms.txt

Use this file to discover all available pages before exploring further.

A red team engagement is not just “attackers versus defenders.” It is a structured exercise with named roles, each with distinct responsibilities. Decepticon does not replace any of these roles — it operates as a force multiplier inside the Red Cell, with explicit handshakes to the others.

The Four Cells

Red Cell

The offensive component. Simulates strategic and tactical responses of the threat profile. Operates within the RoE. Decepticon executes here.

Blue Cell

All components defending the target — SOC analysts, IR responders, internal staff, management. The audience whose effectiveness the engagement is measuring.

White Cell / Control Cell

The referee. Monitors RoE compliance, separates real incidents from exercise activity, and adjudicates outcomes. Trusted by both Red and Blue.

Trusted Agent (TA)

A privileged insider with detailed knowledge of engagement activities. Prevents irreversible damage and authorizes high-risk steps.

Why the Cells Matter for an Autonomous Agent

The cells are not bureaucracy — they are the boundaries that keep an offensive engagement from turning into an incident. An autonomous agent without these handshakes is reckless. Decepticon is built to fit inside the cell structure, not around it.
CellDecepticon Touchpoint
Red CellDecepticon agents are Red Cell members. They produce findings, evidence, and an attack graph attributable to the engagement.
Blue CellDecepticon does not interact with the Blue Cell during execution. The blue team sees only the artifacts — alerts, telemetry, lateral movement — that the agent generates.
White CellThe operator running Decepticon acts as White Cell liaison: pausing the agent on deconfliction calls, certifying RoE compliance, declaring outcomes. The CLI exposes pause/resume primitives for exactly this.
Trusted AgentWhoever holds the OPPLAN approval authority is the Trusted Agent for the engagement. Decepticon refuses to start an engagement without an explicitly approved RoE and OPPLAN.

Deconfliction

Deconfliction is the process that separates red team activity from real-world activity. It is what allows a SOC to ignore the red team’s beacon when a real incident lights up next to it — and, more importantly, what stops them from ignoring a real incident because they thought it was the red team. Decepticon supports deconfliction in three ways:
1

Engagement-tagged artifacts

Every command Decepticon executes is tagged with an engagement ID. White Cell can query “what was Red doing at 03:14 UTC?” and get an authoritative answer in seconds.
2

Pause primitive

The CLI exposes a graceful pause that halts new objective scheduling without tearing down running C2 sessions, so deconfliction calls don’t burn the engagement.
3

Audit log

All agent actions, tool invocations, and findings are persisted to PostgreSQL with timestamps. The log is the deconfliction record.

Operator-as-White-Cell

In small engagements, the human running Decepticon often plays multiple cells — operator (Red), referee (White), and authority holder (Trusted Agent). Decepticon’s CLI is built around this reality:
  • The OPPLAN approval gate forces the operator to act as Trusted Agent before execution starts.
  • The streaming transcript gives operator visibility identical to a White Cell observer.
  • The pause/resume controls let the operator perform deconfliction handshakes mid-engagement.
For larger engagements, the operator can split these duties — running Decepticon under one identity (Red Cell) and providing deconfliction logs to a separate White Cell process.
The cell model is adapted from the redteam.guide roles & relationships page. Decepticon does not change the model — it slots into it.

Engagement Planning

How Soundwave produces the RoE and OPPLAN that the cells operate against.