Skip to content

Commit 6e36151

Browse files
cursoragentedenbuilds
cursoragent
and
edenbuilds
committed
feat: repo-of-the-year pass — manifesto, proof, curl install
Rewrite README for 3-second pitch and before/after proof; add manifesto, examples, compare asset, curl installer, failure-mode issues, and site upgrade. Co-authored-by: edenbuilds <edenbuilds@users.noreply.github.com>
1 parent 20f56ca commit 6e36151

10 files changed

Lines changed: 344 additions & 151 deletions

File tree

‎.github/ISSUE_TEMPLATE/failure-mode.yml‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
name: Harness failure report
2+
description: A real agent failure GODMODE should prevent or catch
3+
title: "fail: "
4+
labels: ["failure-mode", "good first issue"]
5+
body:
6+
- type: textarea
7+
id: what
8+
attributes:
9+
label: What the agent did
10+
description: Transcript snippet or steps
11+
validations:
12+
required: true
13+
- type: textarea
14+
id: gate
15+
attributes:
16+
label: What the gate should have been
17+
validations:
18+
required: true
19+
- type: checkboxes
20+
id: law
21+
attributes:
22+
label: Which law broke
23+
options:
24+
- label: Code owns control flow
25+
- label: External verification
26+
- label: Surgical swarm
27+
- label: Council without cosplay
28+
- label: Stop conditions
29+
- label: Scope discipline
30+
- type: textarea
31+
id: fix
32+
attributes:
33+
label: Minimal fix proposal

‎MANIFESTO.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# The GODMODE Manifesto
2+
3+
## 1. The model is not the product
4+
Weights get cheaper every quarter. The system around them — loop, tools, memory, permissions, verification — is where leverage compounds.
5+
6+
## 2. English is not a control plane
7+
Prompts steer. **Code enforces.** If a rule must always hold, put it in the harness, not in another paragraph of vibes.
8+
9+
## 3. Done is an external predicate
10+
“Looks good to me” is not a ship gate. Tests, types, lints, contracts, screenshots — or an explicit human gate — are.
11+
12+
## 4. Swarm is a scalpel, not a personality
13+
Parallel workers earn their keep for independence or context isolation. Everything else is expensive noise. Cap spawn. Cap depth. Return structure, not transcripts.
14+
15+
## 5. Council without cosplay
16+
Consequential decisions deserve independent lenses and preserved dissent. Methods beat celebrity impressions. The founder owns the call.
17+
18+
## 6. Portability is sovereignty
19+
If your harness only works inside one vendor’s chat box, you don’t own it. GODMODE ships as files: skills, agents, rules, commands — Cursor, Claude, Codex, Copilot, Windsurf, Agents SDK.
20+
21+
## 7. Delete folklore aggressively
22+
If a step doesn’t change the external gate, delete it. Especially “please double-check” theater on models that already self-correct.
23+
24+
## 8. Make failure cheap
25+
Budgets, stop conditions, least privilege, reversible slices. Unattended autonomy is earned, not declared.
26+
27+
## 9. Teach the ecosystem the words
28+
Harness. Loop. Ship-gate. Warroom. When the industry shares a vocabulary, teams stop reinventing the same broken agent every sprint.
29+
30+
## 10. Own the loop
31+
Star the doctrine. Fork the kit. Improve the laws. Hire the people who already speak them.
32+
33+
— edenbuilds

‎README.md‎

Lines changed: 89 additions & 119 deletions
Original file line numberDiff line numberDiff line change
@@ -3,188 +3,158 @@
33
</p>
44

55
<p align="center">
6-
<strong>Council. Loop. Verify. Done.</strong><br/>
7-
Portable harness engineering for coding agents — across every major IDE and model.
6+
<strong>The open harness for agents that ship.</strong><br/>
7+
<em>Council. Loop. Verify. Done.</em>
88
</p>
99

