docbase-skill

Skill docbase para agentes (Claude Code, Codex, OpenCode, Hermes, etc.): organiza a documentação do projeto para humanos e agentes em .md com índices e links internos — economizando tokens.

Instala a pasta .agents/skills/docbase/ no projeto atual e faz o bootstrap de docbase/ + referência no AGENTS.md.

Instalar / atualizar

npx docbase-skill install

• install sempre puxa a última versão do npm (npx usa latest por padrão) — rodar de novo = atualizar
• Padrão de destino: .agents/skills/docbase/ (o nome "docbase" é o da skill; "docbase-skill" é só o pacote no registry)
• Personalizar o destino: npx docbase-skill install --dir <caminho> (ex.: --dir .claude/skills/docbase)

npx docbase-skill update    # verifica se há versão nova no registry
npx docbase-skill version   # versão instalada vs pacote

O que instala

.agents/skills/docbase/
├── SKILL.md            ← skill completa (consultar, alimentar, iniciar, manter)
├── scripts/
│   ├── docbase-init.sh ← bootstrap: cria docbase/ + AGENTS.md
│   └── docbase.py      ← check | status | sync (integridade, cobertura, TOC)
└── templates/
    ├── docbase/        ← modelos prontos (INDEX, PRD, frontend/backend/database, decisions/)
    └── docbase-units/  ← templates de unidade: endpoint, componente, tabela, ADR

Manutenção da docbase (após instalar)

python3 .agents/skills/docbase/scripts/docbase.py check    # links, TL;DR, status, placeholders, granularidade
python3 .agents/skills/docbase/scripts/docbase.py status   # pendências + stale
python3 .agents/skills/docbase/scripts/docbase.py sync --toc  # cobertura vs código (git/mtime)

• check --max-lines N ou docbase/.docbase.json ({"max_lines": N}) ajusta o limite de granularidade (default 150 linhas — acima disso, warn de candidato a quebrar).
• Docs em decisions/ usam status ADR (proposta | aceita | substituida) e exigem ## Contexto + ## Decisão (ADR mínimo — o check cobra).

Fluxo de trabalho

1. Agente registra primeiro com status: pendente
2. Implementa
3. Marca status: concluido

Licença

MIT