Arquitetura AIOX v4.2

Engine de desenvolvimento com modulos especializados

O AIOX e a evolucao do AIOS adaptada para desenvolvimento fullstack. Enquanto o AIOS (Hub) foca em copy, marketing e lancamentos, o AIOX foca em codigo, testes, deploy e infraestrutura. A arquitetura de camadas de contexto (Synapse) e a mesma — o que muda sao os modulos, tasks e templates.

Estrutura de diretorios

O workspace Tech segue uma estrutura similar ao Hub, com a engine no core e projetos separados:

nomics-tech/

nomics-tech/
├── .aiox-core/               → Engine AIOX v4.2
│   ├── constitution.md       → Principios fundamentais
│   ├── core-config.yaml      → Configuracao do projeto
│   ├── core/                 → 20+ modulos
│   │   ├── graph-dashboard/  → Dashboard visual
│   │   ├── code-intel/       → Analise de codigo
│   │   ├── doctor/           → Diagnosticos
│   │   ├── synapse/          → Camadas de contexto
│   │   └── orchestration/    → Orquestracao de workflows
│   ├── development/
│   │   ├── tasks/            → Tarefas executaveis
│   │   ├── templates/        → Templates de codigo
│   │   └── workflows/        → Workflows YAML
│   └── workflow-intelligence/ → Aprendizado adaptativo
├── nomicsbrain-app/          → App React/Next.js principal
├── squads/claude-code-mastery/ → Squad de 7 agentes
├── docs/                     → Documentacao
└── tasks/                    → Tarefas do projeto

Metodologia e padroes

Metodologia

Story-driven development

Toda mudanca no codigo comeca com uma story documentada em docs/stories/. A story descreve o que precisa ser feito, por que, e os criterios de aceitacao. So depois a implementacao comeca.

Padrao

TypeScript + Absolute Imports

Todo o codigo usa TypeScript com imports absolutos (@/). Isso garante type safety e imports limpos sem caminhos relativos longos.

Padrao

Conventional Commits

Commits seguem o padrao conventional: feat: para features, fix: para bugs, docs: para documentacao, chore: para manutencao. Isso facilita changelogs e versionamento.

Engine

Workflow Intelligence (WIS)

Assim como no Hub, o Tech tem aprendizado adaptativo de workflows. Padroes de sucesso sao registrados e reutilizados automaticamente.

Como acessar

O Tech e um workspace separado. Para trabalhar nele, abra uma sessao Claude Code dentro do diretorio:

Abrir sessao Tech

$cd ~/Desktop/Nomics/nomics-tech && claude

Sessao separada

O Tech roda em uma sessao Claude Code propria, com seu proprio CLAUDE.md e contexto. Nao tente executar comandos do Tech dentro da sessao do Hub — os contextos sao diferentes.