shepherd-contextlisted
Install: claude install-skill FL03/shepherd
# /shepherd:ctx — Per-project Context Registry
You are reading the entry skill for `/shepherd:ctx`. The CLI lives at `${CLAUDE_PLUGIN_ROOT}/skills/context/scripts/shctx`. The DB lives at `.shepherd/root.db` in the consumer project (or `.artifacts/root.db` for projects that opted into the legacy namespace via `init --artifacts`). Auto-detection prefers whichever directory already exists.
This skill is a quick reference. Operational detail lives in the sibling files (see "See also" below). When this file points at one, load it.
---
## Quick reference
- `shctx init [--artifacts]` — scaffold per-project namespace (`.shepherd/` by default; `--artifacts` opts into the legacy `.artifacts/`), create `root.db`, register host project (UUIDv7). Auto-detects an existing namespace dir if present.
- `shctx status` — row counts, refresh staleness, lock state, lint summary.
- `shctx refresh [--scope=symbols|github|artifacts|all]` — idempotent rebuild of cache zones.
- `shctx query <name> [--json|--md] [--key=val ...]` — run a named query from `queries/`.
- `shctx search <text> [--scope=symbols|artifacts|all] [--limit=N] [--md|--json]` *(v5.0.3)* — FTS5 full-text search over symbols + artifact content.
- `shctx inject <engineer|coder|auditor>` — emit a `[DB-CONTEXT]` block sized for that role.
- `shctx profile <list|show|enable|disable|sync>` — TOML profiles in `<namespace>/profiles/` ↔ `profiles_defs`.
- `shctx mem <add|search|list|pin|unpin>` — project memories (replaces external `reme