dmz-os 0.1.0

Squad de 18 AI agents que se integra ao seu projeto

DMZ Agents

Squad de 18 agentes de AI especializados que se integra diretamente ao seu repositório.

Hierárquicos. Rastreáveis. Colaborativos. Construídos para times de produto.

---

O que é?

DMZ Agents é um sistema de AI agents que trabalha dentro do seu projeto, não em paralelo a ele. Cada agente tem um papel bem definido — de arquitetura a copy — e eles se comunicam em hierarquia, com o @orch como maestro central.

Tudo fica rastreável: tarefas, decisões, memória de trabalho e histórico de execução aparecem no painel em tempo real.

Você dá uma demanda para o @orch →
  @orch decompõe em tarefas e delega →
    Cada agente executa sua parte →
      Resultados são integrados e persistidos →
        Você acompanha no painel

---

Como Instalar

Existem dois cenários de instalação:

🆕 Projeto do Zero

Você começa um projeto novo e quer os agentes desde o primeiro commit.

# 1. Clone o template base
git clone https://github.com/dmz-agents/squad-template.git meu-projeto
cd meu-projeto

# 2. Instale as dependências
pip install -r requirements.txt

# 3. Configure as credenciais
cp .env.dmz.example .env.dmz
#    → edite .env.dmz com SUPABASE_URL, service key e API key do LLM

# 4. Crie seu projeto no painel
#    → https://dmz-os.netlify.app/projects
#    → Selecione os agentes e copie o slug do projeto

# 5. Conecte e inicie
python -m dmz_agents connect --project meu-projeto
python -m dmz_agents start

⚡ Projeto em Andamento

Você já tem código e quer adicionar o squad sem mudar nada na estrutura atual.

# 1. Baixe apenas a pasta .agents/ e adicione ao seu repo
curl -L https://github.com/dmz-agents/squad-template/archive/refs/heads/main.zip -o dmz.zip
unzip dmz.zip "squad-template-main/.agents/*" -d temp
cp -r temp/squad-template-main/.agents/ ./
rm -rf temp dmz.zip

# 2. Instale as dependências (isoladas do seu projeto)
pip install -r .agents/requirements.txt

# 3. Configure as credenciais
cp .agents/.env.dmz.example .env.dmz
#    → edite .env.dmz (não interfere com o seu .env existente)

# 4. Crie seu projeto no painel
#    → https://dmz-os.netlify.app/projects → Selecionar Agentes

# 5. Conecte, sincronize e inicie
python -m dmz_agents connect --project meu-projeto
python -m dmz_agents sync
python -m dmz_agents start

📖 Guia completo: docs/GETTING_STARTED.md 🔑 Referência de variáveis: docs/ENV_REFERENCE.md

---

O Squad

18 agentes especializados organizados em hierarquia:

@orch — Orchestrator Master  (ROOT — nível 0)
 │
 ├── @syd    Squad Manager       nível 1 — saúde do time
 │
 ├── @jose   Project Manager     nível 1 — cronograma e riscos
 │    ├── @lucas  Product Owner      nível 2 — backlog e prioridade
 │    └── @david  Scrum Master       nível 2 — cerimônias ágeis
 │
 ├── @ryan   Developer           nível 1 — implementação
 │    ├── @oliver  DevOps Engineer    nível 2 — infra e CI/CD
 │    └── @alex    Tech Architect     nível 2 — decisões estruturais
 │
 ├── @emma        QA Engineer     nível 1 — qualidade e testes
 │
 ├── @constantine  Cyber Chief   nível 1 — segurança
 │    └── @theron   Legal Chief      nível 2 — compliance jurídico
 │
 ├── @aurora  Design Chief       nível 1 — direção criativa
 │    └── @victoria  UX Designer     nível 2 — experiência do usuário
 │
 ├── @cassandra  Copy Chief      nível 1 — copy e conteúdo
 ├── @kanya      Strategy        nível 1 — análise de mercado
 ├── @martin     SOP Extractor   nível 1 — frameworks e processos
 ├── @sofia      DB Sage         nível 1 — banco de dados
 └── @quantum    Tools Orch      nível 1 — orquestração de tools

Handle	Nome	Função	Categoria
@orch	ORCH	Orchestrator Master	Orchestration
@syd	Syd	Squad Manager	Orchestration
@jose	José	Project Manager	Product
@lucas	Lucas	Product Owner	Product
@david	David	Scrum Master	Product
@ryan	Ryan	Developer	Development
@oliver	Oliver	DevOps Engineer	Development
@alex	Alex	Tech Architect	Development
@emma	Emma	QA Engineer	Product
@constantine	Constantine	Cyber Chief	Security
@theron	Theron	Legal Chief	Security
@aurora	Aurora	Design Chief	Design
@victoria	Victoria	UX Designer	Design
@cassandra	Cassandra	Copy Chief	Marketing
@kanya	Kanya	Strategy Analyst	Strategy
@martin	Martin	SOP Extractor	Operations
@sofia	Sofia	DB Sage	Data
@quantum	Quantum	Tools Orchestrator	Operations

Você escolhe quais agentes ativar para cada projeto. Não é obrigatório usar o squad completo.

---

Como Funciona

