A Claude Code plugin · Boyd at full resolution

The loop most
people learn is the
wrong one.

Boyd’s Agent turns Claude Code into a persistent strategic analyst. It maintains your orientation and your adversary’s across sessions, surfaces the mismatches between what you expected and what happened, and runs full OODA cycles on demand — orientation first, not speed first. No prior Boyd knowledge required: the doctrine ships with the agent.

7Slash commands
3Specialist subagents
2Sides, modeled apart
0Actions taken for you
FEEDBACK · ACTION PRODUCES NEW OBSERVATIONS Observe SENSE Orient GENETIC HERITAGE CULTURAL TRADITION PREVIOUS EXPERIENCE NEW INFORMATION ANALYSIS & SYNTHESIS Decide HYPOTHESIS Act TEST
The point is not to cycle faster. The point is to have a better, more coherent, more rapidly updated Orientation than the adversary.
// FROM THE PROJECT’S FOUNDING ESSAY

The popular OODA loop is four boxes in a circle and a moral about speed. Boyd’s last diagram (The Essence of Winning and Losing, 1995) is something else: Orientation shapes which observations register at all, which options surface during decision, and which actions are even considered. There is even an implicit-guidance bypass from Orientation straight to Action.

This agent is built around that harder version. It does not chase tempo for its own sake. It builds and re-builds your orientation — and your adversary’s — and makes the structure of your situation legible enough to act on. Speed follows from that, when it follows at all.

What makes it different

Three design choices, each load-bearing.

This is not a chatbot with a strategy persona. The structure is the product.

01 / STATE

Memory that respects state

Each system lives in its own directory with a documented schema: orientation.yaml for your side, adversary.yaml for theirs, an append-only observation log, and an open/closed list of mismatches. Across sessions and weeks, the picture compounds.

02 / ROLES

Blue and Red, modeled apart

Reasoning is split across three subagents with non-overlapping write permissions. A Blue orienter holds your view; a Red orienter holds the adversary’s. They run in parallel so your model of the other side isn’t contaminated by your model of your own.

03 / SEAM

It proposes; you act

The agent does not act on the world. It produces a next action with rationale, branches, and sequels — and stops. The seam between proposal and execution is preserved as a feature, not a limitation.

The command surface

Seven slash commands. One conceptual spiral.

/boyd-init
Bootstrap a systemSeeds Blue and Red orientation from an interview, with every early belief carrying visible uncertainty.
/boyd-observe
Log what you noticedAppends observations and flags mismatches against the current orientation — lightweight, no full re-orient.
/boyd-cycle
Run a full OODA passObserve → Orient (Blue + Red in parallel) → Decide → Critique → Log. Produces all four artifacts.
/boyd-outcome
Close the loopRecords what an action actually did, links it to the cycle that proposed it, resolves the mismatch it probed.
/boyd-status
Where do I stand?Read-only report: current Schwerpunkt, open mismatches, what’s unprocessed, the one command to run next.
/boyd-strategy
Regenerate the strategyRe-renders the layered artifact — grand strategy down to tactics — without running a whole cycle.
/boyd-critique
Stress-test a plan you already haveRuns the Boyd-critic checklist against a plan you bring — moral/mental/physical coverage, cheng/ch’i differentiation, Schwerpunkt discipline, robustness — and returns the top issues as probe questions, never as rewrites.
Two intelligence shops

The model of the other side is a thing in its own right.

Blue · our orientation

What we believe, and how sure

Falsifiable mental models with explicit confidence and evidence. Each cycle runs Destruction & Creation on at least one of them — pulling a model apart and recombining it against the latest observations.

Red · adversary orientation

What they believe — and what we can’t know

Reasoned from the adversary’s perspective using only what we can plausibly know. Unknowns are marked as unknowns. The Red orienter never writes to Blue’s files, and never hallucinates their internals.

Coordination between them comes from a shared Schwerpunkt — a focus of effort, not a target.

Who it’s for

If you already run OODA loops at work.

Founders & operatorsNavigating a funded competitor moving into your segment.
Strategy & corp-devHolding a coherent picture of a market across months of signals.
Security & intelligenceModeling an adversary’s orientation without projecting your own.
Anyone in a contestA negotiation, a campaign, a deadline, entropy. One adversary per system.

The adversary doesn’t have to be a company — the repo ships worked examples where it’s a hiring process and a procurement org. More in the FAQ.

Open it in Claude Code and start a system.

Install from the marketplace, then bootstrap your first system. Three worked examples ship with the repo — a SaaS company facing a funded incumbent, a job search, a contract negotiation — so you can read a real one first.

> /plugin marketplace add jdinkla/claude-marketplace
> /boyd-init my-system
Full install guide