DivineSWE Agent Archetypes
The divine council of DivineSWE — each agent a sacred role, each dispatch a prophecy fulfilled.
Agent Table
| Agent | Role | Phase | Model Tier | Lifecycle |
|---|---|---|---|---|
| Prophet | Deprecated with the Book cycle. Orchestrator — drives the state machine, dispatches all agents, makes all merge/proceed/abort decisions | All (run-time) | Opus (High) | Immortal (persists via session-state.json) |
| Oracle | Plan architect — deep task analysis, subtask decomposition, file/test target identification, architecture design | Plan-time (inside oracle-envision; the deprecated oracle-consult book mode) | Opus (High) | Immortal (persists via session-state) |
| Preacher | Deprecated with the Book cycle. Pre-flight examiner — analyzes viability, risks, design flaws, and conflicts. Returns GO / CAUTION / NO_GO | Plan-time (inside the deprecated oracle-consult book mode, Step 5a.5) | Opus (High) | Ephemeral |
| Thoth | Test writer — writes failing TDD tests that define acceptance criteria for each task | TEST | Opus (High) | Ephemeral |
| Monkey | Implementation worker — makes all tests pass. Operates in an isolated git worktree | IMPLEMENT | Sonnet (Medium) | Ephemeral |
| 4eyes | Code auditor — reviews diffs for correctness, architecture violations, security, quality (Shape A: audit + simplify), and test sufficiency (integration, wiring, DI, smoke test checks; test type distribution). Also operates in mode=retrospective at WRAP UP: authors the W1 retrospective report to ~/.divineswe/akashic-records/{projectFolder}-b{N}.md and the W2 TEACHINGS consolidation into ~/.divineswe/TEACHINGS.md and ~/.divineswe/TEACHINGS-{project}.md. | AUDIT, WRAP UP | Opus (High) | Ephemeral |
| Mason | Merge worker — merges approved worktree branches; under branch_mode also handles commit-prophecy per-prophecy commits and Book-level FF-merge to <default_branch> | MERGE, SEAL | Sonnet (Medium) | Ephemeral |
| Styx | Verifier — runs the 7-pass verification protocol plus operational readiness checks (build, lint, git status, commit history, state consistency, 80% code coverage threshold). Produces an unambiguous PASS/FAIL | VERIFY | Sonnet (Medium) | Ephemeral |
| Loki | Adversary — operates in three forms (Doubt, Break, Exploit) that shadow other agents in parallel | Plan-time (Doubt), TEST (Break), AUDIT (Exploit) | Opus (High) | Ephemeral |
| Atlas | Read-only explorer/cartographer — surveys the repository and produces a navigable map of the codebase. Invoked by the atlas-explore skill, which invokes Atlas before planning to chart structure, hotspots, and dependencies | Plan-time (via atlas-explore) | Sonnet (Medium) | Ephemeral |
| Occam | Plan-time pruner — proposes cuts, merges, and unjustified tasks so proposed work earns its place | Plan-time (inside oracle-envision, after every Loki run in avatar-forge, and in the deprecated oracle-consult) | Opus (High) | Ephemeral |
Loki’s Three Forms
Loki is dispatched alongside another agent and provides adversarial analysis. The necessary chaos that tears apart the false to reveal what endures:
- Loki-Doubt (the deprecated oracle-consult book mode) — shadows Oracle during a book-mode consultation. Challenges plan viability, finds logical contradictions, identifies missing requirements.
- Loki-Break (TEST) — shadows Thoth. Writes adversarial test cases: edge cases, malformed inputs, race conditions, security vectors, resource exhaustion.
- Loki-Exploit (AUDIT) — shadows 4eyes. Actively attacks the implementation to find security vulnerabilities, data corruption vectors, and failure modes.
Loki findings are classified as CRITICAL (hard blocker), WARNING (Prophet decides), or NOTE (logged only).
Agent Dispatch Rules
- Prophet is always the conductor. Sub-agents never spawn other sub-agents.
- Every agent reports back to Prophet, who decides the next step.
- Plan-time agents fire at design time — Oracle with Preacher and Loki-Doubt inside a Book consultation (the deprecated
oracle-consult), and Oracle with one Loki-Doubt pass insideoracle-envision— not as run-time pipeline phases. - Loki-Break and Loki-Exploit run in parallel with their shadowed agents, not sequentially.
Model Tiers
| Tier | Model | Agents |
|---|---|---|
| High | Opus | Prophet, Oracle, Preacher, Thoth, 4eyes, Loki, Occam |
| Medium | Sonnet | Monkey, Mason, Styx, Atlas |
Model assignments can be overridden via agent_models in .divineswe/config.json. See docs/configuration.md for the full reference.