Documentação do IAPro Nexus v1

Esta é a entrada pública canônica para entender, instalar, usar, operar e estender o Nexus.

README.md apresenta o produto. Esta pasta explica seu uso e arquitetura. DEV/ é um ledger de engenharia, validação e histórico; não deve ser usado como onboarding nem substituir a verdade de produto documentada aqui.

Comece pelo que você quer fazer

Quero…	Comece em
visão de 30 segundos e comandos	TL;DR
entender restrições da licença	Licenciamento
testar em 5–10 minutos	Quick Start
entender o produto inteiro	Como o Nexus funciona
verificar 30 recursos com código/testes	Matriz de funcionalidades
abrir uma sessão agora	Direct
transformar uma ideia em plano	Composer
revisar dependências e execução	Flow
executar trabalho longo/multi-Agent	Missions
entender comunicação entre Agents	Coordenação entre Agents
ver telas reais	Tour visual
instalar	Getting Started
operar/diagnosticar	Operação
usar a CLI	Referência da CLI
desenvolver provider	Provider development
entender a arquitetura	Arquitetura
contribuir	CONTRIBUTING

Mapa da documentação

1. Primeiro uso

• TL;DR
• Quick Start
• Getting Started
• Instalação nativa
• Primeiro projeto
• Pacotes nativos
• Docker compatibilidade

2. Produto

• Visão geral
• Como funciona
• Modelo mental
• Direct
• Agents
• Composer
• Flow
• Missions
• Coordenação entre Agents
• Conductor
• Autonomous delivery
• Maestro
• Providers, contas, quota e custo
• Terminais e diagnóstico de teclado
• Troca de contas e handoff
• HUD
• Acesso remoto seguro
• Temas
• Voz e acessibilidade
• Superfícies
• Tour visual

3. Arquitetura

• Visão geral
• Nexus Core
• Runtime da Mission
• Guardrails
• Mission Teams
• Runtime supervisionado
• Provider contract
• Resource routing
• Agent routing
• Persistência
• Eventos
• Continuidade
• ADRs

4. Operação

• Operação e suporte
• Troubleshooting
• Suporte de plataformas
• Recaptura e evidências visuais
• Release
• Segurança
• Registro de manutenibilidade

5. Referência

• CLI
• Configuração
• Matriz de funcionalidades
• Catálogo rastreável
• Referência do catálogo
• Glossário
• FAQ
• O que mudou

Progressão de uso

Direct
  ↓ quando precisa de clareza
Composer
  ↓ quando precisa revisar estrutura
WorkPlan / Flow
  ↓ GO explícito
Mission
  ↓ gates + evidência + convergência
COMPLETED_VERIFIED

A progressão não é obrigatória. Uma correção simples deve continuar simples.

Fonte de verdade de cada assunto

Assunto	Fonte canônica
como usar o produto	docs/product/
instalação	docs/getting-started/
operação e suporte	docs/operations/
arquitetura atual	ARCHITECTURE.md + docs/architecture/
contratos de execução	docs/architecture/ + código
status funcional	docs/reference/feature-matrix.md
status de release	DEV/validation/current/RELEASE_STATUS.md
especificação de fechamento v1	DEV/SPECS/NEXUS_1_0_CLOSURE.md
histórico/evidência	DEV/

Convenções de status

A documentação pública usa estes significados:

• Disponível no source: implementação e contrato existem no branch/revisão descrita.
• Beta/Experimental: implementação existe, mas compatibilidade/certificação ainda é limitada.
• Opcional: integração não é necessária ao Core.
• UNKNOWN: não há evidência suficiente para afirmar sucesso.
• Planejado: não deve ser descrito como funcional.

Status de código e status de release são coisas diferentes. Uma capacidade pode estar implementada no source e a v1 estável ainda permanecer NO_GO.

Imagens

Existem dois tipos de imagens:

1. screenshots reais — assets/screenshots/, produzidos por fixture sintética e registrados em manifesto;
2. diagramas conceituais — assets/diagrams/, usados para explicar arquitetura e fluxo.

Diagramas não substituem evidência de plataforma, runtime ou provider.

Documentação interna

DEV/ contém specs, worklogs, relatórios e campanhas de validação. Muitos arquivos são históricos e preservam decisões de uma revisão específica.

Para evitar confusão:

• estado público de release: Status da release;
• contrato interno de fechamento: DEV/SPECS/NEXUS_1_0_CLOSURE.md;
• índice interno: DEV/INDEX.md.

Guia editorial

Consulte STYLE_GUIDE.md. Regra principal: fato verificável antes de marketing.

Publicação e licença

O source está preparado para a PolyForm Strict 1.0.0, com usos não comerciais permitidos e sem autorização geral para alterações ou redistribuição. Consulte licenciamento e checklist de abertura. Não anunciar como open source.