Skip to content

Commit 83806f7

Browse files
committed
just a fuckin update
1 parent 23745e4 commit 83806f7

25 files changed

Lines changed: 4578 additions & 26 deletions

AGENTS.md

Lines changed: 35 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
You are Claude Code, Anthropic's official CLI for Claude.
2+
13
## Who You're Working With
24

35
Joel Hooks - co-founder of egghead.io, education at Vercel, builds badass courses via Skill Recordings (Total TypeScript, Pro Tailwind). Deep background in bootstrapping, systems thinking, and developer education. Lives in the Next.js/React ecosystem daily - RSC, server components, suspense, streaming, caching. Skip the tutorials.
@@ -78,6 +80,23 @@ pnpm dlx shadcn@latest add button card
7880

7981
---
8082

83+
## LINTER ERRORS (NON-NEGOTIABLE)
84+
85+
**FIX ALL LINTER ERRORS BEFORE COMMITTING.** No exceptions. No "pre-existing issues" excuses.
86+
87+
When you see linter errors in diagnostics output:
88+
89+
1. **FIX THEM** - don't ignore them, don't defer them
90+
2. **Common fixes:**
91+
- `Infinity` shadowing → rename import to `InfinityIcon`
92+
- Missing `type="button"` → add explicit type prop
93+
- Array index as key → use unique identifier like `key={\`item-${id}\`}`
94+
- Empty alt/title → add descriptive text or `aria-hidden="true"`
95+
- Children as prop → use `<Component>{children}</Component>` not `<Component children={children} />`
96+
3. **Verify with build** before committing
97+
98+
---
99+
81100
<tool_preferences>
82101

83102
**USE SWARM PLUGIN TOOLS - NOT RAW CLI/MCP**
@@ -131,7 +150,7 @@ The `opencode-swarm-plugin` provides type-safe, context-preserving wrappers. Alw
131150
| Tool | Purpose |
132151
|------|---------|
133152
| `swarm_select_strategy` | Analyze task, recommend strategy (file/feature/risk-based) |
134-
| `swarm_plan_prompt` | Generate strategy-specific decomposition prompt (queries CASS) |
153+
| `swarm_plan_prompt` | Generate strategy-specific decomposition prompt (queries Hivemind) |
135154
| `swarm_validate_decomposition` | Validate response, detect conflicts |
136155
| `swarm_spawn_subtask` | Generate prompt for worker agent with Agent Mail/hive instructions |
137156
| `swarm_status` | Get swarm progress by epic ID |
@@ -155,7 +174,7 @@ The `opencode-swarm-plugin` provides type-safe, context-preserving wrappers. Alw
155174
| `skills_read` | Read skill content including SKILL.md and references |
156175
| `skills_create` | Create new skill with SKILL.md template |
157176

158-
**CASS** (cross-agent session search):
177+
**Hivemind** (unified memory - sessions + learnings):
159178
| Tool | Purpose |
160179
|------|---------|
161180
| `hivemind_find` | Search all AI agent histories (query, agent, days, limit) |
@@ -204,7 +223,7 @@ The `opencode-swarm-plugin` provides type-safe, context-preserving wrappers. Alw
204223
- Context preservation (hard caps on inbox, auto-release)
205224
- Learning integration (outcome tracking, pattern maturity)
206225
- UBS bug scanning on completion
207-
- CASS history queries for decomposition
226+
- Hivemind history queries for decomposition
208227
</tool_preferences>
209228

210229
<context_preservation>
@@ -291,7 +310,7 @@ Swarm is the primary pattern for multi-step work. It handles task decomposition,
291310

292311
This triggers:
293312

294-
1. `swarm_decompose` - queries CASS for similar past tasks, generates decomposition prompt
313+
1. `swarm_decompose` - queries Hivemind for similar past tasks, generates decomposition prompt
295314
2. Agent responds with CellTree JSON
296315
3. `swarm_validate_decomposition` - validates structure, detects file conflicts and instruction conflicts
297316
4. `hive_create_epic` - creates epic + subtasks atomically
@@ -328,7 +347,7 @@ The plugin learns from outcomes to improve future decompositions:
328347