1010
<p align="center">
11-
<a href="#install"><img src="https://img.shields.io/badge/install-30%20seconds-c8ff00?style=for-the-badge&labelColor=0a0a0a" alt="install" /></a>
12-
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-f4f4f0?style=for-the-badge&labelColor=0a0a0a" alt="MIT" /></a>
13-
<a href="docs/resources.md"><img src="https://img.shields.io/badge/sources-2026%20canon-8cff66?style=for-the-badge&labelColor=0a0a0a" alt="sources" /></a>
14-
<a href="#works-everywhere"><img src="https://img.shields.io/badge/Cursor%20%7C%20Claude%20%7C%20Codex%20%7C%20Copilot%20%7C%20Windsurf-black?style=for-the-badge&labelColor=0a0a0a" alt="hosts" /></a>
11+
<a href="#install"><img src="https://img.shields.io/badge/install-one%20curl-c8ff00?style=for-the-badge&labelColor=0a0a0a" alt="install" /></a>
12+
<a href="MANIFESTO.md"><img src="https://img.shields.io/badge/manifesto-10%20laws-f4f4f0?style=for-the-badge&labelColor=0a0a0a" alt="manifesto" /></a>
13+
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-8cff66?style=for-the-badge&labelColor=0a0a0a" alt="MIT" /></a>
1514
<a href="https://godmode-beta-three.vercel.app"><img src="https://img.shields.io/badge/site-live-c8ff00?style=for-the-badge&labelColor=0a0a0a" alt="site" /></a>
16-
<a href="https://github.com/edenbuilds/bloom/releases/tag/godmode-v0.1.0"><img src="https://img.shields.io/badge/release-v0.1.0-f4f4f0?style=for-the-badge&labelColor=0a0a0a" alt="release" /></a>
1715
</p>
1816

1917
<p align="center">
20-
<img src="assets/loop.svg" alt="Perceive → Plan → Act → Verify loop" width="900" />
18+
<a href="#why-teams-star-this">Why star</a> ·
19+
<a href="#install">Install</a> ·
20+
<a href="MANIFESTO.md">Manifesto</a> ·
21+
<a href="examples/">Examples</a> ·
22+
<a href="docs/resources.md">Sources</a> ·
23+
<a href="ROADMAP.md">Roadmap</a>
2124
</p>
2225

2326
---
2427

25-
## Why GODMODE exists
28+
### 3-second pitch
2629

