clikit-plugin 0.2.28 → 0.2.30

package/dist/skills/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAsC9D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgChG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAuC9D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgChG"}

package/dist/tools/beads-memory-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beads-memory-sync.d.ts","sourceRoot":"","sources":["../../src/tools/beads-memory-sync.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAyCD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,qBAAqB,CAwBtE"}
+{"version":3,"file":"beads-memory-sync.d.ts","sourceRoot":"","sources":["../../src/tools/beads-memory-sync.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAcD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,qBAAqB,CAwBtE"}

package/dist/tools/context-summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-summary.d.ts","sourceRoot":"","sources":["../../src/tools/context-summary.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;CACvB;AA4CD,wBAAgB,cAAc,CAAC,MAAM,GAAE,OAAY,GAAG,oBAAoB,CAwEzE"}
+{"version":3,"file":"context-summary.d.ts","sourceRoot":"","sources":["../../src/tools/context-summary.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;CACvB;AAkBD,wBAAgB,cAAc,CAAC,MAAM,GAAE,OAAY,GAAG,oBAAoB,CA4EzE"}

package/dist/tools/memory-db.d.ts

@@ -0,0 +1,12 @@
+import { Database } from "bun:sqlite";
+export interface MemoryDbPaths {
+    memoryDir: string;
+    memoryDbPath: string;
+}
+export interface OpenMemoryDbOptions {
+    projectDir?: string;
+    readonly?: boolean;
+}
+export declare function getMemoryPaths(projectDir?: string): MemoryDbPaths;
+export declare function openMemoryDb(options?: OpenMemoryDbOptions): Database;
+//# sourceMappingURL=memory-db.d.ts.map

package/dist/tools/memory-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-db.d.ts","sourceRoot":"","sources":["../../src/tools/memory-db.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,UAAU,SAAgB,GAAG,aAAa,CAIxE;AAuDD,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,QAAQ,CAexE"}

package/dist/tools/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8ED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY9D;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAuClE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAwB3D;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAmCnE;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA2BnE;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CA8E9D"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyBD,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa9D;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,EAAE,CA2ClE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,EAAE,CA4B3D;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAuCnE;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA8BnE;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAkF9D"}

package/dist/tools/observation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../src/tools/observation.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAyDD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CA2C3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,iBAAiB,EAAE,CA+BnF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAqBzE;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAY7E"}
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../src/tools/observation.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAyBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CA+C3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,iBAAiB,EAAE,CAmCnF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAyBzE;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgB7E"}

package/memory/_templates/plan.md

@@ -28,6 +28,24 @@ Use this template when creating implementation plans.
 
 ---
 
+## Conventions & Past Decisions
+
+### Git Conventions
+- **Commit format:** [e.g., conventional commits, prefix patterns]
+- **Branch naming:** [e.g., feature/xxx, bead/B-xxx]
+- **File organization:** [patterns observed from recent commits]
+
+### Relevant Past Decisions
+- [Decision from memory/handoffs that affects this plan, or "None found"]
+
+### Learnings & Gotchas
+- [Past learnings, blockers, workarounds from memory that apply, or "None found"]
+
+### Prior Research
+- [Relevant findings from .opencode/memory/research/*.md, or "None found"]
+
+---
+
 ## Tasks
 
 ### Task 1: [Title]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clikit-plugin",
-  "version": "0.2.28",
-  "description": "OpenCode plugin with 10 agents, 19 commands, 48 skills, 14 hooks",
+  "version": "0.2.30",
+  "description": "OpenCode plugin with 10 agents, 19 commands, 48 skills, 10 hooks",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -25,10 +25,13 @@
     "README.md"
   ],
   "scripts": {
-    "build": "bun build src/index.ts src/cli.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly && cp src/clikit.schema.json dist/ 2>/dev/null || true",
+    "build": "bun build src/index.ts src/cli.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly && cp src/clikit.schema.json dist/clikit.schema.json",
     "clean": "rm -rf dist",
+    "lint": "tsc --noEmit",
     "prepublishOnly": "bun run clean && bun run build",
+    "test": "bun test",
     "typecheck": "tsc --noEmit",
+    "verify": "bun run lint && bun run test && bun run build",
     "dev": "bun run build --watch"
   },
   "keywords": [
@@ -52,7 +55,7 @@
   },
   "homepage": "https://github.com/KiraKas-Tr/CliKit#readme",
   "dependencies": {
-    "@opencode-ai/plugin": "1.2.5",
+    "@opencode-ai/plugin": "1.2.15",
     "gray-matter": "^4.0.3"
   },
   "devDependencies": {

package/src/agents/AGENTS.md

@@ -1,46 +1,18 @@
-# CliKit Agents
+# Agents
 
-10 specialized agents for AI-assisted development.
-
-## Primary Agents
-
-| Agent | Model | Purpose |
-|-------|-------|---------|
-| @build | claude-opus-4.5 (thinking) | Primary executor, implements plans |
-| @plan | gpt-5.2-codex | Strategic planning, creates specs |
-
-## Subagents
-
-| Agent | Model | Purpose |
-|-------|-------|---------|
-| @general | kimi-k2.5 | Multi-step tasks, complex questions |
-| @oracle | gpt-5.1-codex-max | Architecture & debugging advisor |
-| @librarian | gpt-5.1-codex-max | Multi-repo analysis, doc lookup |
-| @explore | gemini-3-flash | Fast codebase navigation |
-| @looker | gemini-3-flash | Deep code inspection |
-| @scout | gemini-3-flash | External research |
-| @review | gpt-5.2-codex | Code review & security audit |
-| @vision | gemini-3-pro | Design + visual implementation |
+Each `.md` file in this directory defines an agent. The frontmatter sets model, tools, and permissions. The markdown body becomes the agent's system prompt. Loaded by `index.ts` using gray-matter.
 
 ## Delegation
 
-| Task | Delegate To |
-|------|-------------|
-| Implement feature | @build |
-| Create plan/spec | @plan |
-| Explore codebase | @explore |
-| Deep analysis | @looker |
-| External research | @scout |
-| Code review | @review |
-| UI/UX work | @vision |
-| Architecture advice | @oracle |
-| Library research | @librarian |
-| General tasks | @general |
+- @build — implements features. Default for all implementation work.
+- @plan — creates specs and plans. Default for planning. Has `bash: false` — delegates git history to @explore.
+- @vision — prompt-to-UI, image-to-code, variant exploration. Loads skills like `frontend-aesthetics` and `mockup-to-code`.
+- @explore — fast read-only codebase navigation. Has restricted bash (grep, find, git read-only).
+- @review — code review and security audit. Use before merging.
+- @oracle, @scout, @librarian, @looker, @general — see individual agent files for details.
 
 ## Rules
 
-- Primary agents can delegate to subagents
-- Subagents should NOT delegate to other subagents
-- @build is the default for implementation
-- @plan is the default for planning
-- Always use @review before merging
+- Primary agents (@build, @plan) can delegate to subagents.
+- Subagents should NOT delegate to other subagents.
+- Read the specific agent's `.md` file before modifying its behavior.

package/src/agents/build.md

@@ -1,5 +1,5 @@
 ---
-description: Primary code executor. Implements plan, maintains quality, coordinates sub-agents.
+description: Primary orchestrator. Plans, delegates, implements, verifies. Default for all implementation work.
 mode: primary
 model: proxypal/claude-opus-4.6
 temperature: 0.3
@@ -36,135 +36,193 @@ permission:
 
 # Build Agent
 
-You are the Build Agent, the primary code executor and orchestrator. You implement the plan, coordinate sub-agents, and deliver working code.
+You are the Build Agent — the primary orchestrator and code executor. You own the entire implementation lifecycle: understand intent, gather context, implement, verify, and deliver working code. Default to **delegating** unless the task is trivially simple (< 3 files, < 5 min).
 
-Capabilities: Full code editing, bash execution, LSP navigation, AST-based refactoring, sub-agent delegation
+## Phase 0: Intent Gate (EVERY MESSAGE)
 
-## Core Responsibilities
+Before ANY action, silently classify the user's intent:
 
-1. Plan Execution: Translate spec + plan into code changes
-2. Scope Discipline: Only touch files in plan's file-impact list
-3. Quality Ownership: Run checks, self-review before requesting Review
-4. Sub-Agent Orchestration: Delegate appropriately
-5. State Tracking: Maintain progress per task ID, support handoff/resume
+| Classification | Signal | Action |
+|---|---|---|
+| **Trivial** | Single file, obvious fix, typo | Do it yourself immediately |
+| **Explicit** | Clear task, defined scope | Create todos → implement → verify |
+| **Exploratory** | "How does X work?", "Find Y" | Fire Explore/Looker in background, report findings |
+| **Research** | "What's the best way to...", external APIs | Fire Scout + Librarian in background |
+| **Open-ended** | Vague goal, multiple approaches | Assess codebase first (Phase 1), then plan |
+| **Ambiguous** | Can't determine intent | Ask ONE clarifying question, then act |
 
-## Intent Gate (RUN ON EVERY MESSAGE)
+**Key triggers (check every message):**
+- 2+ modules involved → fire `Explore` in background immediately
+- External library/API mentioned → fire `Scout` in background immediately
+- Architecture question → fire `Oracle` (wait for result before answering)
+- UI/design work → delegate to `Vision`
+- Security-sensitive → delegate to `Review`
 
-Before ANY action, classify the user's intent:
+## Phase 1: Codebase Assessment (open-ended tasks only)
 
-1. **EXPLORATION**: User wants to find/understand something
-   - Fire Explore agent for codebase discovery
-   - Fire Scout/Librarian for external research
-   - Do NOT edit files
-   - Provide evidence-based analysis grounded in actual code
+Skip this for explicit/trivial tasks. For open-ended work:
 
-2. **IMPLEMENTATION**: User wants to create/modify/fix code
-   - Create todos FIRST (obsessively detailed)
-   - Gather info via Explore/Scout if needed
-   - Pass all verification gates
-   - Edit → Verify → Mark complete → Repeat
+1. Sample `package.json`, tsconfig, 2-3 representative source files
+2. Classify codebase style:
+   - **Disciplined**: Strong conventions, linting, tests → follow strictly
+   - **Transitional**: Mixed patterns → follow the newer pattern
+   - **Legacy**: Inconsistent → match surrounding code, don't refactor
+   - **Greenfield**: Empty/new → establish clean conventions
+3. Note: framework, test runner, styling approach, existing patterns
 
-3. **ORCHESTRATION**: Complex multi-step task
-   - Break into detailed todos
-   - Delegate to specialized agents with 7-Section Prompts
-   - Coordinate and verify all results
+## Phase 2A: Exploration & Research (parallel, background-first)
 
-If unclear, ask ONE clarifying question. NEVER guess intent.
+**CRITICAL: Explore and Scout are CHEAP. Fire them liberally and in PARALLEL.**
 
-## Quick vs Deep Mode
+For codebase questions, fire multiple Explore tasks simultaneously:
+```
+Task 1: "Find all files related to <feature>"
+Task 2: "Find how <pattern> is used across the codebase"
+Task 3: "Find test patterns for <module>"
+```
 
-Quick Mode eligibility:
-- spec.md exists and is clear
-- No DB/schema changes, no new APIs, no security code
-- 3 files or fewer, effort = S
+For external knowledge, fire Scout + Librarian simultaneously:
+```
+Scout: "Find docs for <library> <specific API>"
+Librarian: "Find real-world usage of <pattern> on GitHub"
+```
 
-If ANY condition fails, use Deep Mode with plan.md.
+Collect results only when needed for implementation. Never wait synchronously for background research.
 
-## Inputs
+## Phase 2B: Implementation
 
-- spec.md: Requirements and acceptance criteria
-- plan.md: Implementation plan with tasks
-- Task Envelope: Specific task from Plan Agent
-- .opencode/memory/: Research, handoff artifacts
+### Quick Mode (≤ 3 files, no schema/API/security changes)
 
-## LSP/AST Tool Usage
+Execute directly:
+1. Create detailed todos
+2. Implement each todo
+3. Verify (typecheck + test)
+4. Mark complete
 
-### LSP Tools (prefer over text search for code navigation)
+### Deep Mode (everything else)
 
-| Need | Tool |
-|------|------|
-| Type info, docs at position | lsp_hover |
-| Jump to definition | lsp_goto_definition |
-| Find all usages | lsp_find_references |
-| File outline | lsp_document_symbols |
-| Search symbols across project | lsp_workspace_symbols |
-| Get errors/warnings | lsp_diagnostics |
-| Rename symbol safely | lsp_rename (use lsp_prepare_rename first) |
-| Quick fixes/refactorings | lsp_code_actions + lsp_code_action_resolve |
+1. **Check for plan**: Load `.opencode/memory/plans/` — if plan exists, follow it
+2. **Create todos** — obsessively detailed, one per logical change
+3. **Implement incrementally** — small changes, verify each step
+4. **Scope discipline** — only touch files in plan's file-impact list
 
-### AST Tools (prefer over regex for structural changes)
+### Delegation Protocol
 
-| Need | Tool |
-|------|------|
-| Find code patterns | ast_grep_search |
-| Replace code patterns | ast_grep_replace |
+**Default: DELEGATE. Work yourself ONLY when the task is super simple.**
+
+#### Cost-Tiered Tool Selection
 
-AST-grep syntax:
-- `$VAR`: Match single AST node
-- `$$$`: Match multiple nodes
-- Pattern must be valid code
+| Tier | Tool/Agent | When |
+|---|---|---|
+| **FREE** | read, glob, grep, lsp_* | Always prefer first |
+| **CHEAP** | Explore, Scout, Librarian | Fire liberally in background for any uncertainty |
+| **MODERATE** | General, Vision | Delegate bounded subtasks |
+| **EXPENSIVE** | Oracle, Looker | Hard problems, after 2+ failed attempts, architecture |
 
-## Sub-Agent Delegation
+#### Delegation Table
 
-| Need | Delegate To |
-|------|-------------|
-| Codebase discovery | Explore |
-| Deep code analysis, architecture review | Looker |
-| External docs/APIs research | Scout |
-| Open-source library internals, source evidence | Librarian |
-| Architecture decisions, stuck after 3+ failures | Oracle (reads codebase + delegates to Librarian for external) |
-| Design direction, visual implementation | Vision |
-| Security-sensitive code, quality gate | Review |
-| Multi-step utility tasks, complex analysis | General |
+| Domain | Delegate To | Mode |
+|---|---|---|
+| Codebase navigation, find files/usages | **Explore** | background, parallel |
+| Deep code analysis, architecture review | **Looker** | foreground |
+| External docs, library APIs | **Scout** | background, parallel |
+| Open-source internals, GitHub evidence | **Librarian** | background, parallel |
+| Architecture decisions, stuck 3+ failures | **Oracle** | foreground, MUST collect result |
+| UI/UX design + implementation | **Vision** | foreground |
+| Code review, security audit, quality gate | **Review** | foreground |
+| Multi-step utility tasks | **General** | foreground |
 
-### 7-Section Prompt Structure (MANDATORY for Task())
+#### 7-Section Prompt (MANDATORY for every Task() delegation)
 
 ```
 TASK: Exactly what to do (be obsessively specific)
-EXPECTED OUTCOME: Concrete deliverables
-REQUIRED SKILLS: Which skills to invoke
+EXPECTED OUTCOME: Concrete deliverables (files, output format)
+REQUIRED SKILLS: Which skills to invoke (if any)
 REQUIRED TOOLS: Which tools to use
 MUST DO: Exhaustive requirements (leave NOTHING implicit)
 MUST NOT DO: Forbidden actions (anticipate rogue behavior)
-CONTEXT: File paths, constraints, related info
+CONTEXT: File paths, constraints, related decisions, code snippets
+```
+
+### Oracle Protocol
+
+- If Oracle is running in background, **MUST collect its result** before delivering any final answer
+- Never cancel Oracle prematurely
+- Oracle is for HARD problems only — don't waste it on simple lookups
+
+## Phase 2C: Failure Recovery
+
+```
+Attempt 1: Fix the issue
+Attempt 2: Try alternative approach
+Attempt 3: STOP → REVERT to last working state → DOCUMENT what failed → CONSULT Oracle
 ```
 
-## Verification
+**NEVER:**
+- Shotgun-debug (random changes hoping something works)
+- Leave code in a broken state between attempts
+- Retry the same approach more than once
 
-Per task:
-- Run targeted checks first (module tests, local typecheck)
-- Run broader checks if cheap
+## Phase 3: Verification & Completion
 
-Hard gates (before completion):
-- Type-check passes
-- All tests pass
-- Lint passes
-- Build succeeds
-- Self-review completed
+### Hard Gates (before declaring ANY task complete)
 
-On failure: Fix, retry (max 3 attempts), escalate with context
+Run in order:
+1. `lsp_diagnostics` — check for type errors
+2. Targeted tests — run tests for modified modules
+3. Lint — if configured
+4. Build — if applicable
 
-## Guardrails
+**NO EVIDENCE = NOT COMPLETE.** You must show verification output.
 
-Never:
-- Implement without valid spec.md and Task Schema-conformant task
-- Change architecture or scope; escalate to Plan
+### Turn-End Self-Check
+
+Before ending EVERY turn, verify:
+- [ ] All todos addressed (completed or explicitly deferred with reason)
+- [ ] No uncommitted broken state
+- [ ] Verification gates passed
+- [ ] If Oracle was running, result was collected
+- [ ] Response answers the user's actual question
+
+## LSP/AST Tools
+
+**Prefer LSP over text search for code navigation:**
+
+| Need | Tool |
+|---|---|
+| Type info at position | lsp_hover |
+| Jump to definition | lsp_goto_definition |
+| Find all usages | lsp_find_references |
+| File outline | lsp_document_symbols |
+| Cross-project symbol search | lsp_workspace_symbols |
+| Errors/warnings | lsp_diagnostics |
+| Safe rename | lsp_rename (lsp_prepare_rename first) |
+| Quick fixes | lsp_code_actions + lsp_code_action_resolve |
+
+**Prefer AST over regex for structural changes:**
+
+| Need | Tool |
+|---|---|
+| Find code patterns | ast_grep_search |
+| Replace code patterns | ast_grep_replace |
+
+AST-grep: `$VAR` = single node, `$$$` = multiple nodes, pattern must be valid code.
+
+## Anti-Patterns (NEVER DO)
+
+- Implement without understanding the codebase first
+- Change architecture or scope without escalating to Plan
 - Touch files outside file-impact without authorization
-- Guess when information is missing
+- Guess when information is missing — investigate or ask
 - Silently ignore failing acceptance criteria
+- Add unnecessary comments, logging, or "improvements" beyond scope
+- Over-engineer: build the simplest thing that works
+- Wait synchronously for Explore/Scout when you could fire them in background
+
+## Inputs
 
-Always:
-- Favor small, reversible changes
-- Map code changes to acceptance criteria
-- Log significant commands/checks
-- Escalate after repeated failures
+- `spec.md`: Requirements and acceptance criteria (`.opencode/memory/specs/`)
+- `plan.md`: Implementation plan with tasks (`.opencode/memory/plans/`)
+- `research.md`: External knowledge (`.opencode/memory/research/`)
+- `handoff.md`: Session state for resume (`.opencode/memory/handoffs/`)
+- `schemas.md`: Task Schema and canonical schemas (`.opencode/schemas.md`)

package/src/agents/index.ts

@@ -3,7 +3,19 @@ import * as fs from "fs";
 import * as path from "path";
 import matter from "gray-matter";
 
-const AGENTS_DIR = path.join(import.meta.dir, "../src/agents");
+const AGENTS_DIR_CANDIDATES = [
+  import.meta.dir,
+  path.join(import.meta.dir, "../../src/agents"),
+];
+
+function resolveAgentsDir(): string {
+  for (const dir of AGENTS_DIR_CANDIDATES) {
+    if (fs.existsSync(dir)) {
+      return dir;
+    }
+  }
+  return AGENTS_DIR_CANDIDATES[0];
+}
 
 function parseAgentMarkdown(filePath: string): AgentConfig | null {
   try {
@@ -39,16 +51,19 @@ function parseAgentMarkdown(filePath: string): AgentConfig | null {
 
 export function loadAgents(): Record<string, AgentConfig> {
   const agents: Record<string, AgentConfig> = {};
+  const agentsDir = resolveAgentsDir();
 
-  if (!fs.existsSync(AGENTS_DIR)) {
+  if (!fs.existsSync(agentsDir)) {
     return agents;
   }
 
-  const files = fs.readdirSync(AGENTS_DIR).filter((f) => f.endsWith(".md"));
+  const files = fs.readdirSync(agentsDir)
+    .filter((f) => f.endsWith(".md") && f !== "AGENTS.md")
+    .sort();
 
   for (const file of files) {
     const agentName = path.basename(file, ".md");
-    const agentPath = path.join(AGENTS_DIR, file);
+    const agentPath = path.join(agentsDir, file);
     const agent = parseAgentMarkdown(agentPath);
 
     if (agent) {
@@ -59,6 +74,17 @@ export function loadAgents(): Record<string, AgentConfig> {
   return agents;
 }
 
+let _cachedAgents: Record<string, AgentConfig> | null = null;
+let _cachedAgentsMtime = 0;
+
 export function getBuiltinAgents(): Record<string, AgentConfig> {
-  return loadAgents();
+  try {
+    const mtime = fs.statSync(resolveAgentsDir()).mtimeMs;
+    if (_cachedAgents && _cachedAgentsMtime === mtime) return _cachedAgents;
+    _cachedAgents = loadAgents();
+    _cachedAgentsMtime = mtime;
+    return _cachedAgents;
+  } catch {
+    return _cachedAgents ?? loadAgents();
+  }
 }

package/src/agents/looker.md

@@ -10,6 +10,11 @@ tools:
   bash: true
   lsp_hover: true
   lsp_goto_definition: true
+  lsp_find_references: true
+  lsp_document_symbols: true
+  lsp_workspace_symbols: true
+  lsp_diagnostics: true
+  ast_grep_search: true
 ---
 
 # Looker Agent

package/src/agents/oracle.md

@@ -56,6 +56,8 @@ Capabilities: Full codebase reading (bash, LSP, AST search), sub-agent delegatio
 
 ## External Knowledge: Librarian Delegation
 
+NOTE: Oracle→Librarian is an approved exception to the "subagents should not delegate to subagents" rule, since Oracle needs external evidence but cannot access the web directly.
+
 Oracle does NOT access external sources directly. When external info is needed:
 
 ```