IomobAgents

IomobAgents

Sistema de agentes de IA especializados para desenvolvimento de software: cada agente conhece seu domínio, carrega apenas as regras relevantes (guardrails) e executa skills bem definidas. O orquestrador coordena a conversa com o usuário e aciona os agentes na sequência certa, garantindo TDD e conformidade com os padrões de engenharia.

Estrutura do repositório

IomobAgents/
├── agents/                    # Definição de cada agente (AGENT.md)
│   ├── orquestrador/          # Ponto de entrada — coordena todos os outros
│   ├── arquiteto/             # Contratos, APIs, eventos, arquitetura
│   ├── tech-lead/             # DoR, revisão de PR, refinamento
│   ├── dev-backend/           # System API e Process API (NestJS + Prisma)
│   ├── dev-bff/               # BFF — adapter entre frontend e backend
│   ├── dev-frontend/          # React 18+, hooks, estado, testes RTL
│   ├── dev-mobile/            # React Native + Expo, publicação iOS e Android
│   ├── dev-mensageria/        # Producers, consumers, sagas (NestJS microservices)
│   ├── dev-qa/                # Gherkin, E2E com Playwright, regressão
│   ├── dev-ui-ux/             # Design system, especificação de componentes, auditoria de interface
│   ├── dev-security/          # Modelagem de ameaças, auditoria OWASP Top 10, revisão de dependências CVE
│   └── dev-devops/            # Pipelines CI/CD GitHub Actions *(fora do fluxo do orquestrador)*
│
├── skills/                    # 68 skills reutilizáveis entre agentes (SKILL.md)
│   ├── handoff/               # Protocolo de conclusão de sessão e passagem de contexto entre agentes
│   ├── criar-system-api/
│   ├── criar-design-system/
│   ├── especificar-componente/
│   ├── revisar-interface/
│   ├── configurar-expo/
│   ├── criar-tela/
│   └── ...
│
├── commands/                  # Slash commands Claude Code — um por agente
│   ├── orquestrador.md
│   ├── arquiteto.md
│   └── ...
│
├── plans/                     # Artefatos gerados pelos agentes durante execução
│   └── .handoff/              # Handoff entre sessões: current.md, sequence.md e archive/
│
├── scripts/                   # Scripts auxiliares invocados pelos hooks
│   └── inject-handoff.js      # Lido pelo hook UserPromptSubmit — injeta contexto do agente anterior
│
├── .claude/                   # Configuração local do Claude Code
│   └── settings.json          # Permissões e hook UserPromptSubmit para injeção de handoff
│
├── .claude-plugin/            # Metadados do plugin Claude Code
│   ├── plugin.json            # Manifesto do plugin
│   └── marketplace.json       # Configuração de marketplace
│
├── Guardrails/                # Regras que todo agente deve seguir
│   ├── README.md              # Como aplicar, hierarquia, matriz agente × guardrail
│   ├── 00-core.md             # Universais — carregados por todos
│   ├── backend.md             # Node.js, NestJS, floating promises, env vars
│   ├── frontend.md            # React, TypeScript, estado (padrões de código)
│   ├── ux.md                  # Acessibilidade WCAG AA, animação, touch, tipografia, formulários
│   ├── dados.md               # Migrations, queries, paginação, transações
│   ├── appsec.md              # OWASP Top 10, injeção, auth, controle de acesso, XSS, SSRF, CVEs
│   ├── seguranca.md           # LGPD, secrets, migrations, boas práticas mínimas de codificação segura
│   ├── testes.md              # Nomenclatura, mocks, independência
│   ├── operacional.md         # PR quality, testes antes do PR, Docker obrigatório
│   ├── processo.md            # Git flow, DoR/DoD, conventional commits
│   ├── ia-agentes.md          # Comportamento de agentes em cadeia
│   ├── devops.md              # Secrets em CI, rastreabilidade de imagens, gate de produção
│   └── mobile.md              # React Native/Expo: componentes, estilos, navegação, storage, permissões
│
├── References/                # Checklists leves para consulta rápida durante execução de skills
│   ├── accessibility-checklist.md  # WCAG 2.1 AA por componente
│   ├── security-checklist.md       # OWASP Top 10 2025 por camada
│   ├── performance-checklist.md    # Core Web Vitals + anti-padrões por camada
│   ├── testing-patterns.md         # Pirâmide, DAMP vs DRY, mock hierarchy, Beyonce Rule
│   └── adr-template.md             # Template pronto para Architecture Decision Records
│
└── Guidelines/                # Guias de referência de engenharia
    ├── arquitetura/
    ├── backend/
    ├── frontend/
    ├── mobile/                # React Native + Expo: config, navegação, estado, EAS Build/Submit
    ├── ux/                    # Design system, tokens, acessibilidade, especificação de componentes
    ├── testes/
    ├── security/              # OWASP Top 10, STRIDE, autenticação, headers, CVEs, checklist por camada
    ├── infraestrutura/        # Docker: Dockerfile, docker-compose, templates por tipo de serviço