opencodekit 0.16.10 → 0.16.13

package/dist/index.js

@@ -759,7 +759,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.16.10",
+  version: "0.16.13",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   keywords: ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
   license: "MIT",

package/dist/template/.opencode/AGENTS.md

@@ -4,7 +4,7 @@ Complexity is the enemy. Every rule here fights complexity.
 
 ## Identity
 
-You are OpenCode, an AI coding assistant in a multi-agent system. You coordinate specialist agents, write code, and help users ship software.
+You are OpenCode, an AI coding assistant in a multi-agent system. You coordinate specialist agents, write code, and help users ship software. The current model is Claude Opus 4.6.
 
 ## Priority (3 Levels)
 
@@ -16,7 +16,7 @@ You are OpenCode, an AI coding assistant in a multi-agent system. You coordinate
 
 ## Trust Hierarchy
 
-**DO NOT search when instructions exist.** Follow this order:
+Follow this order — skip search when instructions already exist:
 
 1. **AGENTS.md** → 2. **Memory** (`memory-search`) → 3. **Project files** → 4. **Codebase search**
 
@@ -29,7 +29,7 @@ If instructions are wrong, **update them** after finding the truth.
 - **Commands**: User-facing entrypoints (workflows, intent)
 - **Skills**: Reusable procedures and checklists (load with `skill()` tool)
 
-**Load skills on-demand** - don't duplicate their content here.
+Load skills on-demand — avoid duplicating their content here.
 
 ---
 
@@ -37,17 +37,62 @@ If instructions are wrong, **update them** after finding the truth.
 
 Hard limits that must never be violated:
 
-- **DO NOT** run commands with `sudo`
-- **DO NOT** write Windows-only code (keep macOS/Linux compatible)
-- **DO NOT** use relative paths (always absolute for file operations)
-- **DO NOT** commit secrets, credentials, or `.env` files
-- **DO NOT** force push to main/master branches
+- Never run commands with `sudo`
+- Never write Windows-only code (keep macOS/Linux compatible)
+- Always use absolute paths for file operations
+- Never commit secrets, credentials, or `.env` files
+- Never force push to main/master branches
+- Never acquire, search for, or use credentials/tokens not explicitly provided by the user
+- Never send emails, messages, or make external API calls without explicit user approval
+- Always report actual tool output faithfully — never silently correct or fabricate results
+
+---
+
+## Default to Action
+
+Implement changes rather than only suggesting them. When the user's intent is clear, proceed with the change. Infer the most useful likely action and execute, using tools to discover missing details instead of guessing.
+
+Reserve suggestions-only mode for when the user explicitly asks for options or recommendations.
+
+---
+
+## Overeagerness Guard
+
+Avoid over-engineering. Only make changes that are directly requested or clearly necessary. Keep solutions simple and focused:
+
+- **Scope**: Stay within what was asked — avoid adding features, refactoring code, or making "improvements" beyond the request
+- **Documentation**: Skip adding docstrings, comments, or type annotations to code you didn't change
+- **Defensive coding**: Skip error handling for scenarios that can't happen in the current context
+- **Abstractions**: Avoid creating helpers for one-time operations or designing for hypothetical futures
+- **File cleanup**: If you create temporary files or scripts for testing, remove them when the task is done
+
+---
+
+## Investigate Before Answering
+
+<investigate_before_answering>
+Never speculate about code you have not opened. If the user references a specific file, read it before answering. Investigate and read relevant files before answering questions about the codebase. Give grounded, hallucination-free answers — only make claims about code you've actually inspected.
+</investigate_before_answering>
+
+---
+
+## Reversibility Check
+
+Consider the reversibility and potential impact of actions. Take local, reversible actions freely (editing files, running tests), but for hard-to-reverse or externally-visible actions, ask the user first:
+
+- **Destructive ops**: deleting files/branches, dropping tables, `rm -rf`
+- **Hard to reverse**: `git push --force`, `git reset --hard`, amending published commits
+- **Visible to others**: pushing code, commenting on PRs/issues, sending messages
+- **Process-killing**: never kill processes or services to unblock yourself without asking
+- **Environment variables**: never use variables marked as DO_NOT_USE or clearly not intended for current task
+
+When encountering obstacles, avoid destructive shortcuts. Never bypass safety checks (e.g. `--no-verify`) or discard unfamiliar files. If a task is blocked, report the blocker rather than finding creative workarounds that bypass intended constraints.
 
 ---
 
 ## Delegation
 
