opencode-swarm-plugin 0.30.6 → 0.30.7

package/src/swarm-prompts.ts

@@ -406,21 +406,44 @@ swarm_checkpoint(
 
 **Checkpoints preserve context so you can recover if things go wrong.**
 
-### Step 8: Store Learnings (if you discovered something)
+### Step 8: 💾 STORE YOUR LEARNINGS (if you discovered something)
+
+**If you learned it the hard way, STORE IT so the next agent doesn't have to.**
+
 \`\`\`
 semantic-memory_store(
   information="<what you learned, WHY it matters, how to apply it>",
-  metadata="<tags: domain, tech-stack, pattern-type>"
+  tags="<domain, tech-stack, pattern-type>"
 )
 \`\`\`
 
-**Store:**
-- Tricky bugs you solved (root cause + solution)
-- Project-specific patterns or domain rules
-- Tool/library gotchas and workarounds
-- Failed approaches (anti-patterns to avoid)
+**MANDATORY Storage Triggers - Store when you:**
+- 🐛 **Solved a tricky bug** (>15min debugging) - include root cause + solution
+- 💡 **Discovered a project-specific pattern** - domain rules, business logic quirks
+- ⚠️ **Found a tool/library gotcha** - API quirks, version-specific bugs, workarounds
+- 🚫 **Tried an approach that failed** - anti-patterns to avoid, why it didn't work
+- 🏗️ **Made an architectural decision** - reasoning, alternatives considered, tradeoffs
+
+**What Makes a GOOD Memory:**
 
-**Don't store generic knowledge.** Store the WHY, not just the WHAT.
+✅ **GOOD** (actionable, explains WHY):
+\`\`\`
+"OAuth refresh tokens need 5min buffer before expiry to avoid race conditions.
+Without buffer, token refresh can fail mid-request if expiry happens between
+check and use. Implemented with: if (expiresAt - Date.now() < 300000) refresh()"
+\`\`\`
+
+❌ **BAD** (generic, no context):
+\`\`\`
+"Fixed the auth bug by adding a null check"
+\`\`\`
+
+**What NOT to Store:**
+- Generic knowledge that's in official documentation
+- Implementation details that change frequently
+- Vague descriptions without context ("fixed the thing")
+
+**The WHY matters more than the WHAT.** Future agents need context to apply your learning.
 
 ### Step 9: Complete (REQUIRED - releases reservations)
 \`\`\`
@@ -511,17 +534,20 @@ Other cell operations:
 
 **NON-NEGOTIABLE:**
 1. Step 1 (swarmmail_init) MUST be first - do it before anything else
-2. Step 2 (semantic-memory_find) MUST happen before starting work
+2. 🧠 Step 2 (semantic-memory_find) MUST happen BEFORE starting work - query first, code second
 3. Step 4 (swarmmail_reserve) - YOU reserve files, not coordinator
 4. Step 6 (swarm_progress) - Report at milestones, don't work silently
-5. Step 9 (swarm_complete) - Use this to close, NOT hive_close
+5. 💾 Step 8 (semantic-memory_store) - If you learned something hard, STORE IT
+6. Step 9 (swarm_complete) - Use this to close, NOT hive_close
 
 **If you skip these steps:**
 - Your work won't be tracked (swarm_complete will fail)
-- You'll waste time repeating solved problems (no semantic memory query)
+- 🔄 You'll waste time repeating already-solved problems (no semantic memory query)
 - Edit conflicts with other agents (no file reservation)
 - Lost work if you crash (no checkpoints)
-- Future agents repeat your mistakes (no learnings stored)
+- 🔄 Future agents repeat YOUR mistakes (no learnings stored)
+
+**Memory is the swarm's collective intelligence. Query it. Feed it.**
 
 Begin now.`;
 

package/src/swarm.integration.test.ts

@@ -1426,7 +1426,7 @@ describe("Swarm Prompt V2 (with Swarm Mail/Beads)", () => {
       expect(SUBTASK_PROMPT_V2).toContain("semantic-memory_find");
       expect(SUBTASK_PROMPT_V2).toContain("Query Past Learnings");
       expect(SUBTASK_PROMPT_V2).toContain("BEFORE starting work");
-      expect(SUBTASK_PROMPT_V2).toContain("Past learnings save time");
+      expect(SUBTASK_PROMPT_V2).toContain("If you skip this step, you WILL waste time solving already-solved problems");
     });
 
     it("contains survival checklist: skills discovery and loading", () => {
@@ -1465,9 +1465,9 @@ describe("Swarm Prompt V2 (with Swarm Mail/Beads)", () => {
     it("contains survival checklist: semantic-memory_store for learnings", () => {
       // Step 8: Store discoveries and learnings
       expect(SUBTASK_PROMPT_V2).toContain("semantic-memory_store");
-      expect(SUBTASK_PROMPT_V2).toContain("Store Learnings");
-      expect(SUBTASK_PROMPT_V2).toContain("Tricky bugs you solved");
-      expect(SUBTASK_PROMPT_V2).toContain("Store the WHY, not just the WHAT");
+      expect(SUBTASK_PROMPT_V2).toContain("STORE YOUR LEARNINGS");
+      expect(SUBTASK_PROMPT_V2).toContain("Solved a tricky bug");
+      expect(SUBTASK_PROMPT_V2).toContain("The WHY matters more than the WHAT");
     });
 
     it("does NOT mention coordinator reserving files", () => {