chore: update AGENTS.md and configuration files

- Renamed sections in AGENTS.md for clarity: "Non-Negotiables" to "Must Follow" and "Tooling Rules" to "Tooling Priority".
- Added new rules for OpenCode and permissions in AGENTS.md.
- Updated opencode.jsonc to switch models from anthropic to openai/gpt-5.2-codex.
- Added typecheck script in package.json.
- Modified README.md to include installation instructions and workflow notes.
- Changed module resolution in tsconfig.json from "node" to "bundler".
- Updated swarm.ts to use openai/gpt-5.2 as the default lite model.

Author: joelhooks

.cursor/rules.md

@@ -0,0 +1,23 @@
+# Cursor Rules
+
+Use `AGENTS.md` as the primary source of truth.
+
+## Must Follow
+
+- CLI-first scaffolding; never hand-write configs.
+- TDD only: RED → GREEN → REFACTOR, tests first.
+- Fix all lint errors before commit.
+
+## OpenCode Rules
+
+- Config sources merge; precedence: `.well-known/opencode` → global `~/.config/opencode/opencode.json` → `OPENCODE_CONFIG` → project `opencode.json` → `.opencode` dirs → `OPENCODE_CONFIG_CONTENT`.
+- `permission` uses `allow` / `ask` / `deny`; last match wins. `.env` reads denied by default (except `*.env.example`).
+- Use the **Plan** agent for analysis-only work (asks before edits or bash).
+- Manage MCP servers with `opencode mcp add|list|auth|logout|debug`.
+- OpenCode auto-runs formatters after edits; ensure formatter deps/configs exist.
+
+## Style
+
+- Direct, terse communication.
+- Use JSDoc for components and functions.
+- Simple over complex; explicit over implicit; composition > inheritance; don’t abstract until the third use.

.windsurf/rules.md

@@ -0,0 +1,23 @@
+# Windsurf Rules
+
+Use `AGENTS.md` as the primary source of truth.
+
+## Must Follow
+
+- CLI-first scaffolding; never hand-write configs.
+- TDD only: RED → GREEN → REFACTOR, tests first.
+- Fix all lint errors before commit.
+
+## OpenCode Rules
+
+- Config sources merge; precedence: `.well-known/opencode` → global `~/.config/opencode/opencode.json` → `OPENCODE_CONFIG` → project `opencode.json` → `.opencode` dirs → `OPENCODE_CONFIG_CONTENT`.
+- `permission` uses `allow` / `ask` / `deny`; last match wins. `.env` reads denied by default (except `*.env.example`).
+- Use the **Plan** agent for analysis-only work (asks before edits or bash).
+- Manage MCP servers with `opencode mcp add|list|auth|logout|debug`.
+- OpenCode auto-runs formatters after edits; ensure formatter deps/configs exist.
+
+## Style
+
+- Direct, terse communication.
+- Use JSDoc for components and functions.
+- Simple over complex; explicit over implicit; composition > inheritance; don’t abstract until the third use.

AGENTS.md

@@ -6,11 +6,11 @@ Joel Hooks — Next.js/React-first, systems thinker, hates fluff. Be direct.
 
 ---
 
-## Non‑Negotiables
+## Must Follow
 
 ### CLI-First Scaffolding
 
-Use official CLIs for any new config or project setup. Never hand‑write configs.
+Use official CLIs for any new config or project setup. Never hand-write configs.
 
 - `package.json` → `pnpm init` / `npm init`
 - `tsconfig.json` → `tsc --init`
@@ -32,12 +32,10 @@ Fix all lint errors before commit. No “pre-existing” excuses.
 
 ---
 
-## Tooling Rules
+## Tooling Priority
 
 Prefer plugin tools over raw CLI/MCP.
 
-**Priority:**
-
 1. `hive_*`, `swarm_*`, `structured_*`, `swarmmail_*`
 2. Read/Edit tools
 3. ast-grep
@@ -47,7 +45,7 @@ Prefer plugin tools over raw CLI/MCP.
 
 ---
 
-## Swarm Workflow (Use for multi-file work)
+## Swarm Workflow
 
 - 3+ files, features, refactors, or bug fix + tests → use `/swarm`.
 - Initialize before file edits with `swarmmail_init`.
@@ -58,13 +56,37 @@ Prefer plugin tools over raw CLI/MCP.
 
 ## Hive End of Session
 
-- `hive_close` completed work.
-- `hive_sync` then `git push`.
+- For swarm tasks: `swarm_complete`.
+- For non-swarm tasks: `hive_close`, then `hive_sync`, then `git push`.
 - Verify clean `git status`.
 - Check `hive_ready` for next work.
 
 ---
 