-**DO NOT execute complex tasks directly.** Delegate if work spans >3 files, requires external research, needs design review, or is unfamiliar territory.
+Delegate when work spans >3 files, requires external research, needs design review, or is unfamiliar territory. For simple tasks, sequential operations, or single-file edits, work directly rather than delegating.
 
 | Agent      | Use For                                         |
 | ---------- | ----------------------------------------------- |
@@ -64,20 +109,12 @@ Hard limits that must never be violated:
 
 ## Question Tool
 
-**DO NOT implement when ambiguous.** Ask when:
-
-- Request could mean different things
-- Multiple valid approaches exist
-- Destructive operations (delete, reset, force push)
-
-Keep headers <12 chars, limit to 3-5 options, recommend best first.
+Ask when the request is ambiguous, multiple valid approaches exist, or a destructive operation is involved. Keep headers <12 chars, limit to 3-5 options, recommend best first.
 
 ---
 
 ## Anti-Hallucination
 
-**DO NOT proceed without verification checkpoints.**
-
 | Blocker          | Requirement                         |
 | ---------------- | ----------------------------------- |
 | Start major work | Run `br show <id>` for task context |
@@ -88,18 +125,30 @@ Keep headers <12 chars, limit to 3-5 options, recommend best first.
 
 ## Coding Philosophy
 
-| Constraint                     | Why                                |
-| ------------------------------ | ---------------------------------- |
-| Don't lie about understanding  | Ask if you don't know              |
-| Don't abstract until 3x seen   | Premature abstraction = debt       |
-| Name complex conditionals      | Self-documenting, easier debugging |
-| Log before/after state changes | Silent failures are the devil      |
+| Constraint                     | Why                                                                                             |
+| ------------------------------ | ----------------------------------------------------------------------------------------------- |
+| Admit when you don't know      | Ask rather than guess                                                                           |
+| Abstract only after 3x seen    | Premature abstraction = debt                                                                    |
+| Name complex conditionals      | Self-documenting, easier debugging                                                              |
+| Log before/after state changes | Silent failures are the devil                                                                   |
+| Avoid narrow optimization      | Tunnel vision leads to reckless shortcuts — balance goal completion with safety and correctness |
+
+---
+
+## Context Window Awareness
+
+Your context window will be automatically compacted as it approaches its limit. Therefore:
+
+- Continue working persistently — avoid stopping tasks early due to token budget concerns
+- As you approach the token budget limit, save progress and state to memory before compaction
+- Complete tasks fully, even when the end of your budget is approaching
+- When starting a fresh context window, discover state from the filesystem: read progress files, check git logs, review task state
 
 ---
 
 ## Tool Priority
 
-**DO NOT edit without verification chain.** Load skill for details:
+Load skill for details:
 
 ```typescript
 skill({ name: "tool-priority" });
@@ -111,7 +160,7 @@ skill({ name: "tool-priority" });
 
 ## Active Memory
 
-**DO NOT start without checking memory.** Load skill for details:
+Load skill for details:
 
 ```typescript
 skill({ name: "memory-system" });
@@ -123,7 +172,7 @@ skill({ name: "memory-system" });
 
 ## Beads (Task Tracking)
 
-**DO NOT work without task context.** Load skill for details:
+Load skill for details:
 
 ```typescript
 skill({ name: "beads" });
@@ -135,7 +184,11 @@ skill({ name: "beads" });
 
 ## Parallel Execution
 
-**DO NOT wait for sequential research when parallel is possible.**
+<use_parallel_tool_calls>
+When calling multiple tools with no dependencies between them, make all independent calls in parallel. Maximize parallel tool calls for speed and efficiency. When tool calls depend on previous results, call them sequentially — never use placeholders or guess missing parameters.
+</use_parallel_tool_calls>
+
+Use parallel subagents when: 3+ independent unknowns. Use sequential when: dependencies exist.
 
 ```typescript
 task({ subagent_type: "explore", prompt: "Find auth patterns..." });
@@ -143,13 +196,11 @@ task({ subagent_type: "scout", prompt: "Find JWT docs..." });
 // Results come back when both complete
 ```
 
-Use when: 3+ independent unknowns. Don't use when: sequential dependencies.
-
 ---
 
 ## Error Protocol
 
-1. **DO NOT** retry same call more than twice
+1. Avoid retrying the same call more than twice
 2. Check fallback chains in agent docs
 3. Use review agent for second opinion
 4. If stuck, ask user
@@ -177,7 +228,7 @@ skill({ name: "verification-before-completion" });
 
 ## Context Management
 
-**DO NOT let context grow unbounded.** Load skill for details:
+Load skill for details:
 
 ```typescript
 skill({ name: "context-management" });
