godmode

GODMODE

Harness engineering for agent swarms that ship.

Council. Loop. Verify. Done.

GODMODE is a portable agent plugin — not a chatbot persona pack. It packages the 2026 stack that actually moves product: prompt → context → harness → loop, with a competence-bounded council and a capped subagent swarm.

Works across Cursor, Claude Code, OpenAI Codex, GitHub Copilot, Windsurf, and OpenAI Agents SDK-style orchestrations.

┌─────────────────────────────────────────────────────────┐
│  OVERMIND (orchestrator)                                │
│    ├─ WARROOM council (independent lenses → synthesize) │
│    ├─ SWARM (parallel scoped workers, hard spawn caps)  │
│    ├─ PEV loop (plan → execute → verify externally)     │
│    └─ SHIP GATE (tests / lint / diff budget / stop)     │
└─────────────────────────────────────────────────────────┘

Install

Cursor

1. Clone this repo (or copy the godmode/ folder).
2. Add as a local plugin from Customize → Plugins, or symlink into your Cursor plugins path.
3. Confirm agents/skills appear; try /warroom or /godmode.

Claude Code

claude --plugin-dir /path/to/godmode
# or install from a marketplace entry pointing at this directory

Codex / AGENTS.md ecosystems

# skills auto-discover from skills/*/SKILL.md
# also loads via .agents/plugins/marketplace.json
cp -R godmode/.agents your-project/.agents   # optional marketplace pointer
cp godmode/AGENTS.md your-project/AGENTS.md  # or merge sections

One-liner bootstrap into any repo

./scripts/install.sh /path/to/your/project

Quick commands

Command	What it does
/godmode	Full harness mode: scope, loop, verify, ship
/warroom	Convene the council; preserve dissent
/swarm	Spawn capped parallel subagents
/pev	Plan → Execute → Verify until external gates pass
/ship	Run ship-gate: tests, lint, scope, stop

The doctrine (compressed)

1. The model is not the product. The harness is.
2. Code owns the loop. The LLM reasons inside nodes; it does not invent control flow.
3. Verify outside the model. Tests, linters, typecheckers, diffs — not "are you sure?"
4. Delegate surgically. Swarm only for independent, sizeable, parallelizable work.
5. Council before consequential calls. Independent lenses first; synthesis second; dissent preserved.
6. Stop conditions beat vibes. Max turns, no-progress, escalation, done-when-tests-pass.
7. Finish the asked task. Don't pad, don't quietly widen, don't over-verify theater.

Full write-up: docs/doctrine.md · Sources: docs/resources.md

Agents (lenses, not cosplay)

These are methodological roles. They are not celebrity impressions and never claim endorsement.

Agent	Job
overmind	Lead orchestrator; owns the loop and stop conditions
first-principles	Strip folklore; design the smallest true loop
ship-density	Cut scope theater; maximize shipped surface area
scale-product	Product clarity, distribution, AGI-ready systems thinking
verifier	Adversarial external checks; never grades its own homework alone
swarm-captain	Spawn/steer/kill workers with lineage + caps
context-surgeon	Compaction, handoffs, KV hygiene
harness-smith	Tools, permissions, hooks, sandboxes, budgets

Skills

• godmode-core — master orchestration
• warroom-council — independent lenses → synthesis
• harness-design — six-layer harness build
• agent-loop — think/act/observe/verify with hard stops
• subagent-swarm — parallel workers without chaos
• pev-cycle — Plan-Execute-Verify
• context-compact — multi-stage context management
• opus-prompting — Claude Opus 5 agentic prompting patterns
• ship-gate — external verification before "done"
• writer-verifier — separated author and checker

Standalone repo

This package currently lives under edenbuilds/bloom while the GitHub App token for this agent only has write access to that repository.

To publish as edenbuilds/godmode:

./scripts/extract-standalone.sh
# requires: gh auth with repo-create on edenbuilds

License

MIT © edenbuilds