# `doc://librarian-guide` MCP Resource

A dense reference document for the librarian subsystem, surfaced as an MCP resource so agents can pull it on demand without consuming system-prompt tokens.

## Usage

```
resources/read doc://librarian-guide
```

Returns a self-contained markdown guide covering:

- **Artifact model** — frontmatter fields, `id`, `status`, `kind`, `tags`, `owners`
- **Filter syntax** — leaf format `{"field": {"op": value}}` with composition (`and`/`or`/`not`)
- **Tracker workflow** — design → create → augment → refresh lifecycle
- **Augmentation lifecycle** — `gather` / `commit_refresh` / `append_mode` / `history_cap`
- **Archiving / Moving** — `artifact(action="update", patch={status:"archived"})` and `artifact(action="move")`
- **Common mistakes** — filter format inversion, forgetting `repo` on create, direct file edits

## Why pull it?

The system prompt references librarian tools but cannot include the full filter reference inline (token cost). When you encounter a complex artifact query, call `resources/read doc://librarian-guide` once to load the complete reference into context.

## Source

`src/prompts/librarian-guide.md` — served directly from disk, always current.