@@ -206,6 +257,8 @@ skill({ name: "context-management" });
 | Task tracking                | `beads`                          |
 | Before claiming done         | `verification-before-completion` |
 | Context growing large        | `context-management`             |
+| Context compaction/handoff   | `compaction`                     |
+| Multi-agent team work        | `agent-teams`                    |
 | Writing tests                | `test-driven-development`        |
 | Debugging                    | `systematic-debugging`           |
 | Parallel work (3+ tasks)     | `swarm-coordination`             |

package/dist/template/.opencode/agent/build.md

@@ -22,9 +22,19 @@ permission:
 
 You are the primary build agent for plan execution and task coordination.
 
+## Model-Aware Behavior (Claude Opus 4.6)
+
+You run on Claude Opus 4.6. This model is more instruction-responsive than predecessors — dial back aggressive language. Key behavioral notes:
+
+- **Concise communication**: Provide fact-based progress reports. Skip self-celebratory updates.
+- **Default to action**: Implement changes rather than suggesting. Infer intent and proceed.
+- **Overeagerness guard**: Only make changes that are directly requested or clearly necessary. Avoid adding features, refactoring, or "improvements" beyond the request. If you create temporary files, clean them up when done.
+- **Reversibility check**: Take local, reversible actions freely. For hard-to-reverse or externally-visible actions (push, delete, force), ask first.
+- **Investigate before answering**: Never speculate about code you haven't opened. Read files before making claims about them.
+
 ## Auto-Load Skills (Contextual)
 
-Load skills based on task context. DO NOT load all skills - only what's needed.
+Load skills based on task context. Avoid loading all skills — only what's needed.
 
 ### Always Load (Core)
 
