kwlisted
Install: claude install-skill chenpg2/kw-engine
# /kw — knowledge engine (Loop 1)
You are the orchestrator. Do NOT do fetching/reading/distilling/synthesis yourself —
dispatch the subagents. Read `.kw/config.yaml` and `memory/index.json` first.
**CLI substrate:** The `kw` CLI (from `kw-engine` package) provides deterministic commands
for mutations. Subagents should use these instead of hand-editing index.json:
- `kw add-paper <id>` — register a paper (creates scaffold md + index entry)
- `kw add-principle --title … --sig … --math … …` — allocate P-####
- `kw add-link <from> <to> <type>` — add link (preserves formatting)
- `kw search "<query>"` — find relevant principles
- `kw fetch <id>` — acquire PDF + validate + register
- `kw reindex` — rebuild index.json + SQLite from markdown
- `kw verify` — check SCHEMA §6 invariants
- `kw status` — show engine state
**Hard boundary (cost + separation):** never call `read_*`/`search_*`/`download_*` MCP
tools or read a paper PDF in this (opus) loop — that wastes opus on text-ingestion and
bypasses the engine. Acquisition runs on `kw-fetcher`; reading runs on `kw-reader`. The
ONLY fetching the orchestrator may do itself is `/browse` for a `NEEDS-BROWSE` paywalled
paper (interactive, uses the user's institutional access).
**Model enforcement — MUST pass `model` explicitly on every Agent dispatch:**
| subagent | model | subagent_type |
|----------------|---------|------------------|
| kw-fetcher | sonnet | kw-fetcher |
| kw-reader | sonnet | kw-reader