ultimate-pi 0.13.0 → 0.14.0

package/.pi/extensions/lib/plan-review-integrator-rules.ts

@@ -0,0 +1,119 @@
+/**
+ * P1 — integrator draft rules (disputes required when checks fail).
+ */
+
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+
+export interface IntegratorValidationResult {
+	ok: boolean;
+	review_gate_ready: boolean;
+	errors: string[];
+	warnings: string[];
+}
+
+function hasFailedChecks(doc: Record<string, unknown>): boolean {
+	const pe = doc.plan_evaluation as Record<string, unknown> | undefined;
+	if (!pe) return false;
+	for (const [key, val] of Object.entries(pe)) {
+		if (key === "source") continue;
+		const block = val as Record<string, unknown> | undefined;
+		if (block && block.passes === false) return true;
+		const checks = block?.issues as unknown[] | undefined;
+		if (Array.isArray(checks) && checks.length > 0) {
+			// issues on passing blocks are warnings only
+		}
+	}
+	const hv = doc.hypothesis_validation as Record<string, unknown> | undefined;
+	if (hv?.revision_recommended === true) return true;
+	if (
+		hv?.relevance &&
+		(hv.relevance as { passes?: boolean }).passes === false
+	) {
+		return true;
+	}
+	return false;
+}
+
+function adversarySeverityHigh(doc: Record<string, unknown>): boolean {
+	const ab = doc.adversary_brief as Record<string, unknown> | undefined;
+	const sev = String(ab?.severity ?? "").toLowerCase();
+	return sev === "high" || sev === "critical";
+}
+
+export function validateIntegratorDraft(
+	draft: Record<string, unknown>,
+	opts?: { validationTurn?: Record<string, unknown> | null },
+): IntegratorValidationResult {
+	const errors: string[] = [];
+	const warnings: string[] = [];
+	const disputes = Array.isArray(draft.disputes)
+		? (draft.disputes as string[]).filter(Boolean)
+		: [];
+	const unresolved = (
+		draft.review_integrator_summary as Record<string, unknown> | undefined
+	)?.debate_health as Record<string, unknown> | undefined;
+	const unresolvedTensions = Array.isArray(unresolved?.unresolved_tensions)
+		? (unresolved.unresolved_tensions as string[])
+		: [];
+	let review_gate_ready = draft.review_gate_ready === true;
+
+	const failedInDraft = hasFailedChecks(draft);
+	const failedInTurn =
+		opts?.validationTurn?.overall_ready === false ||
+		(Array.isArray(opts?.validationTurn?.checks) &&
+			(opts.validationTurn.checks as { status?: string }[]).some(
+				(c) => c.status === "fail",
+			));
+
+	if (failedInDraft || failedInTurn) {
+		if (disputes.length === 0) {
+			errors.push(
+				"evaluator reported failed/warn checks but disputes[] is empty — document tension",
+			);
+			review_gate_ready = false;
+		}
+		if (unresolvedTensions.length === 0 && disputes.length > 0) {
+			warnings.push(
+				"disputes present but unresolved_tensions empty — prefer listing open items",
+			);
+		}
+	}
+
+	if (adversarySeverityHigh(draft) && disputes.length === 0) {
+		errors.push("adversary severity is high but no disputes recorded");
+		review_gate_ready = false;
+	}
+
+	if (
+		review_gate_ready &&
+		(failedInDraft || failedInTurn) &&
+		disputes.length === 0
+	) {
+		errors.push(
+			"review_gate_ready cannot be true without disputes when checks fail",
+		);
+		review_gate_ready = false;
+	}
+
+	return {
+		ok: errors.length === 0,
+		review_gate_ready,
+		errors,
+		warnings,
+	};
+}
+
+export async function loadValidationTurnYaml(
+	runDir: string,
+	roundIndex: number,
+): Promise<Record<string, unknown> | null> {
+	const path = join(runDir, "artifacts", `validation-turn-r${roundIndex}.yaml`);
+	try {
+		const raw = await readFile(path, "utf-8");
+		return parseYaml(raw) as Record<string, unknown>;
+	} catch {
+		return null;
+	}
+}

