ingest-docslisted
Install: claude install-skill opendatadiscovery/odd-team
# Ingest docs — the documentation ground-truth layer (ground-truth-lineage Phase 1)
Bring the published documentation manual (`../documentation/docs/**`, live at
`https://docs.opendatadiscovery.org/`) into the ontology as first-class,
searchable, traversable **`Doc`** nodes, and wire the reverse **`DESCRIBES`**
links so a maintainer can start at a doc section and reach the implementing
code / concept / feature — and vice-versa.
**Source-of-truth contract (do not violate):** doc prose is *referenced, not
copied*. `../documentation` stays the sole prose SoT. The committed artefacts are
addressing only (`doc-nodes.jsonl`), the per-page agentic sidecars
(`doc-understanding/*.md`), and the drift/completeness manifest
(`documentation/_manifest.yaml`). The graph + vectors are derived/ephemeral.
`adrs/drafts/ground-truth-lineage.md` + `lineage/GRAPH-TOPOLOGY.md`.
## Argument forms
| Form | Behaviour |
|---|---|
| `/ingest-docs [<repo>]` | Default. Full pipeline: mechanical ingest → graph-build → enrich every **un-enriched** page with `doc-analyser` → graph-build → `docs-verify`. (default repo `odd-platform`) |
| `/ingest-docs --mechanical-only [<repo>]` | Cheap refresh: `docs-ingest` + `graph-build` + `docs-verify`. No agentic pass. Use after a small `../documentation` edit to refresh addressing + embeddings + drift. |
| `/ingest-docs --pages "<glob>" [<repo>]` | Enrich only pages matching the docs-relative glob (e.g. `configuration-and-deployment/**`). |
| `/ingest-docs --full [