Documentação do Arc OS

O Sistema de orquestração para times de IA. 70+ endpoints de API. Dashboard CRM. Busca semântica auto-hospedada (Cohere + sqlite-vec, Phase 71). Desenvolvido com Claude Code.

ℹ️ Phase 71 (2026-06-05): A busca semântica agora roda em pipeline RAG auto-hospedado (shared/rag.ts + Cohere embed-multilingual-v3.0 + sqlite-vec). O bridge NotebookLM da Phase 36 foi descontinuado. Menções a NotebookLM abaixo apontam para o setup antigo; arquitetura atual: RAG Architecture (inglês — tradução em breve).

Navegação rápida

Por seção

Produto

O que é o Arc OS, para quem é e por que existe.

• Visão Geral — Capacidades principais, resumo da arquitetura, números-chave
• Dores & Soluções — 5 problemas reais que desenvolvedores enfrentam com ferramentas de IA e como o Arc OS resolve cada um
• Análise Competitiva — Matriz de funcionalidades vs ChatGPT, Cursor, Windsurf, Devin. Comparações de casos de uso

Arquitetura

Como o sistema funciona por dentro.

• Workers & Camada de Inteligência — 6 workers nativos, Binary Evals (6 tipos de regras), Context Router, Learnings, Karpathy Loop (auto-melhoria noturna)
• Schema do Banco de Dados — 21+ tabelas, 21 migrações, chaves estrangeiras, diagrama ER. SQLite no modo WAL, índices, pragmas
• Camada de Inteligência — Os 4 Pilares — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Além do Sage Worker e da descoberta no Marketplace
• Relatório do Sistema — Phase 21.5 — Snapshot histórico: mapa de módulos, inventário de skills, detalhes de infraestrutura (Phase 21.5)

Guias

Instruções passo a passo para usar e estender o sistema.

• Guia do Usuário — Guia completo do dashboard CRM: login (OAuth, e-mail, Telegram), workspace, workers, issues, wiki, skills, gerenciador de arquivos, analytics e mais
• Referência do ARC CLI — Todos os comandos CLI: login, issues, skills, wiki, roadmap, report, memory, wrapup (aplicação de docs), github (vinculação de repositório). Com exemplos e variáveis de ambiente
• Guia de Bots Telegram — Master Bot (orquestração) + Child Bot (proxy de IA). Comandos, teclados inline, roteamento de workers, integração com CRM
• NotebookLM Bridge — Busca semântica via Google AI. Auto-sync, cache de consultas, níveis de memória, download de artefatos
• Local Bridge CLI — Bridge sem dependências: baixe, cole o token, pronto. Binários standalone para Windows, macOS, Linux
  • Local Bridge — macOS — Apple Silicon + Intel, fluxo Gatekeeper, install.command
  • Local Bridge — Linux — x64 + arm64, extração tar.gz, dicas de ripgrep
  • Local Bridge — Windows — Windows 10/11, SmartScreen, peculiaridades de antivírus
• Criando Skills — Escreva skill.md, adicione evals.json, registre em _registry.json, teste o pipeline
• Isolamento de Skills Multi-Projeto — 3 níveis de isolamento: CLAUDE.md, skills/, Context Router. Evals, learnings e métricas por projeto
• Configuração de Desenvolvimento — Ambiente de desenvolvimento local: Bun, Node, portas, variáveis de ambiente, Docker, estrutura do projeto
• Troubleshooting — Diagnostique problemas de autenticação, worker, bridge, frontend e banco de dados por sintoma
• Integração com GitHub — Notificações via webhook + feed na barra lateral para repositórios vinculados. HMAC-SHA256, multi-repositório por projeto, alertas no Telegram (Phase 49.3)
• Configuração de E-mail — Runbook operacional para [email protected]: Cloudflare Email Routing (gratuito, 10 min), DMARC, caminho de migração para Zoho/Workspace

API

• Referência da API CRM — 70+ endpoints em 13 categorias: auth, projetos, workers, arquivos, skills, chat, wiki, analytics, marketplace, billing, convites, memória. Formatos de request/response, códigos de erro, segurança

Arquitetura (Análise aprofundada)

Arquitetura interna para usuários avançados — componentes, decisões e mergulhos profundos por fase.

• Visão Geral da Arquitetura — Mapa do sistema de alto nível com diagrama mermaid, lista de componentes, fluxos de dados
• Phase 20 — Bots Federados — Arquitetura Master + Children, watchdog, vault
• Phase 45 — E2EE Zero-Knowledge — Derivação de chave PBKDF2, AES-256-GCM, chaves de recuperação, cache em sessionStorage
• Fluxo Dual-Agent — Divisão Consultant + Developer, fila de spec, fluxo de aprovação
• Inteligência em Evolução — Karpathy loop, injeção de learnings, melhoria noturna
• Backend CRM — Internos do servidor HTTP Bun, dispatch de rotas, primitivos SSE/WebSocket

Segurança

• Visão Geral de Segurança — Modelo de ameaças, resumo de hardening, smoke tests em deploy
• Auditoria de Segurança 2026-04-23 — Revisão multi-pass do Sentinel, 13 patches, veredicto GREEN

Status do Projeto

• Roadmap — Linha do tempo de fases (mermaid) + concluídas/em andamento/planejadas para todas as 52 fases
• Visão Geral do Produto — Lista completa de funcionalidades (27 features), redução v1→v2, para quem é

Por mecanismo

Encontre documentação para uma funcionalidade específica do Arc OS.

Status dos documentos