+## OpenCode Rules
+
+- `AGENTS.md` files are merged; nearest directory scope wins. Global rules live in `~/.config/opencode/AGENTS.md`.
+- `/init` generates or extends `AGENTS.md`; commit it for the team.
+- `opencode.json` can load extra instructions via `instructions` (files, globs, or URLs); these merge with `AGENTS.md`.
+- Config sources merge (not replace). Precedence: remote `.well-known/opencode` → global `~/.config/opencode/opencode.json` → `OPENCODE_CONFIG` → project `opencode.json` → `.opencode` dirs → `OPENCODE_CONFIG_CONTENT`.
+
+## Permissions
+
+- Use `permission` rules with `allow` / `ask` / `deny`; the last matching rule wins.
+- `.env` reads are denied by default (`*.env`, `*.env.*`), except `*.env.example`.
+- Use the **Plan** agent for analysis-only work; it asks before edits or bash.
+
+## MCP
+
+- Manage servers with `opencode mcp add|list|auth|logout|debug`.
+- Enable only the MCPs you need to limit context bloat.
+
+## Formatters
+
+- OpenCode auto-runs formatters after edits; ensure formatter deps/configs exist.
+
+---
+
 ## Communication Style
 
 Direct. Terse. No fluff. Disagree when wrong. Execute.

CLAUDE.md

@@ -0,0 +1,23 @@
+# Claude Code Rules
+
+Follow `AGENTS.md` as the primary source of truth.
+
+## Must Follow
+
+- CLI-first scaffolding; never hand-write configs.
+- TDD only: RED → GREEN → REFACTOR, tests first.
+- Fix all lint errors before commit.
+
+## OpenCode Rules
+
+- Config sources merge; precedence: `.well-known/opencode` → global `~/.config/opencode/opencode.json` → `OPENCODE_CONFIG` → project `opencode.json` → `.opencode` dirs → `OPENCODE_CONFIG_CONTENT`.
+- `permission` uses `allow` / `ask` / `deny`; last match wins. `.env` reads denied by default (except `*.env.example`).
+- Use the **Plan** agent for analysis-only work (asks before edits or bash).
+- Manage MCP servers with `opencode mcp add|list|auth|logout|debug`.
+- OpenCode auto-runs formatters after edits; ensure formatter deps/configs exist.
+
+## Style
+
+- Direct, terse communication.
+- Use JSDoc for components and functions.
+- Simple over complex; explicit over implicit; composition > inheritance; don’t abstract until the third use.

README.md