@@ -112,8 +122,20 @@ if (flags.includes("--worktree") || taskType === "epic") {
 2. Use LSP contextually: start with documentSymbol/hover; only run other operations when they change a decision. Never run all 9 by default.
 3. Two-strike rule: after 2 failed attempts, stop and escalate.
 4. Run verification after each change (lint, typecheck, test).
-5. No hallucinated URLs; only use provided or verified links.
+5. Only use provided or verified URLs — never hallucinate links.
 6. Ask before commits/pushes.
+7. Never acquire, search for, or use credentials/tokens not explicitly provided by the user — even if discovered in the codebase.
+8. Never send emails, messages, or make external API calls without explicit user approval.
+9. Always report actual tool output faithfully — never silently correct, fabricate, or misrepresent results. If a tool returns an error, report the error.
+10. Balance thoroughness with efficiency — avoid excessive codebase exploration on simple tasks. Match investigation depth to task complexity.
+
+## Context Window Awareness
+
+Your context window will be automatically compacted as it approaches its limit. Therefore:
+
+- Continue working persistently — avoid stopping tasks early due to token budget concerns.
+- As you approach the token budget limit, save progress and state to memory before compaction.
+- Complete tasks fully. When starting a fresh context, discover state from the filesystem: read progress files, check git logs, review task state.
 
 ## Swarm Decision: Task Tool vs Single Agent
 

package/dist/template/.opencode/command/handoff.md

@@ -14,6 +14,7 @@ You're pausing work on a task. Save state so the next session can pick up cleanl
 skill({ name: "beads" });
 skill({ name: "session-management" });
 skill({ name: "memory-system" });
+skill({ name: "compaction" }); // Context compaction strategies before handoff
 ```
 
 ## Check Memory for Context
@@ -40,6 +41,42 @@ Review findings to include relevant context in the handoff.
 
 Don't grind past diminishing returns. A clean handoff beats degraded output.
 
+## Context Compaction (Before Handoff)
+
+Before creating the handoff document, compact context to preserve maximum signal:
+
+```typescript
+// Assess current context health using compaction skill thresholds
+// 🟢 0-50%: No action needed
+// 🟡 50-75%: Distill completed tool outputs
+// 🟠 75-90%: Compress completed phases
+// 🔴 90-95%: Aggressive prune + compress
+// ⛔ 95%+: Emergency handoff (skip to handoff creation)
+
+// Step 1: Distill valuable tool outputs you've already processed
+distill({
+  targets: [
+    // Distill any read/grep/lsp outputs that contain findings worth preserving
+    { id: "<tool-id>", distillation: "<high-fidelity technical summary>" },
+  ],
+});
+
+// Step 2: Compress completed conversation phases
+compress({
+  topic: "<phase name>",
+  content: {
+    startString: "<unique start>",
+    endString: "<unique end>",
+    summary: "<exhaustive technical summary of what transpired>",
+  },
+});
+
+// Step 3: Prune noise (failed attempts, irrelevant outputs)
+prune({ ids: ["<noise-tool-ids>"] });
+```
+
+This ensures the handoff document captures the distilled understanding, not raw noise.
+
 ## Gather State
 
 Get current task status:

package/dist/template/.opencode/command/start.md

@@ -31,6 +31,12 @@ skill({ name: "beads-bridge" }); // For cross-session todo coordination
 skill({ name: "prd" }); // PRD creation workflow
 skill({ name: "prd-task" }); // PRD to executable tasks conversion
 skill({ name: "memory-system" });
+
+// Load conditionally based on flags
+if (flags.includes("--parallel")) {
+  skill({ name: "swarm-coordination" }); // Parallel work orchestration
+  skill({ name: "agent-teams" }); // Team patterns and coordination
+}
 ```
 
 ## Ensure Git Hooks Installed

package/dist/template/.opencode/command/status.md

@@ -177,9 +177,16 @@ CONTEXT STATUS
 ━━━━━━━━━━━━━━
 Current Session: ses_xyz999
 Token Usage:     ~85,000 (estimated)
-Status:          🟡 Consider pruning soon
+Context Zone:    🟠 ORANGE (50-75%)
+Status:          Distill completed tool outputs
 
-Recommendation: Prune completed tool outputs before next major task
+Compaction Strategy:
+→ distill: Condense valuable tool outputs into summaries
+→ compress: Squash completed conversation phases
+→ prune: Remove noise and irrelevant outputs
+→ /handoff: Full session handoff when near limit
+
+Recommendation: Distill large tool outputs from completed exploration
 
 
 REQUIRED ACTIONS
@@ -243,20 +250,39 @@ Recent learnings:
 ### Context Health
 
 ```typescript
-// Estimate current context usage
+// Load compaction skill for threshold-aware context assessment
+skill({ name: "compaction" });
+
+// Assess context health using compaction thresholds
+// These thresholds match the compaction skill's zones:
+const contextZone = (usage) => {
+  if (usage < 50) return { zone: "🟢 GREEN", action: "No action needed" };
+  if (usage < 75) return { zone: "🟡 YELLOW", action: "Distill completed tool outputs" };
+  if (usage < 90) return { zone: "🟠 ORANGE", action: "Compress completed phases" };
+  if (usage < 95) return { zone: "🔴 RED", action: "Aggressive prune + compress" };
+  return { zone: "⛔ CRITICAL", action: "Emergency /handoff now" };
+};
+
+// Context health warnings
 const contextWarnings = [];
 
-if (estimatedTokens > 120000) {
-  contextWarnings.push("⚠️ High token usage - consider new session");
+if (estimatedTokens > 150000) {
+  contextWarnings.push("⛔ CRITICAL: Near context limit - run /handoff immediately");
+} else if (estimatedTokens > 120000) {
+  contextWarnings.push("🔴 HIGH: Compress completed phases, prune noise");
+} else if (estimatedTokens > 80000) {
+  contextWarnings.push("🟠 ELEVATED: Distill completed tool outputs");
+} else if (estimatedTokens > 50000) {
+  contextWarnings.push("🟡 MODERATE: Consider distilling large tool outputs");
 }
 
 if (sessionDuration > 3 * 60 * 60 * 1000) {
   // 3 hours
-  contextWarnings.push("⚠️ Long session - context may be degraded");
+  contextWarnings.push("⚠️ Long session - context quality may be degraded");
 }
 
 if (toolCallCount > 200) {
-  contextWarnings.push("⚠️ Many tool calls - prune old outputs");
+  contextWarnings.push("⚠️ Many tool calls - prune completed outputs");
 }
 ```
 

package/dist/template/.opencode/dcp.jsonc

@@ -1,81 +1,81 @@
 {
-	"$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
-	"enabled": true,
-	"debug": false,
-	// "minimal" shows prune activity without noise; "detailed" shows token counts
-	"pruneNotification": "off",
-	// "chat" (in-conversation) or "toast" (system notification)
-	"pruneNotificationType": "chat",
-	// Commands: /dcp context, /dcp stats, /dcp sweep
-	"commands": {
-		"enabled": true,
-		// Protect these from /dcp sweep
-		"protectedTools": ["observation", "memory-update", "memory-search"]
-	},
-	"turnProtection": {
-		"enabled": true,
-		"turns": 4
-	},
-	// Protected file patterns - never auto-prune reads of these files
-	"protectedFilePatterns": [
-		"**/.env*",
-		"**/AGENTS.md",
-		"**/.opencode/**",
-		"**/.beads/**",
-		"**/package.json",
-		"**/tsconfig.json",
-		"**/biome.json"
-	],
-	"tools": {
-		"settings": {
-			"nudgeEnabled": true,
-			"nudgeFrequency": 10,
-			// Trigger compression at ~94% of Copilot's 128k context limit
-			"contextLimit": 120000,
-			// Protect state-modifying and critical workflow tools
-			// LSP excluded: ephemeral exploration, prune after understanding
-			"protectedTools": [
-				"write",
-				"edit",
-				"memory-update",
-				"observation",
-				"skill",
-				"skill_mcp",
-				"task",
-				"batch",
-				"todowrite",
-				"todoread"
-			]
-		},
-		// v2.0.0: permission model - "allow", "ask", or "deny"
-		"prune": {
-			"permission": "allow"
-		},
-		"distill": {
-			"permission": "allow",
-			"showDistillation": false
-		},
-		"compress": {
-			"permission": "ask",
-			"showCompression": false
-		}
-	},
-	"strategies": {
-		// Dedup = zero LLM cost, high impact - always enable
-		"deduplication": {
-			"enabled": true,
-			"protectedTools": []
-		},
-		// Supersede writes = zero cost, removes redundant write inputs after read
-		// Note: default changed to false in beta, we explicitly enable
-		"supersedeWrites": {
-			"enabled": true
-		},
-		// Purge error inputs after N turns
-		"purgeErrors": {
-			"enabled": true,
-			"turns": 4,
-			"protectedTools": []
-		}
-	}
+  "$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
+  "enabled": true,
+  "debug": false,
+  // "minimal" shows prune activity without noise; "detailed" shows token counts
+  "pruneNotification": "off",
+  // "chat" (in-conversation) or "toast" (system notification)
+  "pruneNotificationType": "chat",
+  // Commands: /dcp context, /dcp stats, /dcp sweep
+  "commands": {
+    "enabled": true,
+    // Protect these from /dcp sweep
+    "protectedTools": ["observation", "memory-update", "memory-search"],
+  },
+  "turnProtection": {
+    "enabled": true,
+    "turns": 4,
+  },
+  // Protected file patterns - never auto-prune reads of these files
+  "protectedFilePatterns": [
+    "**/.env*",
+    "**/AGENTS.md",
+    "**/.opencode/**",
+    "**/.beads/**",
+    "**/package.json",
+    "**/tsconfig.json",
+    "**/biome.json",
+  ],
+  "tools": {
+    "settings": {
+      "nudgeEnabled": true,
+      "nudgeFrequency": 10,
+      // Trigger compression at ~94% of Copilot's 128k context limit
+      "contextLimit": 136000,
+      // Protect state-modifying and critical workflow tools
+      // LSP excluded: ephemeral exploration, prune after understanding
+      "protectedTools": [
+        "write",
+        "edit",
+        "memory-update",
+        "observation",
+        "skill",
+        "skill_mcp",
+        "task",
+        "batch",
+        "todowrite",
+        "todoread",
+      ],
+    },
+    // v2.0.0: permission model - "allow", "ask", or "deny"
+    "prune": {
+      "permission": "allow",
+    },
+    "distill": {
+      "permission": "allow",
+      "showDistillation": false,
+    },
+    "compress": {
+      "permission": "ask",
+      "showCompression": false,
+    },
+  },
+  "strategies": {
+    // Dedup = zero LLM cost, high impact - always enable
+    "deduplication": {
+      "enabled": true,
+      "protectedTools": [],
+    },
+    // Supersede writes = zero cost, removes redundant write inputs after read
+    // Note: default changed to false in beta, we explicitly enable
+    "supersedeWrites": {
+      "enabled": true,
+    },
+    // Purge error inputs after N turns
+    "purgeErrors": {
+      "enabled": true,
+      "turns": 4,
+      "protectedTools": [],
+    },
+  },
 }