brain-ingest

/brain-ingest

Goal

Move knowledge one hop along the brain's one-way flow — from noisy, untrusted raw/ captures to curated typed atomic notes in notes/ — and, for the notes that have earned it, one further hop into the human-curated vault. The brain is the fast, multi-agent working layer; the vault is the reviewed SSOT. Nothing flows backward.

raw/<ai>/*.md   ──(this skill: distill + lint gate)──▶   notes/<type>/<id>.md
 (quarantine,                                             (curated, in the graph)
  kind=generated)                                                │
                                                                 ▼ (evergreen only)
                                              /wiki-ingest ──▶ vault wiki/  (human SSOT)

The paths are resolved by core/brain/store.py from $AGENT_BRAIN_DIR (default ~/.agent/brain) — this skill never hardcodes a brain or vault path. $HR is the agent-harness root, where core/brain/ lives (not your project); each block below resolves it first, because every Bash call is a fresh shell. python3 "$HR/core/brain/store.py" paths prints the resolved directories.

Steps

1. Select raw candidates

List the quarantined captures and read the ones worth curating:

HR="$(bash "${CLAUDE_PLUGIN_ROOT}/scripts/harness-root.sh")"
find "$(python3 "$HR/core/brain/store.py" paths | python3 -c 'import json,sys;print(json.load(sys.stdin)["raw"])')" -name '*.md'

Read each candidate. A capture is worth distilling only if it carries a durable insight, decision, procedure, or entity — not merely "a session happened". WIP breadcrumbs from the Stop hook with no reusable content are left in raw/ (or deleted); they are not promoted.

2. Dedup before you write (G3)

For each candidate idea, search the existing curated notes first:

HR="$(bash "${CLAUDE_PLUGIN_ROOT}/scripts/harness-root.sh")"
python3 "$HR/core/brain/store.py" search "<key terms of the idea>"

If a note already covers it, extend or refine that note (add a typed edge, a refines/supports link, a sharper line) rather than creating a near-duplicate. A new note is justified only when the idea is genuinely new. This is the anti-fragmentation rule — the same fact must not live in two notes.