AGENTS.md@crates/zeph-skills · diff
git:20260606.583c571 to git:20260714.426058a
1 added, 0 removed. Audit A to A.
# zeph-skills Guide
Skill loading, matching, trust, and evolution logic live here.
- Start with crate-local checks: `cargo build -p zeph-skills`, `cargo nextest run -p zeph-skills`, `cargo clippy -p zeph-skills --all-targets -- -D warnings`.
- Preserve matcher quality and trust semantics unless the task explicitly changes retrieval or scoring behavior.
+ - `RoutingHead` (RL routing head, `rl_head.rs`) must be a single shared `Arc` instance across concurrent ACP/serve sessions — loading a fresh copy per session clobbers persisted REINFORCE weights via independent racing writes (#5974). Use `RoutingHead::persist_snapshot()` to build the persisted row; don't reintroduce separate locked reads that can race with a concurrent `update()`.
- Multi-model: skill matching, embedding, and self-learning evolution call LLMs — expose `*_provider` fields referencing `[[llm.providers]]` names; never hardcode a model.
- Changes to skill loading or trust should be checked against instruction-file and skill-related docs.
- If external behavior changes, update `crates/zeph-skills/README.md` and the relevant skills docs.