sequenceDiagram
    participant U as Você
    participant O as @orch
    participant A as Agentes
    participant DB as Supabase
    participant P as Painel

    U->>O: Demanda em linguagem natural
    O->>O: Análise e decomposição
    O->>DB: Registra plano de execução
    O->>A: Delega tasks (com contexto preciso)
    A->>A: Executa usando tools disponíveis
    A->>DB: Persiste resultado + memória
    DB->>P: Atualiza histórico em tempo real
    O->>U: Entrega integrada dos outputs

Fluxo de dados

graph TD
    A[Você / Assistente de código] -->|demanda| B[@orch]
    B -->|plano| C[Supabase — dmz_agents_tasks]
    B -->|delega| D[@ryan Developer]
    B -->|delega| E[@alex Architect]
    B -->|delega| F[@emma QA]
    D & E & F -->|output| G[Supabase — dmz_agents_memory]
    G -->|leitura| H[Painel dmz-os.netlify.app]
    H -->|visualização| A

---

Pré-requisitos

• Python 3.10+
• pip atualizado
• Conta Supabase (gratuita)
• API Key de pelo menos 1 LLM: Anthropic, OpenAI ou Gemini

---

Variáveis de Ambiente (.env.dmz)

O arquivo .env.dmz é separado do seu .env existente — não conflita.

Variável	Obrigatória	Descrição
SUPABASE_URL	✅	URL do projeto Supabase
SUPABASE_SERVICE_ROLE_KEY	✅	Service Role Key
DMZ_PROJECT_SLUG	✅	Slug criado no painel
ANTHROPIC_API_KEY	⚡ min 1	Claude (recomendado)
OPENAI_API_KEY	⚡ min 1	GPT-4
GEMINI_API_KEY	⚡ min 1	Gemini

Lista completa de 40+ variáveis (MCPs, infra, pagamentos, comunicação) → docs/ENV_REFERENCE.md

---

Painel de Gestão

O painel em dmz-os.netlify.app permite:

Seção	O que você faz
/agents	Ver todos os 18 agentes, seus prompts, skills e tools
/projects	Criar projetos, selecionar agentes, guia de instalação, histórico
/memory	Memória de trabalho dos agentes por projeto
/tools	Registry global de tools disponíveis

---

Estrutura do Repositório

dmz-agents/
├── src/                        # Frontend Next.js (painel)
│   └── app/
│       ├── agents/             # Catálogo de agentes
│       ├── projects/           # Gestão de projetos
│       ├── memory/             # Memória de trabalho
│       └── tools/              # Registry de tools
├── server/                     # Backend Python (FastAPI) no Railway
│   ├── main.py
│   ├── requirements.txt
│   └── railway.toml
├── docs/
│   ├── GETTING_STARTED.md      # ← Leia isso
│   ├── ENV_REFERENCE.md        # Todas as variáveis
│   ├── setup_supabase.sql      # Schema do banco
│   └── capabilities/           # Prompts, skills e tools por agente
│       ├── orch-prompt.md
│       ├── ryan-skills.md
│       └── ...
└── .env.dmz.example            # Template de configuração

---

Tech Stack

Camada	Tecnologia
Frontend	Next.js 15 · TypeScript · Netlify
Backend	Python 3.11 · FastAPI · Railway
Banco	Supabase (PostgreSQL + Realtime)
LLMs	Anthropic Claude · OpenAI GPT-4 · Google Gemini
Tools	MCP (Model Context Protocol)
UI	Vanilla CSS · Lucide Icons · Plus Jakarta Sans

---

Dogfooding

O próprio projeto DMZ OS é gerenciado com o squad DMZ Agents. Os agentes constroem a plataforma que permite criar outros squads.

Você pode ver o histórico de trabalho em tempo real em: dmz-os.netlify.app/projects → Histórico de Trabalho → DMZ OS — Agent Squad Platform

---

Banco de Dados (Supabase)

O schema completo está em docs/setup_supabase.sql.

Tabelas principais:

Tabela	Conteúdo
dmz_agents_definitions	18 agentes com metadata
dmz_agents_prompts	Prompts por agente (versionados)
dmz_agents_skills	Skills declaradas por agente
dmz_agents_tools	Registry global de tools
dmz_agents_tool_assignments	Quais tools cada agente usa
dmz_agents_hierarchy	Estrutura de reports entre agentes
dmz_agents_projects	Projetos registrados
dmz_agents_squad	Agentes por projeto
dmz_agents_tasks	Tasks: master_plan, checklist, on_going, backlog
dmz_agents_memory	Memória de trabalho persistida
dmz_agents_env_keys	Referência de variáveis de ambiente

---

Roadmap

• Schema v2 Supabase — 11 tabelas
• 18 agentes populados com prompts, skills e tools
• Hierarquia completa configurada
• Painel: /agents, /projects, /memory, /tools
• Guia de instalação (zero e existente)
• Backend Python FastAPI no Railway
• Motor Python CLI — python -m dmz_agents start
• Protocolo de comunicação inter-agentes
• Autenticação multi-tenant (Supabase Auth + RLS)
• CI/CD — GitHub Actions
• Prompts de @david, @martin, @sofia, @quantum
• SDK público para integração com Cursor/Copilot/Antigravity

---

Contribuindo

1. Fork o repositório
2. Crie um branch: git checkout -b feat/minha-feature
3. Commit com conventional commits: git commit -m "feat: adiciona X"
4. Abra um Pull Request

---

Licença

MIT © DMZ Labs

---

Feito com o squad DMZ Agents · dmz-os.netlify.app