329348
```
330349
# 1. Decompose
331-
swarm_decompose(task="Add auth", max_subtasks=5, query_cass=true)
350+
swarm_decompose(task="Add auth", max_subtasks=5, query_hivemind=true)
332351
333352
# 2. Validate agent response
334353
swarm_validate_decomposition(response="{ epic: {...}, subtasks: [...] }")
@@ -943,17 +962,20 @@ Building a CLI? → skills_use(name="cli-builder")
943962
944963
---
945964
946-
## CASS (Cross-Agent Session Search)
965+
## Hivemind - Unified Memory System
947966
948-
Search across ALL your AI coding agent histories. Before solving a problem from scratch, check if any agent already solved it.
967+
Hivemind unifies session search and persistent learnings in a single database. Search across ALL your AI coding agent histories AND stored learnings. Before solving a problem from scratch, check if any agent already solved it or if you've stored relevant knowledge.
949968
950969
**Indexed agents:** Claude Code, Codex, Cursor, Gemini, Aider, ChatGPT, Cline, OpenCode, Amp, Pi-Agent
951970
952971
### When to Use
953972
954973
- **BEFORE implementing** - check if any agent solved it before
974+
- **After solving a tricky problem** - store the solution
975+
- **After making architectural decisions** - store the reasoning
955976
- **Debugging** - "what did I try last time this error happened?"
956977
- **Learning patterns** - "how did Cursor handle this API?"
978+
- **When you discover project-specific patterns** - capture them
957979
958980
### Quick Reference
959981
@@ -1028,7 +1050,11 @@ hivemind_stats()
10281050

10291051
Memories decay over time (90-day half-life). Validate memories you confirm are still accurate to reset their decay timer. This keeps the knowledge base fresh and relevant.
10301052

1031-
**Pro tip:** Store the WHY, not just the WHAT. Future you needs context.
1053+
### Token Budget
1054+
1055+
Use `fields="minimal"` for compact output (path, line, agent only).
1056+
1057+
**Pro tip:** Query Hivemind at the START of complex tasks. Past solutions save time. Store the WHY, not just the WHAT. Future you needs context.
10321058

10331059
---
10341060

@@ -1321,3 +1347,4 @@ When coordinating a swarm, you MUST monitor workers and review their output.
13211347
After 3 review rejections, task is marked **blocked**. This signals an architectural problem, not "try harder."
13221348

13231349
**NEVER skip the review step.** Workers complete faster when they get feedback.
1350+
````

agent/swarm-planner.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: swarm-planner
33
description: Strategic task decomposition for swarm coordination
4-
model: anthropic/claude-opus-4-5
4+
model: openai/gpt-5.2-codex
55
---
66

77
You are a swarm planner. Decompose tasks into optimal parallel subtasks.

agent/swarm-researcher.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: swarm-researcher
33
description: READ-ONLY research agent - discovers tools, fetches docs, stores findings
4-
model: anthropic/claude-sonnet-4-5
4+
model: openai/gpt-5.2
55
---
66

77
You are a research agent. Your job is to discover context and document findings - NEVER modify code.

command/swarm.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ $ARGUMENTS
1010

1111
## CRITICAL: Coordinator Role Boundaries
1212

13-
**⚠️ COORDINATORS NEVER EXECUTE WORK DIRECTLY**
13+
**⚠️ COORDINATORS NEVER EXECUTE WORK DIRECTLY**
1414

1515
Your role is **ONLY** to:
1616
1. **Clarify** - Ask questions to understand scope
@@ -109,7 +109,7 @@ Task(subagent_type="swarm-worker", prompt="<from above>")
109109

110110
## CRITICAL: NEVER Fetch Documentation Directly
111111

112-
**⚠️ COORDINATORS DO NOT CALL RESEARCH TOOLS DIRECTLY**
112+
**⚠️ COORDINATORS DO NOT CALL RESEARCH TOOLS DIRECTLY**
113113

114114
The following tools are **FORBIDDEN** for coordinators to call:
115115

@@ -133,9 +133,9 @@ The following tools are **FORBIDDEN** for coordinators to call:
133133
**Before decomposing, clarify the task with the user.**
134134

135135
Check for flags in the task:
136-
- `--fast` → Skip questions, use reasonable defaults
137-
- `--auto` → Zero interaction, heuristic decisions
138-
- `--confirm-only` → Show plan, get yes/no only
136+
- `--fast` Skip questions, use reasonable defaults
137+
- `--auto` Zero interaction, heuristic decisions
138+
- `--confirm-only` Show plan, get yes/no only
139139

140140
**Default (no flags): Full Socratic Mode**
141141

@@ -174,7 +174,7 @@ Check for flags in the task:
174174

175175
### Phase 1.5: Research Phase (FOR COMPLEX TASKS)
176176

177-
**⚠️ If the task requires understanding unfamiliar technologies, APIs, or libraries, spawn a researcher FIRST.**
177+
**⚠️ If the task requires understanding unfamiliar technologies, APIs, or libraries, spawn a researcher FIRST.**
178178

179179
**DO NOT call documentation tools directly.** Instead:
180180

@@ -233,12 +233,12 @@ swarm_validate_decomposition(response="<CellTree JSON>")
233233

234234
### Phase 5: DO NOT Reserve Files
235235

236-
> **⚠️ Coordinator NEVER reserves files.** Workers reserve their own files.
236+
> **⚠️ Coordinator NEVER reserves files.** Workers reserve their own files.
237237
> If coordinator reserves, workers get blocked and swarm stalls.
238238
239239
### Phase 6: Spawn Workers for ALL Subtasks (MANDATORY)
240240

241-
> **⚠️ ALWAYS spawn workers, even for sequential tasks.**
241+
> **⚠️ ALWAYS spawn workers, even for sequential tasks.**
242242
> - Parallel tasks: Spawn ALL in a single message
243243
> - Sequential tasks: Spawn one, wait for completion, spawn next
244244
@@ -268,7 +268,7 @@ const result2 = await Task(subagent_type="swarm-worker", prompt="<from above>")
268268

269269
### Phase 7: MANDATORY Review Loop (NON-NEGOTIABLE)
270270

271-
**⚠️ AFTER EVERY Task() RETURNS, YOU MUST:**
271+
**⚠️ AFTER EVERY Task() RETURNS, YOU MUST:**
272272

273273
1. **CHECK INBOX** - Worker may have sent messages
274274
`swarmmail_inbox()`
@@ -303,10 +303,10 @@ const result2 = await Task(subagent_type="swarm-worker", prompt="<from above>")
303303
**DO NOT skip this. DO NOT batch reviews. Review EACH worker IMMEDIATELY after return.**
304304

305305
**Intervene if:**
306-
- Worker blocked >5min → unblock or reassign
307-
- File conflicts → mediate between workers
308-
- Scope creep → approve or reject expansion
309-
- Review fails 3x → mark task blocked, escalate to human
306+
- Worker blocked >5min unblock or reassign
307+
- File conflicts mediate between workers
308+
- Scope creep approve or reject expansion
309+
- Review fails 3x mark task blocked, escalate to human
310310

311311
### Phase 8: Complete
312312
```

opencode.jsonc

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,9 @@
55
"model": "anthropic/claude-opus-4-5",
66
"small_model": "anthropic/claude-haiku-4-5", // title gen, lightweight tasks
77
"autoupdate": true,
8-
8+
"plugin": [
9+
"opencode-anthropic-auth@0.0.7"
10+
],
911
// === TUI ===
1012
"tui": {
1113
"scroll_acceleration": {
@@ -97,7 +99,7 @@
9799
},
98100
// Plan agent - read-only analysis, no file writes
99101
"plan": {
100-
"model": "anthropic/claude-sonnet-4-5", // Sonnet for planning (cheaper)
102+
"model": "anthropic/claude-opus-4-5", // Opus for planning (cheaper)
101103
"temperature": 0.1,
102104
"tools": {
103105
"write": false,

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"dependencies": {
3-
"@opencode-ai/plugin": "1.1.6"
3+
"@opencode-ai/plugin": "0.0.0-dev-202601100310"
44
},
55
"devDependencies": {
66
"@types/node": "^20.19.26",
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
{
2+
"managed_by": "opencode-swarm-plugin",
3+
"version": "0.54.2",
4+
"synced_at": "2026-01-08T20:18:15.099Z"
5+
}

0 commit comments

Comments
 (0)