📚 Documentação Técnica do Pathbit AI for Devs Esta pasta centraliza toda a documentação técnica, padrões de engenharia, guias operacionais e soluções de problemas do projeto Pathbit AI for Devs .
🚀 Guias de Uso e Operação
Documento
Descrição
Quando Usar
GUIA_CICLO_DE_VIDA_AMBIENTES.md Manual de criação, monitoramento, pausa e destruição completa de ambientes (start, status, stop, destroy)
Ao subir novas stacks locais ou limpar containers e volumes
GUIA_INTEGRACAO_CLAUDE_CODE.md Guia prático de conexão do Claude Code CLI ao 9Router via API Anthropic Messages
Ao rodar o Claude Code com modelos Gemini ou combos de contingência
GUIA_PERMISSOES_ANTIGRAVITY.md Configuração de acesso irrestrito e autonomia total no ecossistema Google Antigravity
Ao configurar permissões automáticas na IDE, CLI e Agent 2.0
🔧 Soluções para Problemas Técnicos
Documento
Descrição
Quando Usar
SOLUCAO_PROBLEMAS_COMUNS.md Resolução de portas ocupadas, download de modelos locais, locks no SQLite e tokens expirados
Ao encontrar erros de conexão, portas, permissões ou serviços offline
SOLUCAO_TOKEN_EXPIRADO_ANTIGRAVITY.md Diagnóstico, auto-cura e container sidecar para renovação e injeção contínua de tokens OAuth
Ao receber erro HTTP 401 ou 503 no gateway 9Router
📋 Padrões de Engenharia e Arquitetura
Documento
Descrição
Quando Usar
PADROES_ENGENHARIA_IA.md Diretrizes de desenvolvimento de scripts Python, isolamento de segredos e regras editoriais
Antes de criar novos scripts, artigos ou automações
CHECKLIST_SETTINGS_CLAUDE_CODE.md Regras verificadas para os settings.local.json dos exemplos: por que settings.local.json e não settings.json, ANTHROPIC_AUTH_TOKEN, advisor desligado, estado global da CLI, o vazamento do /model e os verificadores
Antes de editar qualquer examples/.claude/settings* ou quando o Claude Code pedir login numa pasta de exemplo
RESUMO_ORGANIZACAO.md Topologia de diretórios, anatomia dos módulos de artigos e checklist de publicação
Para entender a estrutura do projeto ou criar novos artigos
RELATORIO_VALIDACAO.md Evidências de execução end-to-end dos artigos 0001 a 0003 a partir de um Docker completamente zerado
Para conferir que os artigos publicados foram reproduzidos e comprovados
🧭 Como Navegar na Documentação
Identifique a sua necessidade técnica imediata (operação de containers, integração de CLI ou resolução de falhas).Consulte as tabelas acima para abrir o documento específico.Execute os comandos fornecidos copiando diretamente os blocos de terminal.Verifique o resultado utilizando os utilitários de diagnóstico em Python disponíveis em cada módulo.
🏷️ Convenções Visuais Utilizadas
🚀 = Guias operacionais e passos de execução
🔧 = Resolução de problemas e troubleshooting
📋 = Normas técnicas e organização
🔒 = Segurança, segredos e controle de acesso
⚠️ = Avisos importantes e pontos de atenção✅ = Confirmação de status funcional e testes aprovados
❌ = Sintoma de erro ou bloqueio
🤝 Contribuindo com a Documentação Para adicionar novos guias ou registrar soluções de novos cenários técnicos:
Mantenha os arquivos no formato Markdown limpo.
Não utilize dois-pontos (:) em títulos e subtítulos (#, ##, ###).
Não utilize caracteres de travessão longo; prefira hifens normais (-) ou parênteses.
Utilize vocabulário direto, simples e técnico, sem palavras rebuscadas.
Adicione o novo documento nas tabelas deste índice _DOCS.md