package/.pi/extensions/lib/plan-scope-guard.ts

@@ -0,0 +1,89 @@
+/**
+ * P2 — detect material scope drift between task_summary and decomposition.
+ */
+
+export interface ScopeGuardResult {
+	material_drift: boolean;
+	overlap_score: number;
+	summary: string;
+	suggested_ask_user: boolean;
+}
+
+const PRODUCT_OS_MARKERS = [
+	"product os",
+	"product operating system",
+	"knowledge base",
+	"multi-source",
+	"synthesiz",
+	"papers",
+	"youtube",
+	"transcripts",
+	"news",
+	"books",
+	"decisions",
+];
+
+const INFRA_MARKERS = [
+	"cron",
+	"systemd",
+	"graphify add",
+	"graphify update",
+	"ingest",
+	"lockfile",
+	"feeds.yaml",
+	"polling",
+	"timer",
+];
+
+function tokenize(text: string): Set<string> {
+	const lower = text.toLowerCase();
+	const words = lower.match(/[a-z][a-z0-9_-]{2,}/g) ?? [];
+	return new Set(words);
+}
+
+function markerHits(text: string, markers: string[]): number {
+	const lower = text.toLowerCase();
+	return markers.filter((m) => lower.includes(m)).length;
+}
+
+export function assessPlanScopeDrift(
+	taskSummary: string,
+	decompositionText: string,
+): ScopeGuardResult {
+	const taskTokens = tokenize(taskSummary);
+	const decompTokens = tokenize(decompositionText);
+	let overlap = 0;
+	for (const t of taskTokens) {
+		if (decompTokens.has(t)) overlap += 1;
+	}
+	const overlapScore = taskTokens.size === 0 ? 1 : overlap / taskTokens.size;
+
+	const taskProduct = markerHits(taskSummary, PRODUCT_OS_MARKERS);
+	const decompProduct = markerHits(decompositionText, PRODUCT_OS_MARKERS);
+	const _taskInfra = markerHits(taskSummary, INFRA_MARKERS);
+	const decompInfra = markerHits(decompositionText, INFRA_MARKERS);
+
+	const productIntent = taskProduct >= 2;
+	const narrowedToInfra =
+		productIntent && decompInfra >= 3 && decompProduct < taskProduct;
+	const lowOverlap = productIntent && overlapScore < 0.08;
+
+	const material_drift = narrowedToInfra || lowOverlap;
+	let summary: string;
+	if (narrowedToInfra) {
+		summary =
+			"Decomposition reads as infrastructure/cron/graphify-ingest while the task asked for a broader product-OS knowledge base — confirm scope with the user.";
+	} else if (lowOverlap) {
+		summary =
+			"Decomposition shares almost no vocabulary with the task summary — verify the plan targets the right problem.";
+	} else {
+		summary = "Scope alignment looks acceptable.";
+	}
+
+	return {
+		material_drift,
+		overlap_score: overlapScore,
+		summary,
+		suggested_ask_user: material_drift,
+	};
+}

package/.pi/harness/agents.manifest.json

