Skip to content
Merged
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Read `docs/token-practice.md` on demand for the selected context lane, native co
- Keep client accounts, model routes, native caching, tool discovery and compaction intact. Do not rerun the full audit or model trials at startup.
- Count once: never sum cumulative snapshots, overlapping artifact reductions or provider/cache subset counters, and keep native counter snapshots, exact artifact comparisons, cache reuse and complete provider usage separate.
- Read `docs/token-session-handbook.md` on demand for Codex session environment, MCP reload or another PC. Use `tools/token-report/README.md` for a new host's lifetime JSON/HTML manifest, and keep its private state outside the checkout.
- For catalog lookup on a host that adopted the named QMD index, refresh changed files with `qmd --index native-agent-stack-catalog update`, then use scoped `search` and `get` from `us-equities-catalog` or `us-equities-foundation`; `catalogs/us-equities/native-workflows.md` documents explicit setup for other checkouts. Do not index unrelated folders.
- For catalog lookup on a host that adopted the named QMD index, refresh changed files with `qmd --index native-agent-stack-catalog update`, followed by `qmd --index native-agent-stack-catalog embed` where that index carries embeddings, then use scoped `query`, `search` and `get` from `us-equities-catalog`, `us-equities-foundation`, `foundation-adoption` or `foundation-docs`; `catalogs/us-equities/native-workflows.md` documents explicit setup for other checkouts. Do not index unrelated folders.

## Workers, effort and lanes

Expand Down
4 changes: 4 additions & 0 deletions adoption/update.md
Original file line number Diff line number Diff line change
Expand Up @@ -209,10 +209,14 @@ On a host that already adopted the named index:

```sh
qmd --index native-agent-stack-catalog update
qmd --index native-agent-stack-catalog status # read "Vectors: N embedded"
qmd --index native-agent-stack-catalog embed # only when N is above 0
qmd --index native-agent-stack-catalog search "native worker" \
-c us-equities-foundation -n 3 --format json
```

`update` re-indexes changed files and computes no vectors. Where the index carries embeddings (`status` reports `Vectors:` above 0), `embed` then embeds only the documents still lacking current vectors, such as new or changed ones (`embed -f` would re-embed everything); without it, the `vec` and `hyde` arms of `query` miss those documents. The lexical profile of [native catalog setup](../catalogs/us-equities/native-workflows.md) carries no vectors and skips `embed`; it also avoids a plain `query`, which expands the text with one model and reranks with another, both downloaded on first use. A `query` made of typed lexical searches with `rerank` off is model-free ([recipes](../recipes/README.md)). `update`'s closing "Run 'qmd embed'" notice prints on any index with unembedded documents, lexical ones included, so it is not the signal. Sources, qmd `v2.8.3`: README [L556](https://github.com/tobi/qmd/blob/v2.8.3/README.md?plain=1#L556), [L644-L651](https://github.com/tobi/qmd/blob/v2.8.3/README.md?plain=1#L644-L651) and [L1016-L1018](https://github.com/tobi/qmd/blob/v2.8.3/README.md?plain=1#L1016-L1018); `src/cli/qmd.ts` [L561](https://github.com/tobi/qmd/blob/v2.8.3/src/cli/qmd.ts#L561) and [L994-L1002](https://github.com/tobi/qmd/blob/v2.8.3/src/cli/qmd.ts#L994-L1002); `src/store.ts` [L1974-L1978](https://github.com/tobi/qmd/blob/v2.8.3/src/store.ts#L1974-L1978).

Use `qmd get` on the exact returned document URI with a bounded range. [Native catalog setup](../catalogs/us-equities/native-workflows.md) records explicit collections; do not index the whole home or authentication directories. A host that adopted the index before 2026-09-27 adds the two foundation collections, `foundation-adoption` and `foundation-docs`, once with the commands there; the carrier names all four collections in every `query`. The frozen retrieval evaluation retains its original corpus and queries even when the live index grows. A generation-model upgrade does not automatically change embeddings or retrieval quality.

## Apply the skills manifest
Expand Down
8 changes: 4 additions & 4 deletions manifests/evidence.json
Original file line number Diff line number Diff line change
Expand Up @@ -3671,8 +3671,8 @@
},
{
"path": "AGENTS.md",
"sha256": "fbae51d8722ba84696768dc346e78b0787f299f9a995636eee3f632e7ebbdfc3",
"bytes": 13435
"sha256": "f541fa4fd0207cc102d67020a950643b0035272eba646ba62ce6762fbd74ddde",
"bytes": 13582
},
{
"path": "CLAUDE.md",
Expand Down Expand Up @@ -4001,8 +4001,8 @@
},
{
"path": "adoption/update.md",
"sha256": "5d34b3bc799f9be962b19cb39623555662505a0ee172c93c8db1c92180f4ba60",
"bytes": 19426
"sha256": "555afb2bff6a5661d5d8fb09f6f863836f4e04fd8621fd0a3d35b7a5794f1df8",
"bytes": 20960
},
{
"path": "blueprints/blind-catalog-convergence/README.md",
Expand Down
Loading