// referência · docs

Versionamento da documentação

A documentação agora tem duas camadas: páginas editoriais escritas para explicar o produto e páginas geradas para manter cobertura alinhada ao código.

Fluxo recomendado

  1. Atualize o Okami-Agent

    Faça pull ou trabalhe no commit desejado da fonte.

    cd /Users/marcos/Documents/Git/Okami-Agent
    git status --short
  2. Gere referência

    Recria as tabelas geradas a partir de skills, tools, commands e 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. Audite cobertura

    Falha se skill/tool/comando novo não aparecer nos docs.

    OKAMI_AGENT_PATH=/Users/marcos/Documents/Git/Okami-Agent node scripts/generate-docs-data.mjs --check
  4. Gere rotas reais

    Cria docs/<section>/index.html para URLs compartilháveis.

    node scripts/generate-doc-routes.mjs

Política de changelog

  • Mudança editorial entra em PR normal da landing.
  • Mudança de superfície pública no Okami-Agent deve atualizar página editorial quando muda semântica.
  • Mudança apenas estrutural entra primeiro na referência gerada.
  • Breaking change precisa de nota de migração em docs-versioning ou seção dedicada.

Abrir esta página nos docs interativos