@@ -1,8 +1,8 @@
 {
 	"schema_version": "1.0.0",
 	"package": "ultimate-pi",
-	"package_version": "0.11.0",
-	"generated_at": "2026-05-18T09:43:44.563Z",
+	"package_version": "0.13.1",
+	"generated_at": "2026-05-18T17:22:10.311Z",
 	"agents": {
 		"pi-pi/agent-expert": {
 			"path": ".pi/agents/pi-pi/agent-expert.md",
@@ -94,23 +94,23 @@
 		},
 		"harness/planning/plan-adversary": {
 			"path": ".pi/agents/harness/planning/plan-adversary.md",
-			"sha256": "685926c638ae1377361d7cafda5e400be19cb3880510d8f6d389a5876647575f"
+			"sha256": "84c7fa63d38c39e32000c90093688a45bc2b96a2c6209037342222eae0c854f9"
 		},
 		"harness/planning/plan-evaluator": {
 			"path": ".pi/agents/harness/planning/plan-evaluator.md",
-			"sha256": "44fd52389d7e43dd5093653cba9694900561318ee5f00e3bc05c3ecef5d43621"
+			"sha256": "580d8c7a31f7a6ecd9e627460459d600650580b5df63d129278beefd3f3e347c"
 		},
 		"harness/planning/review-integrator": {
 			"path": ".pi/agents/harness/planning/review-integrator.md",
-			"sha256": "d0e8214539d0a78b9e5add70e61dd4e4de36def64172cda18d9b70727e7600ca"
+			"sha256": "cd1e5d10f0cb8b7a4197d2e92489023c285e90e250f1badc371470165aeb8cfd"
 		},
 		"harness/planning/scout-graphify": {
 			"path": ".pi/agents/harness/planning/scout-graphify.md",
-			"sha256": "b59916a26afccfe105e29c0bd8637ac54275e8afef1c6cc88a58bd05b0325473"
+			"sha256": "8a5ff68306a5eedf1a62067ac8812eac4ac1fe2016cba63337ef4e90b5136e00"
 		},
 		"harness/planning/scout-semantic": {
 			"path": ".pi/agents/harness/planning/scout-semantic.md",
-			"sha256": "47b7ea3e65b20a65e6d0ff11b6d5daff59b47a9ed618b8a3b6282f2eb0460572"
+			"sha256": "36bd424ebd422bda82bd447b22f591f99f32ec897ea43f385586119da5c26caa"
 		},
 		"harness/planning/scout-structure": {
 			"path": ".pi/agents/harness/planning/scout-structure.md",

package/.pi/prompts/harness-plan.md

@@ -31,7 +31,7 @@ Read **harness-debate-plan** skill before Review Gate rounds.
 1. Use `subagent` with `agentScope: "both"` and parallel `tasks` where lanes are independent.
 2. Each `subagent` call blocks until subprocesses finish — batch parallel scouts in one `tasks` array.
 3. Do **not** set `timeoutMs` unless the user explicitly requests a cap — subagents run until natural completion (optional backstop: `PI_SUBAGENT_TIMEOUT_MS`).
-4. Cap: **12** harness subagent invocations per parent session (extension-enforced).
+4. No harness subagent spawn cap — run the full scout + debate pipeline without skipping lanes for budget.
 5. Compact task text: embed `HarnessSpawnContext` JSON + lane-specific instructions only.
 
 ## Step 0 — Parse `$ARGUMENTS`
@@ -102,21 +102,31 @@ node .pi/scripts/validate-plan-dag.mjs --packet .pi/harness/runs/<run_id>/plan-p
 
 Must **pass** before debate. On fail: fix via author or parent patches, re-run.
 
-## Phase 5 — Review Gate debate (4 rounds, even with `--quick`)
+## Phase 5 — Review Gate debate (4 rounds, pi-messenger, even with `--quick`)
 
-1. `/harness-debate-open plan-<run_id>`
-2. For rounds 1–4 (`debate_round_focus`: spec, wbs, schedule, quality):
+1. `harness_debate_open` (debate id normalized to `plan-<run_id>`; creates `debate-messenger/` inboxes + threads).
+2. Optional: `harness_plan_scope_check` after decomposition — if `material_drift`, `ask_user` before continuing.
+3. For rounds 1–4 (`debate_round_focus`: spec, wbs, schedule, quality):
 
-| Round | Extra spawns (before integrator) |
-|-------|----------------------------------|
-| 1 | `hypothesis-validator` (blind: task + hypothesis only) → `plan-evaluator` → `plan-adversary` |
-| 2 | `plan-evaluator` → `plan-adversary` (optional `sprint-contract-auditor` if done_criteria thin) |
-| 3 | `plan-evaluator` → `plan-adversary` |
-| 4 | `plan-evaluator` → `plan-adversary` → **`sprint-contract-auditor` (required)** |
+| Round | Lane spawns (sequential) | Messenger |
+|-------|--------------------------|-----------|
+| 1 | `hypothesis-validator` (blind) → `plan-evaluator` → `plan-adversary` | evaluator `claim` → adversary `rebuttal` (`in_reply_to` claim ids) |
+| 2 | `plan-evaluator` → `plan-adversary` | same |
+| 3 | `plan-evaluator` → `plan-adversary` | same |
+| 4 | `plan-evaluator` → `plan-adversary` → **`sprint-contract-auditor`** | same + audit message optional |
 
-Then `review-integrator` → `write_harness_yaml` → `artifacts/review-round-r{N}.yaml` → build bus envelope → `/harness-debate-round '<json>'`.
+Lane YAML + messenger claims/rebuttals are **auto-applied** when each debate subagent completes (`harness-debate-lane-applied` entry). You may also call `harness_debate_apply_lane` if fenced YAML was truncated.
 
-3. `/harness-debate-consensus` after round 4.
+Per round (no prose-only turns — **always call a tool**):
+
+1. Spawn lane agents (evaluator → adversary → integrator; R1/R4 extras per table).
+2. After each subagent: verify `harness-debate-next-step` message or run `harness_debate_round_status({ round_index: N })`.
+3. Before adversary: `harness_messenger_read_round` → include transcript in adversary task.
+4. After integrator: `harness_debate_submit_round({ round_index, integrator_draft })` (writes review-round + bus round + integrate message — **do not** `write_harness_yaml` review-round paths).
+
+5. `harness_debate_consensus` after round 4.
+
+**Never** echo `/harness-debate-*` in bash. **Never** end a turn during Phase 5 with only narration (e.g. "Let me post claims") — the next tool call must be in the **same** assistant message or immediately after `harness-debate-next-step`.
 
 **R1 blind rule:** hypothesis-validator prompt must exclude decomposition, scouts, PlanPacket, prior debate.
 

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to this project are documented in this file.
 
 ## [Unreleased]
 
+## [v0.14.0] — 2026-05-18
+
+### ✨ Features
+
+- **Plan debate (pi-messenger):** `harness_debate_open`, `harness_messenger_post`, lane auto-apply after subagent returns, consensus gates on `approve_plan`, and blocks on parent `review-round-r*.yaml` writes.
+- **Spawn budget:** remove harness subagent spawn cap (spawns always allowed).
+- **Skills:** symlink `.pi/skills/*` to `.agents/skills` (harness, ccc, scrapling-web, wiki-save).
+
+### 🔧 Chores
+
+- Refresh planning agent prompts and `agents.manifest.json`; biome unused-import cleanup.
+
+## [v0.13.1] — 2026-05-18
+
+### 🔧 Chores
+
+- Consolidate vendored `ccc` skill under `.agents/skills/ccc`; remove redundant `cocoindex-search`, `ck-search`, and duplicate Obsidian skills from the package.
+
 ## [v0.13.0] — 2026-05-18
 
 ### ✨ Features

package/THIRD_PARTY_NOTICES.md

@@ -28,4 +28,4 @@
 - **Project:** https://github.com/cocoindex-io/cocoindex-code  
 - **License:** Apache-2.0  
 - **Install:** `uv tool install 'cocoindex-code[full]'` (see `/harness-setup` §2.4)  
-- ultimate-pi vendors the upstream agent skill at [`.pi/skills/ccc/`](.pi/skills/ccc/) and bootstraps indexes via [`.pi/scripts/harness-cocoindex-bootstrap.sh`](.pi/scripts/harness-cocoindex-bootstrap.sh). Replaces deprecated `@beaconbay/ck-search`.
+- ultimate-pi vendors the upstream agent skill at [`.agents/skills/ccc/`](.agents/skills/ccc/) and bootstraps indexes via [`.pi/scripts/harness-cocoindex-bootstrap.sh`](.pi/scripts/harness-cocoindex-bootstrap.sh). Replaces deprecated `@beaconbay/ck-search`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ultimate-pi",
-	"version": "0.13.0",
+	"version": "0.14.0",
 	"description": "Ultimate AI coding harness for pi.dev — extensible skills, Obsidian wiki knowledge layer, compressed context, deterministic output",
 	"keywords": [
 		"pi-package",
@@ -74,7 +74,7 @@
 		"@earendil-works/pi-coding-agent": "*"
 	},
 	"scripts": {
-		"check:ts": "tsc --noEmit --target ES2023 --lib ES2023 --moduleResolution nodenext --module nodenext --skipLibCheck .pi/extensions/custom-system-prompt.ts .pi/lib/harness-run-context.ts .pi/lib/harness-ui-state.ts .pi/extensions/harness-run-context.ts .pi/extensions/lib/harness-vcc-settings.ts .pi/extensions/dotenv-loader.ts .pi/extensions/lib/posthog-node.d.ts .pi/extensions/lib/harness-posthog.ts .pi/extensions/lib/harness-paths.ts .pi/extensions/pi-model-router-harness.ts .pi/extensions/provider-payload-sanitize.ts .pi/extensions/harness-telemetry.ts .pi/extensions/harness-ask-user.ts .pi/extensions/harness-plan-approval.ts .pi/extensions/lib/ask-user/schema.ts .pi/extensions/lib/ask-user/types.ts .pi/extensions/lib/ask-user/validate.ts .pi/extensions/lib/ask-user/dialog.ts .pi/extensions/lib/ask-user/fallback.ts .pi/extensions/lib/ask-user/render.ts .pi/extensions/lib/plan-approval/types.ts .pi/extensions/lib/plan-approval/schema.ts .pi/extensions/lib/plan-approval/validate.ts .pi/extensions/lib/plan-approval/format-plan.ts .pi/extensions/lib/plan-approval/dialog.ts .pi/extensions/lib/plan-approval/fallback.ts .pi/extensions/lib/plan-approval/render.ts .pi/extensions/lib/plan-approval/create-plan.ts .pi/extensions/harness-subagents.ts .pi/extensions/lib/harness-subagents-bridge.ts .pi/extensions/lib/harness-cocoindex-refresh.ts .pi/extensions/lib/harness-subagent-auth.ts .pi/extensions/lib/harness-subagent-policy.ts .pi/extensions/lib/harness-subagent-precheck.ts .pi/extensions/lib/harness-spawn-budget.ts .pi/extensions/lib/spawn-policy.ts vendor/pi-subagents/src/agents.ts vendor/pi-subagents/src/subagents.ts .pi/extensions/trace-recorder.ts .pi/extensions/observation-bus.ts .pi/extensions/drift-monitor.ts .pi/extensions/policy-gate.ts .pi/extensions/budget-guard.ts .pi/extensions/debate-orchestrator.ts .pi/extensions/harness-live-widget.ts .pi/extensions/sentrux-rules-sync.ts .pi/extensions/custom-header.ts .pi/extensions/harness-web-tools.ts .pi/extensions/harness-web-guard.ts .pi/extensions/lib/harness-web/run-cli.ts",
+		"check:ts": "tsc --noEmit --target ES2023 --lib ES2023 --moduleResolution nodenext --module nodenext --skipLibCheck .pi/extensions/custom-system-prompt.ts .pi/lib/harness-run-context.ts .pi/lib/harness-ui-state.ts .pi/extensions/harness-run-context.ts .pi/extensions/lib/harness-vcc-settings.ts .pi/extensions/dotenv-loader.ts .pi/extensions/lib/posthog-node.d.ts .pi/extensions/lib/harness-posthog.ts .pi/extensions/lib/harness-paths.ts .pi/extensions/pi-model-router-harness.ts .pi/extensions/provider-payload-sanitize.ts .pi/extensions/harness-telemetry.ts .pi/extensions/harness-ask-user.ts .pi/extensions/harness-plan-approval.ts .pi/extensions/lib/ask-user/schema.ts .pi/extensions/lib/ask-user/types.ts .pi/extensions/lib/ask-user/validate.ts .pi/extensions/lib/ask-user/dialog.ts .pi/extensions/lib/ask-user/fallback.ts .pi/extensions/lib/ask-user/render.ts .pi/extensions/lib/plan-approval/types.ts .pi/extensions/lib/plan-approval/schema.ts .pi/extensions/lib/plan-approval/validate.ts .pi/extensions/lib/plan-approval/format-plan.ts .pi/extensions/lib/plan-approval/dialog.ts .pi/extensions/lib/plan-approval/render.ts .pi/extensions/lib/plan-approval/create-plan.ts .pi/extensions/harness-subagents.ts .pi/extensions/lib/harness-subagents-bridge.ts .pi/extensions/lib/harness-cocoindex-refresh.ts .pi/extensions/lib/harness-subagent-auth.ts .pi/extensions/lib/harness-subagent-policy.ts .pi/extensions/lib/harness-subagent-precheck.ts .pi/extensions/lib/harness-spawn-budget.ts .pi/extensions/lib/spawn-policy.ts vendor/pi-subagents/src/agents.ts vendor/pi-subagents/src/subagents.ts .pi/extensions/trace-recorder.ts .pi/extensions/observation-bus.ts .pi/extensions/drift-monitor.ts .pi/extensions/policy-gate.ts .pi/extensions/budget-guard.ts .pi/extensions/debate-orchestrator.ts .pi/extensions/harness-debate-tools.ts .pi/extensions/lib/debate-bus-core.ts .pi/extensions/lib/debate-bus-state.ts .pi/extensions/lib/plan-debate-gate.ts .pi/extensions/lib/plan-debate-id.ts .pi/extensions/lib/plan-messenger.ts .pi/extensions/lib/plan-debate-envelope.ts .pi/extensions/lib/plan-review-integrator-rules.ts .pi/extensions/lib/plan-scope-guard.ts .pi/extensions/lib/plan-debate-write-guard.ts .pi/extensions/lib/plan-debate-lane.ts .pi/extensions/lib/plan-debate-round-status.ts .pi/extensions/harness-live-widget.ts .pi/extensions/sentrux-rules-sync.ts .pi/extensions/custom-header.ts .pi/extensions/harness-web-tools.ts .pi/extensions/harness-web-guard.ts .pi/extensions/lib/harness-web/run-cli.ts",
 		"vendor:sync-router": "bash .pi/scripts/vendor-sync-pi-model-router.sh",
 		"vendor:sync-vcc": "bash .pi/scripts/vendor-sync-pi-vcc.sh",
 		"vendor:sync-subagents": "bash .pi/scripts/vendor-sync-pi-subagents.sh",
@@ -84,7 +84,7 @@
 		"format": "biome format --write",
 		"format:check": "biome format",
 		"prepare": "lefthook install",
-		"test": "node --test test/harness-verify.test.mjs test/harness-ask-user.test.mjs test/harness-subagents-loader.test.mjs test/harness-subagent-precheck.test.mjs test/sentrux-rules-sync.test.mjs test/harness-budget-guard.test.mjs && node .pi/harness/evals/smoke/smoke-harness-plan.mjs --fixture && npx -y tsx --test test/harness-vcc-settings.test.ts test/harness-plan-phase-policy.test.mjs test/harness-subagent-policy.test.mjs test/harness-spawn-budget.test.mjs test/harness-turn-routing.test.mjs test/plan-approval-format.test.mjs test/plan-approval-dialog.test.mjs test/plan-approval-sync.test.mjs test/plan-create-plan.test.mjs test/plan-review-format.test.mjs test/debate-plan-phase.test.mjs",
+		"test": "node --test test/harness-verify.test.mjs test/harness-ask-user.test.mjs test/harness-subagents-loader.test.mjs test/harness-subagent-precheck.test.mjs test/sentrux-rules-sync.test.mjs test/harness-budget-guard.test.mjs && node .pi/harness/evals/smoke/smoke-harness-plan.mjs --fixture && npx -y tsx --test test/harness-vcc-settings.test.ts test/harness-plan-phase-policy.test.mjs test/harness-subagent-policy.test.mjs test/harness-spawn-budget.test.mjs test/harness-turn-routing.test.mjs test/plan-approval-format.test.mjs test/plan-approval-dialog.test.mjs test/plan-approval-sync.test.mjs test/plan-create-plan.test.mjs test/plan-review-format.test.mjs test/debate-plan-phase.test.mjs test/plan-messenger-gate.test.mjs test/plan-debate-lane-apply.test.mjs",
 		"test:vcc": "npx -y tsx --test vendor/pi-vcc/tests/*.test.ts",
 		"harness:sentrux-bootstrap": "node .pi/scripts/harness-sentrux-bootstrap.mjs",
 		"harness:sentrux-sync": "node .pi/scripts/sentrux-rules-sync.mjs --force",

package/.agents/skills/ck-search/SKILL.md

@@ -1,23 +0,0 @@
----
-name: ck-search
-description: "DEPRECATED — ck-search was removed from ultimate-pi. Use cocoindex-search or /skill:ccc instead. Triggers retained for backward compatibility: ck, ck-search, semantic search."
----
-
-# ck-search (deprecated)
-
-**`ck` / `@beaconbay/ck-search` is no longer used in this harness.**
-
-Use instead:
-
-- **`/skill:cocoindex-search`** or **`/skill:ccc`** — CocoIndex Code (`ccc search`)
-- **graphify** — architecture, callers, communities (`graphify query`, `explain`, `path`)
-
-## Migration
-
-```bash
-uv tool install 'cocoindex-code[full]'
-bash "$UP_PKG/.pi/scripts/harness-cocoindex-bootstrap.sh"
-ccc search --limit 10 "your query"
-```
-
-Remove legacy index: `rm -rf .ck` (optional).

package/.agents/skills/cocoindex-search/SKILL.md

@@ -1,35 +0,0 @@
----
-name: cocoindex-search
-description: "Semantic code search using CocoIndex Code (ccc). Use when exploring codebases, finding related implementation by meaning, or replacing legacy ck-search. Triggers on: semantic code search, ccc, cocoindex, cocoindex-code, find code related to, search the codebase for implementation, /skill:ck-search."
----
-
-# cocoindex-search
-
-CocoIndex Code (`ccc`) provides offline, AST-aware semantic search over the project codebase.
-
-## Quick start
-
-```bash
-ccc search --limit 10 "harness subagent policy"
-ccc status
-```
-
-## Full reference
-
-Load the vendored skill: **`/skill:ccc`** (`.pi/skills/ccc/SKILL.md`).
-
-## Harness lanes
-
-| Question type | Tool |
-|---------------|------|
-| Callers, callees, cross-module paths | `graphify explain` / `graphify path` |
-| Implementation by meaning | `ccc search --limit N "…"` |
-| Structural patterns | `sg -p '…'` |
-
-## Setup
-
-```bash
-bash "$UP_PKG/.pi/scripts/harness-cocoindex-bootstrap.sh"
-```
-
-Indexing before harness scouts is automatic — do not run `ccc index` or `ccc search --refresh` in `scout-semantic`.