// reference · docs

Documentation versioning

The docs now have two layers: editorial pages that explain the product and generated pages that keep surface coverage aligned to code.

  1. Update Okami-Agent

    Work at the source commit you want documented.

    cd /Users/marcos/Documents/Git/Okami-Agent
    git status --short
  2. Generate reference

    Rebuild tables from skills, tools, commands and config.

    cd /Users/marcos/Documents/Git/Okami-Agent-LP
    OKAMI_AGENT_PATH=/Users/marcos/Documents/Git/Okami-Agent node scripts/generate-docs-data.mjs --write
  3. Audit coverage

    Fail if new skills/tools/commands do not appear in docs.

    OKAMI_AGENT_PATH=/Users/marcos/Documents/Git/Okami-Agent node scripts/generate-docs-data.mjs --check
  4. Generate real routes

    Creates docs/<section>/index.html for shareable URLs.

    node scripts/generate-doc-routes.mjs
  • Editorial changes go through the landing repo.
  • Public behavior changes in Okami-Agent should update editorial docs.
  • Structural-only changes appear first in generated reference.
  • Breaking changes need migration notes.

Open this page in the interactive docs