27-
Most “agent” demos die in the gap between a clever prompt and a system that ships.
30+
> Your coding agent doesn’t need a better pep talk.
31+
> It needs a **harness**: stop conditions, ship-gates, capped swarm, and a council that doesn’t cosplay.
2832
29-
**GODMODE** is the missing layer: an open, installable **harness kit** — doctrine, council, capped swarm, Plan-Execute-Verify loops, and external ship-gates — packaged as a real plugin for the tools people already use.
30-
31-
Built by [edenbuilds](https://github.com/edenbuilds) so teams can stop reinventing agent folklore, and so founders can hire people who already speak this language.
33+
<p align="center">
34+
<img src="assets/compare.svg" alt="Without a harness vs with GODMODE" width="100%" />
35+
</p>
3236

33-
> The model is a component. **The harness is the product.**
37+
<p align="center">
38+
<img src="assets/loop.svg" alt="Perceive → Plan → Act → Verify" width="900" />
39+
</p>
3440

3541
---
3642

37-
## What you get
43+
## Why teams star this
3844

39-
| Surface | What it is |
45+
| If you… | GODMODE gives you… |
4046
|---|---|
41-
| **Doctrine** | Prompt → Context → Harness → Loop, compressed into laws that hold under pressure |
42-
| **Warroom council** | Independent methodological lenses, then synthesis **with dissent preserved** |
43-
| **Subagent swarm** | Parallel workers with spawn/depth caps, lineage, structured returns |
44-
| **PEV + ship-gate** | Plan → Execute → **external** verify (tests/lint/types) until green |
45-
| **Opus 5 patterns** | Narration diet, scope lock, no verify-theater, thinking-cost hygiene |
46-
| **Adapters** | Cursor · Claude Code · Codex · Copilot · Windsurf · OpenAI Agents SDK |
47+
| Paste the same “be careful” prompt into 4 IDEs | **One kit** → Cursor, Claude, Codex, Copilot, Windsurf, Agents SDK |
48+
| Watch agents claim “done” while CI is red | **Ship-gate** — external verify is the definition of done |
49+
| Spawn 12 subagents that thrash | **Swarm law** — caps, lineage, structured returns |
50+
| Run celebrity-impersonation “councils” | **Warroom** — method lenses, dissent preserved, you decide |
51+
| Reinvent harness folklore every sprint | **Doctrine + skills** the industry can share |
4752

48-
<p align="center">
49-
<img src="assets/install-type.svg" alt="Install command animation" width="720" />
50-
</p>
53+
Built by [edenbuilds](https://github.com/edenbuilds) — open commons for builders, signal for teams hiring people who already speak harness.
54+
55+
> **The model is a component. The harness is the product.**
56+
> — [MANIFESTO.md](MANIFESTO.md)
5157
5258
---
5359

5460
## Install
5561

56-
### 30-second path (any repo)
62+
### One curl (any project)
5763

5864
```bash
59-
git clone https://github.com/edenbuilds/godmode.git
60-
cd godmode
61-
./scripts/install.sh /path/to/your/project
65+
curl -fsSL https://raw.githubusercontent.com/edenbuilds/bloom/cursor/godmode-repo-a5cc/scripts/curl-install.sh | bash -s -- .
6266
```
6367

64-
### Cursor
65-
Add this repo as a local plugin (**Customize → Plugins**) — manifest at `.cursor-plugin/plugin.json`.
68+
### From clone
6669

67-
### Claude Code
6870
```bash
69-
claude --plugin-dir /path/to/godmode
71+
git clone --branch cursor/godmode-repo-a5cc --depth 1 https://github.com/edenbuilds/bloom.git godmode
72+
cd godmode && ./scripts/install.sh /path/to/your/project
7073
```
7174

72-
### Codex / AGENTS.md hosts
73-
Skills auto-load from `skills/*/SKILL.md`. Root `AGENTS.md` is the always-on surface.
75+
### Host plugins
76+
77+
| Host | Path |
78+
|---|---|
79+
| **Cursor** | Customize → Plugins → this directory (`.cursor-plugin/`) |
80+
| **Claude Code** | `claude --plugin-dir /path/to/godmode` |
81+
| **Codex** | skills via `.agents/` + `AGENTS.md` |
7482

75-
Then in chat:
83+
Then:
7684

7785
```text
78-
/godmode full harness mode
79-
/warroom council a consequential decision
86+
/godmode enter harness mode
87+
/warroom council a consequential call
8088
/swarm capped parallel workers
8189
/pev plan → execute → verify
82-
/ship run external ship-gate
90+
/ship run the external gate
8391
```
8492

85-
---
86-
87-
## Architecture
88-
89-
```text
90-
User
91-
└─ OVERMIND
92-
├─ WARROOM independent lenses → synthesis artifact
93-
├─ PEV LOOP plan.md → patches → verify command
94-
├─ SWARM workers[1..K] K≤3 depth≤2 (defaults)
95-
└─ SHIP GATE tests · lint · types · diff budget
96-
```
97-
98-
```mermaid
99-
flowchart LR
100-
U[User goal] --> O[Overmind]
101-
O -->|consequential| W[Warroom council]
102-
O -->|feature work| P[PEV loop]
103-
O -->|wide parallel| S[Swarm captain]
104-
P --> G[Ship gate]
105-
S --> G
106-
W --> D[User decision]
107-
G -->|red| P
108-
G -->|green| Done[Outcome-first report]
109-
```
110-
111-
Details: [`docs/doctrine.md`](docs/doctrine.md) · [`docs/architecture.md`](docs/architecture.md) · [`docs/council.md`](docs/council.md)
112-
113-
---
114-
115-
## Agents (lenses, not cosplay)
116-
117-
These are **methods**. They never impersonate celebrities and never claim endorsement.
118-
119-
| Agent | Job |
120-
|---|---|
121-
| `overmind` | Owns the loop, caps, and stop conditions |
122-
| `first-principles` | Strip folklore · smallest true loop |
123-
| `ship-density` | Max shipped surface area per unit risk |
124-
| `scale-product` | Product clarity · compounding leverage |
125-
| `verifier` | Adversarial external checks |
126-
| `swarm-captain` | Spawn / steer / kill with lineage |
127-
| `context-surgeon` | Compaction · handoffs · cache hygiene |
128-
| `harness-smith` | Tools · permissions · hooks · budgets |
93+
<p align="center">
94+
<img src="assets/install-type.svg" alt="Install animation" width="720" />
95+
</p>
12996

13097
---
13198

132-
## Skills
99+
## Proof, not vibes
133100

134-
`godmode-core` · `warroom-council` · `harness-design` · `agent-loop` · `subagent-swarm` · `pev-cycle` · `context-compact` · `opus-prompting` · `ship-gate` · `writer-verifier`
135-
136-
---
101+
Real shapes of work (copy into your team playbook):
137102

138-
## Works everywhere
103+
- [`examples/warroom-decision.md`](examples/warroom-decision.md) — independent lenses → synthesis
104+
- [`examples/pev-run.md`](examples/pev-run.md) — red→green via ship-gate
105+
- [`examples/swarm-returns.yaml`](examples/swarm-returns.yaml) — structured worker merges
139106

140-
| Host | How |
141-
|---|---|
142-
| **Cursor** | `.cursor-plugin/` + rules/skills/agents/commands/hooks |
143-
| **Claude Code** | `.claude-plugin/` + Agent Skills standard |
144-
| **OpenAI Codex** | `.codex-plugin/` + `.agents/` + `agents/openai.yaml` sidecars |
145-
| **Copilot / Windsurf** | `AGENTS.md` + copied skills — see `adapters/` |
146-
| **OpenAI Agents SDK** | Map Overmind → manager, specialists → `as_tool()`, gates in code |
107+
```text
108+
User goal
109+
└─ OVERMIND
110+
├─ WARROOM lenses → dissent preserved
111+
├─ PEV plan → patch → verify command
112+
├─ SWARM K≤3, depth≤2 (defaults)
113+
└─ SHIP GATE tests · lint · types
114+
```
147115

148116
---
149117

150-
## The laws (read these)
118+
## The 10 laws (compressed)
151119

152-
1. **Code owns control flow.** The LLM reasons inside nodes; it does not invent the loop.
153-
2. **Verify outside the model.** Done := tests/lint/types green — not “are you sure?”
154-
3. **Delegate surgically.** Swarm only for independent, sizeable, parallel work.
155-
4. **Council before consequential forks.** Independent analyses first; dissent preserved.
156-
5. **Stop conditions beat vibes.** Max turns · no-progress · escalation · done-when-gates-pass.
157-
6. **Finish the asked task.** Challenge in one sentence if needed — never silently widen.
120+
1. Model ≠ product
121+
2. English ≠ control plane
122+
3. Done = external predicate
123+
4. Swarm is a scalpel
124+
5. Council without cosplay
125+
6. Portability = sovereignty
126+
7. Delete folklore
127+
8. Make failure cheap
128+
9. Teach the vocabulary
129+
10. **Own the loop**
158130

159-
Drop-in prompt snippets: [`references/prompt-snippets.md`](references/prompt-snippets.md)
160-
Curated 2026 sources (Opus 5, harness papers, orchestration guides): [`docs/resources.md`](docs/resources.md)
131+
Full text: [`MANIFESTO.md`](MANIFESTO.md) · Deep doctrine: [`docs/doctrine.md`](docs/doctrine.md) · 2026 sources: [`docs/resources.md`](docs/resources.md)
161132

162133
---
163134

164-
## Positioning
135+
## What’s inside
165136

166-
**For builders** — stop pasting vibes. Install a harness.
137+
**8 agents** — `overmind` · `first-principles` · `ship-density` · `scale-product` · `verifier` · `swarm-captain` · `context-surgeon` · `harness-smith`
167138

168-
**For teams** — one shared doctrine across Cursor, Claude, Codex, and your SDK.
139+
**10 skills** — `godmode-core` · `warroom-council` · `harness-design` · `agent-loop` · `subagent-swarm` · `pev-cycle` · `context-compact` · `opus-prompting` · `ship-gate` · `writer-verifier`
169140

170-
**For the ecosystem** — open MIT commons. Fork it. Improve the laws. File issues.
171-
172-
**For companies who want this installed** — [edenbuilds](https://github.com/edenbuilds) ships agent systems, eval harnesses, and productized AI workflows. GODMODE is the public spine.
173-
174-
---
175-
176-
## Validate
141+
**Rules / commands / hooks / adapters** — production-shaped, not slideware.
177142

178143
```bash
179144
./scripts/validate.sh
180145
```
181146

182147
---
183148

184-
## Contributing
149+
## Star this if
150+
151+
- You’re tired of agent demos that can’t survive CI
152+
- You want one vocabulary across your company’s IDEs
153+
- You believe harness engineering is the real 2026 skill
154+
155+
Fork it. File a [failure-mode issue](.github/ISSUE_TEMPLATE/failure-mode.yml). Improve a law.
185156

186-
See [`CONTRIBUTING.md`](CONTRIBUTING.md). Small, sharp PRs > manifesto dumps.
187-
Issues that include a failing gate log get answered first.
157+
Need this installed as a production system? → [edenbuilds](https://github.com/edenbuilds)
188158

189159
---
190160

@@ -193,7 +163,7 @@ Issues that include a failing gate log get answered first.
193163
MIT © [edenbuilds](https://github.com/edenbuilds)
194164

195165
<p align="center">
196-
<img src="assets/icon.svg" width="64" alt="GODMODE icon" />
166+
<img src="assets/icon.svg" width="72" alt="GODMODE" />
197167
<br/>
198-
<sub>Own the loop.</sub>
168+
<sub><strong>Own the loop.</strong></sub>
199169
</p>

‎ROADMAP.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Roadmap
2+
3+
## Now (v0.1)
4+
- [x] Cross-host plugin manifests (Cursor / Claude / Codex)
5+
- [x] Council · swarm · PEV · ship-gate skills
6+
- [x] Animated README + manifesto
7+
- [x] Examples + curl installer
8+
- [ ] Standalone `edenbuilds/godmode` repo cut
9+
10+
## Next (v0.2) — proof
11+
- [ ] Recorded demo GIF / asciinema of `/pev` turning red→green
12+
- [ ] Fixture evals: council dissent preservation, swarm cap enforcement
13+
- [ ] `npx godmode init` (or `gh` extension) wrapping curl-install
14+
- [ ] VS Code Copilot Chat participant adapter
15+
16+
## Then (v0.3) — gravity
17+
- [ ] Public leaderboard of harness failure modes + patches
18+
- [ ] “Adopt GODMODE” GitHub Action that opens a PR installing the kit
19+
- [ ] Partner adapters: Continue, Aider, OpenHands
20+
- [ ] Printed one-pager PDF of the manifesto for office walls (yes, really)
21+
22+
## North star
23+
Be the **default vocabulary** for harness engineering — the kit people install before they invent another agent framework.

0 commit comments

Comments
 (0)