← ClaudeAtlas

ingest-docslisted

Ingest the live documentation manual into the ontology as ground-truth Doc nodes, then enrich them with doc→ontology DESCRIBES links. Runs the mechanical doc extractor (docs-ingest → doc-nodes.jsonl, split by heading/anchor, prose referenced from ../documentation), rebuilds the graph (embeds the doc prose), spawns the doc-analyser subagent per un-enriched page (live-URL verification + DESCRIBES to the concepts/features/code each page documents + doc-claim-vs-code drift), and reports the consistency dashboard. Per adrs/drafts/ground-truth-lineage.md (Phase 1).
opendatadiscovery/odd-team · ★ 0 · Data & Documents · score 75
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 [