AGENTS.md@packages/kb-extension git:20260911.cdfac3cA

Immutable. This exact content is served forever at /api/v1/blob/7c67ccbff96131b6.

# DOX — packages/kb-extension

Files in this directory. One row per source file.

| File | Purpose |
|------|---------|
| `.pi/skills/dox-describe/SKILL.md` | Bundled skill: fill empty Purpose cells of the directory `AGENTS.md` tree. `kb dox describe --list --json` → `ask_user` confirm → fan out ≤2 write-capable subagents (one per `AGENTS.md`, cap 50 rows/run) → `kb dox lint` + `kb index`. See change: inject-dox-doctrine-and-describe. |
| `dox-doctrine.md` | Canonical DOX doctrine (moved from `packages/extension/.pi/skills/project-init/`). Delimited sections `dox:read:kb` (READ) + `dox:write` (WRITE); injected per turn by `extension.ts` `before_agent_start`. `dox:read:manual` REMOVED. MAINTAIN section outside markers = reference only, never injected. See change: inject-dox-doctrine-and-describe. |
| `README.md` | Package overview. Isolated pi extension for markdown KB; not part of dashboard bridge. Registers native tools `kb_search`/`kb_neighbors`/`kb_get` (pull retrieval over SQLite/FTS5). `tool_result` hook Job 1 (always on): `.md` write/edit → debounced hash-gated incremental reindex. Job 2 (opt-in `doxEnforcement` OFF): non-md source write → nudge to update nearest `AGENTS.md`. `tool_call` push mode (opt-in) surfaces nearest `AGENTS.md`. |
| `vitest.config.ts` | Package vitest config. include `src/**/__tests__/**/*.test.ts`, node env, `pool: forks`, `maxWorkers: 1` (serial — tests share reindex state) + `sequence.groupOrder: 1`, which is REQUIRED once this project joined the root `vitest.config.ts` list: the root runner refuses to group two projects that disagree on `maxWorkers` under the same order. See change: add-markdown-knowledge-base; fix-kb-search-retrieval-quality. |