// operação · docs 01
Gerar e auditar a documentação
A documentação precisa acompanhar o código. A partir de agora o repo da landing inclui um script de auditoria/geração que lê o Okami-Agent local e confere skills, t…
Comando
OKAMI_AGENT_PATH=/Users/marcos/Documents/Git/Okami-Agent \
node scripts/generate-docs-data.mjs --check
node scripts/generate-docs-data.mjs --snapshot > docs/generated/okami-docs-snapshot.jsonO que o script lê
| fonte | extração |
|---|---|
| skills/*/SKILL.md | metadata frontmatter, título, triggers e path |
| okami/core/tool_registry.py | ToolSpec: name, category, tier, danger, terminal |
| okami/commands.py | CommandDef: name, category, aliases, args, tier, scope |
| src/data/docs/*.js | seções carregadas e cobertura por hash |
Política
- Nova skill no código deve ter página
#skill-<nome>. - Nova tool builtin deve aparecer no overview ou página de categoria.
- Novo slash command deve aparecer em
Slash commands & TUI. - O script não substitui copy editorial; ele impede drift estrutural.