knowledge-compiler

Knowledge Compiler — Install Skill

Installs the knowledge-compiler engine into the current repo: SessionEnd/PreCompact hooks capture each session into <kdir>/daily/, a compiler distils those into <kdir>/knowledge/ (concepts, connections, index), and SessionStart injects the index back. Compilation runs on a manual command or a 6-hour SessionStart gate.

Knowledge always lives inside the repo, never under .claude/.

Authentication

The compiler uses the Claude Agent SDK, which needs ANTHROPIC_API_KEY (or CLAUDE_CODE_OAUTH_TOKEN) in the environment. Subscription credentials are NOT sanctioned for third-party plugins — public/customer installs must set an API key. Capture (hooks/scaffold) works without it; only compile/query/seed make API calls.

Naming / collision note

Invoke this as neurawork-cc-harness:knowledge-compiler. A separate coding-suite:knowledge-compiler skill also exists — use the fully-qualified name to avoid ambiguity.

Phase A — Recon (read-only)

Run the recon script and read its RECON_JSON blob:

python3 "${CLAUDE_PLUGIN_ROOT}/engines/knowledge-compiler/recon.py"

• status: NOT_A_GIT_REPO → stop; tell the user to run inside a git repo (offer git init).
• existing_kdir set → this is an ADOPT (refresh) install; reuse that name.
• Note seed_recommended, timezone, and clean.

Phase B — Ask

Use AskUserQuestion to confirm:

1. Knowledge dir name — default knowledge-base (or the detected existing_kdir).
2. Timezone — confirm the detected one (used only for display; no hardcoding).
3. Seed now? — offer only when seed_recommended is true AND the tree is clean. Seeding builds initial articles from the repo's README/docs and makes API calls.

Phase C — Execute

python3 "${CLAUDE_PLUGIN_ROOT}/engines/knowledge-compiler/install.py" \
  --knowledge-dir <NAME> [--seed]
uv sync --directory <NAME>

Then tell the user to commit <NAME>/ and .claude/settings.json. After install:

• Sessions now capture automatically.
• Manual compile: /neurawork-cc-harness:kc-compile.
• Query: uv run --directory <NAME> python scripts/query.py "...".