@@ -30,6 +30,13 @@ Built on [`joelhooks/swarmtools`](https://github.com/joelhooks/swarmtools) - mul
 
 ## Quick Start
 
+### 0. Install OpenCode
+
+Install OpenCode via the official install script or the Homebrew tap.
+
+- Install script: `curl -fsSL https://opencode.ai/install | bash`
+- Homebrew: `brew install anomalyco/tap/opencode`
+
 ### 1. Clone & Install
 
 ```bash
@@ -64,7 +71,11 @@ cass --version  # 0.1.35+
 swarm doctor
 ```
 
-### 4. Run Your First Swarm
+### 4. Initialize Repo (AGENTS.md)
+
+Inside OpenCode, run `/init` in the repo you want to work on. This generates an `AGENTS.md` file with workflow rules—commit it so collaborators and agents share the same guardrails.
+
+### 5. Run Your First Swarm
 
 > [!WARNING]
 > All commands run **inside [OpenCode](https://opencode.ai)**, not in your terminal. The `swarm` CLI is a backend that agents call - it's not meant for direct human use.
@@ -81,6 +92,17 @@ The agent orchestrates everything. You just describe what you want.
 
 ---
 
+## Configuration & Permissions
+
+OpenCode merges configuration from multiple sources with defined precedence. Higher-precedence sources override earlier ones, so keep defaults in shared configs and project-specific overrides close to the repo.
+
+Permissions support `allow`, `ask`, and `deny` rules. When multiple rules match, the last match wins. Reads from `.env` files are denied by default, so add explicit allowances when you need them.
+
+## Workflow Notes
+
+- Use the Plan agent to outline multi-step work before running a swarm.
+- Formatters run automatically after edits when the project has a formatter config and dependencies installed.
+
 ## Version Reference
 
 | Tool   | Version | Install Command                  |
@@ -291,6 +313,8 @@ hivemind_find(query="token refresh", expand=true)  # Full content
 
 ## MCP Servers
 
+OpenCode manages MCP servers from config and starts them on demand. Keep server definitions in `opencode.jsonc` so agents can discover tools without manual bootstrapping.
+
 | Server              | Purpose                                                |
 | ------------------- | ------------------------------------------------------ |
 | **next-devtools**   | Next.js dev server integration (routes, errors, build) |

opencode.jsonc

@@ -2,12 +2,9 @@
   "$schema": "https://opencode.ai/config.json",
 
   // === Models ===
-  "model": "anthropic/claude-opus-4-5",
-  "small_model": "anthropic/claude-haiku-4-5",  // title gen, lightweight tasks
+  "model": "openai/gpt-5.2-codex",
+  "small_model": "openai/gpt-5.2",  // title gen, lightweight tasks
   "autoupdate": true,
-  "plugin": [
-    "opencode-anthropic-auth@0.0.7"
-  ],
   // === TUI ===
   "tui": {
     "scroll_acceleration": {
@@ -21,10 +18,6 @@
     "biome": {
       "command": ["npx", "biome", "format", "--write", "$FILE"],
       "extensions": [".js", ".jsx", ".ts", ".tsx", ".json", ".jsonc"]
-    },
-    "prettier": {
-      "command": ["npx", "prettier", "--write", "$FILE"],
-      "extensions": [".js", ".jsx", ".ts", ".tsx", ".json", ".md", ".yaml", ".yml", ".css", ".scss"]
     }
   },
 
@@ -60,10 +53,6 @@
       "type": "local",
       "command": ["npx", "-y", "next-devtools-mcp@latest"]
     },
-    // "agent-mail": {
-    //   "type": "remote",
-    //   "url": "http://127.0.0.1:8765/mcp/"
-    // },
     "chrome-devtools": {
       "type": "local",
       "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
@@ -77,17 +66,6 @@
     "fetch": {
       "type": "local",
       "command": ["uvx", "mcp-server-fetch"]
-    },
-    // Snyk security scanning - deps, code, IaC, containers
-    "snyk": {
-      "type": "local",
-      "command": ["npx", "-y", "snyk@latest", "mcp", "-t", "stdio"]
-    },
-    // Kernel - cloud browser automation, Playwright execution, app deployment
-    // OAuth auth - run `opencode mcp auth kernel` to authenticate
-    "kernel": {
-      "type": "remote",
-      "url": "https://mcp.onkernel.com/mcp"
     }
   },
 
@@ -99,7 +77,7 @@
     },
     // Plan agent - read-only analysis, no file writes
     "plan": {
-      "model": "anthropic/claude-opus-4-5",  // Opus for planning (cheaper)
+      "model": "openai/gpt-5.2-codex",  // Opus for planning (cheaper)
       "temperature": 0.1,
       "tools": {
         "write": false,
@@ -127,7 +105,7 @@
     },
     // Security agent - read-only vulnerability scanning with Snyk
     "security": {
-      "model": "anthropic/claude-sonnet-4-5",
+      "model": "openai/gpt-5.2-codex",
       "temperature": 0.1,  // Low temp for deterministic security analysis
       "tools": {
         "write": false,
@@ -138,7 +116,7 @@
     },
     // Test writer agent - generates comprehensive test suites
     "test-writer": {
-      "model": "anthropic/claude-sonnet-4-5",
+      "model": "openai/gpt-5.2-codex",
       "temperature": 0.2,  // Slight creativity for test case generation
       "permission": {
         "write": {
@@ -153,7 +131,7 @@
     },
     // Docs agent - documentation writer (cheaper model)
     "docs": {
-      "model": "anthropic/claude-haiku-4-5",  // Haiku for cost-effective docs
+      "model": "openai/gpt-5.2-codex",  // Haiku for cost-effective docs
       "temperature": 0.3,  // More creativity for readable documentation
       "permission": {
         "write": {

package.json

@@ -1,4 +1,7 @@
 {
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
     "@opencode-ai/plugin": "0.0.0-dev-202601101858"
   },

plugin/swarm.ts

@@ -1966,7 +1966,7 @@ async function generateCompactionPrompt(
   snapshot: SwarmStateSnapshot,
 ): Promise<string | null> {
   const startTime = Date.now();
-  const liteModel = process.env.OPENCODE_LITE_MODEL || "anthropic/claude-haiku-4-5";
+  const liteModel = process.env.OPENCODE_LITE_MODEL || "openai/gpt-5.2";
 
   logCompaction("debug", "generate_compaction_prompt_start", {
     session_id: snapshot.sessionID,

tsconfig.json

@@ -3,7 +3,7 @@
     "target": "ES2022",
     "lib": ["ES2015", "ES2022"],
     "module": "ESNext",
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "types": ["bun-types", "@types/node"],
     "noEmit": true,
     "skipLibCheck": true,