STATEFUL MULTI-AGENT ORCHESTRATION

DELIVERING ENTERPRISE-QUALITY CODE

YOU ARE THE ARCHITECT, the dreamer of great possibilities. Consult the Oracle and design your grand plans. Then call upon the Prophet to see your designs turned into reality.

THE THREE PLAGUES OF AI DEVELOPMENT

The System Faltered. The Code Broke.

Every team that has tried to scale AI-assisted development has encountered these three failures. DivineSWE was created to overcome them.

I

Context Rot

Long-running AI sessions lose track of decisions made hours ago. Agents forget architecture choices, repeat resolved debates, and contradict earlier reasoning. The longer the session, the worse the degradation. DivineSWE externalizes context into files.

II

AI Slop

AI assistants emit code that reads correctly and ships bugs, security holes, and regressions all the same. With no adversary actively trying to break it — and no verification gate it must pass — plausible-but-wrong work lands in your repo unchecked. DivineSWE abolishes this with adversarial audit (4eyes + Loki) and a verification gate (Styx).

III

Black Box

What did the agent decide and why? Which files were touched? Where did it fail? Without a structured event ledger, every AI session is a black box — unrepeatable, unauditable, and impossible to reason about. DivineSWE maintains an audit trail.

THE DIVINE ROSTER

A Council of 11 Specialized Agents

Each a distinct intelligence, each a sacred role. Together they fulfill the work of software engineering that no single mind could maintain with fidelity across the full arc of a project.

Thoth

Sacred Scribe

Inscribes failing tests before a single line of implementation is written. The law made visible.

Monkey

The Implementer

Makes the failing tests pass. The hands that build what the scribe has ordained.

4eyes

Auditor Supreme

Sees what the builder cannot. Quality and security review — the second pair of sacred eyes.

Loki

Adversarial Probe

The divine trickster. Probes for vulnerabilities, regressions, and hubris in every artifact.

Mason

Commit Composer

Seals completed work into the ledger. Every commit is a stone laid in the Temple's foundation.

Styx

River Guardian

Confirms deployed artifacts meet acceptance criteria. Nothing crosses the Styx unchecked.

Preacher

Design Guardian

Enforces architectural principles. The voice that cries in the repository when doctrine is broken.

Atlas

Read-Only Explorer

Surveys the codebase from four angles and returns a map. Reads every path, moves no stone — the cartographer of the Temple.

Occam

The Pruner

Holds the Razor at Oracle's table and argues a proposed task has not earned its place.

THE LIVING REGISTERS

State That Outlives the Context Window

The council is only half the covenant. Beneath the agents runs a lattice of state registers — each a distinct artifact with its own write path, its own gates, and its own honesty rules. Together they are what makes DivineSWE stateful: nothing owed is forgotten, nothing declared is unbacked, and nothing unread is reported as clean.

Books

Milestone task files the Prophet walks top-to-bottom. Sealed Books are archived into TABLETS.md and struck from the living scrolls.

Scrolls

Per-task context anchors. Critical state externalized to JSON so no context window can rot an agent’s awareness mid-prophecy.

Ledger

An append-only event log. Every phase start, dispatch, decision and verification pass is inscribed as eternal proof of what was wrought.

Vows

The obligation register. A debt noticed is a debt inscribed — one line at the moment it surfaces, judged by evidence, never by forgetting.

Decrees

Deprecated with the Book cycle. Committed briefs of Architect intent above the Books, kept only for a project that still turns them on.

The Canon

Deprecated, with no replacement. Declared truth about the system itself, derived from an append-only log and written only by the seal, a judge, or a correction Book.

The Scry

Deprecated — read the Vows with vow surface. The pure-read report still runs, and a source it could not read reports UNKNOWN, never zero.

Daedalus

The tool catalog. What this machine already holds — searched before any hand-rolled script, every run counted, nothing silently enforced.

The Avatar

The ad-hoc live seat. One pantheon agent summoned outside the cycle for one small change — a real scroll, paired ledger events, and done.

Hermes

The guarded foreign summons. Ad-hoc carrier dispatch to codex and OpenAI-compatible models, risk-acknowledged by a human, never a cycle dispatch.

Every register's write path, gate, and failure honesty contract is documented in the State Model and the Vows consumer contract.

FROM WORD TO WORKING CODE

How the Word Becomes Working Software

Every Book traverses eight phases in strict order — from Oracle consultation to verified deployment. No phase is skipped. The council carries your word through each station.

01
INIT

The oracle is consulted. A Book is opened. The prophecy is inscribed.

02
TEST

Thoth writes failing tests. The specification is made visible as red assertions.

03
IMPLEMENT

Monkey implements until every test turns green. No stubs, no placeholders.

04
AUDIT

4eyes and Loki audit in parallel — security, quality, and adversarial probing.

05
MERGE

Mason seals the work into the ledger. Branches merge. History crystallizes.

06
VERIFY

Styx confirms the deployed artifact. The cycle is not complete until this passes.

07
WRAP UP

4eyes looks back over the finished work and inscribes what was learned into the teachings.

08
SEAL

The Book is archived into TABLETS.md and its page struck from the living scrolls. The prophecy is fulfilled.

BEGIN INITIATION

Install the Council

Two commands. The first adds the marketplace. The second summons the council. All eleven agents awaken in your Claude Code session — ready to fulfill your Books.

/plugin marketplace add https://gitlab.com/aidragonhq/divineswe.git
/plugin install divineswe
✦ DivineSWE council installed. Eleven agents await your word.

Designed for Claude Code. The council installs into your active session via the plugin marketplace. Copilot, Codex, and OpenCode are also supported — see the full installation guide in the docs.