DevFactory — Fábrica de Software Agêntica

Repositório central de inteligência da fábrica de software. Atua como Cérebro Operacional dos agentes de IA: aqui residem as regras de arquitetura, personas, workflows e cartuchos técnicos utilizados para produzir software de qualidade profissional para qualquer domínio ou stack.

---

Estrutura

.agents/
├── skills/           → Personas dos agentes (VS Code Copilot slash commands)
│   ├── Engenharia_Sucesso_Brasil/SKILL.md
│   ├── Product_Manager_Sucesso_Brasil/SKILL.md
│   ├── Seguranca_QA_Sucesso_Brasil/SKILL.md
│   └── UI_UX_Design_Sucesso_Brasil/SKILL.md
├── workflows/        → Roteiros passo a passo com pontos de parada humanos
│   ├── sbstart.md           → Pipeline completo (Fases 0–6)
│   ├── ssd.md               → Apenas artefatos SDD (sem código)
│   ├── importar-refatorar-git.md
│   └── master_skill.md      → Orquestrador e auto-evolução
├── templates/        → Templates base SDD
│   ├── 00-BUSINESS-RULES-base.md
│   ├── 01-PRD-base.md
│   ├── 02-ARCHITECTURE-base.md
│   ├── 03-TASKS-base.md
│   ├── 04-SESSION-STATE-base.md
│   ├── 05-CLOUD-base.md
│   └── cursorrules-base
└── skills_vault/     → Cartuchos técnicos especializados (carregue sob demanda)
    ├── skill-nextjs.md       ├── skill-react.md
    ├── skill-vue.md          ├── skill-nodejs-express.md
    ├── skill-python-fastapi.md ├── skill-python-django.md
    ├── skill-supabase.md     ├── skill-mongodb.md
    ├── skill-prisma.md       ├── skill-clerk.md
    ├── skill-nextauth.md     ├── skill-shadcn.md
    ├── skill-astro.md        ├── skill-tailwind.md
    ├── skill-docker.md       ├── skill-github-actions.md
    └── skill-rbac-multitenant.md

---

Metodologia: SDD (Spec-Driven Development)

Regra inviolável: nenhum código de funcionalidade é escrito antes da especificação estar travada e aprovada pelo humano.

Ciclo RPI

1. RESEARCH    → Leia business_rules.md, PRD do cliente, docs existentes
2. PLAN        → Gere <PROJECT_ROOT>/docs/PRD.md + <PROJECT_ROOT>/docs/ARCHITECTURE.md + <PROJECT_ROOT>/docs/TASKS.md
3. IMPLEMENT   → Execute ESTRITAMENTE seguindo o TASKS.md aprovado

---

Como Usar

Iniciar um projeto do zero

Cole no chat do agente (VS Code Copilot, Cursor, etc.):

Analise todo o diretório .agents/. Assuma a persona do @Engenharia_Sucesso_Brasil,
siga o roteiro de @sbstart.md. Quando chegar no SDD, aguarde minha aprovação.

Apenas gerar especificação (sem código)

Assuma as personas @Product_Manager_Sucesso_Brasil e @Engenharia_Sucesso_Brasil
em handoff explícito e siga @ssd.md.
Meu produto: [descrição do produto]

Migrar repositório existente

Assuma a persona do @Engenharia_Sucesso_Brasil e siga @importar-refatorar-git.md.
Repositório: [URL ou descrição do estado atual]

---

Personas Disponíveis

Persona	Ativa automaticamente quando
Engenharia_Sucesso_Brasil	Escrever código, arquitetura, implementação, debug
Product_Manager_Sucesso_Brasil	Levantar requisitos, gerar PRD, escopo de MVP
Seguranca_QA_Sucesso_Brasil	Auditar segurança, escrever testes, revisar vulnerabilidades
UI_UX_Design_Sucesso_Brasil	Design de interfaces, responsividade, acessibilidade

---

Cartuchos Técnicos (Skills Vault)

Carregue apenas o cartucho relevante para a task atual. Isso mantém o contexto limpo e o modelo focado.

Frontend:     @skill-nextjs.md | @skill-react.md | @skill-vue.md | @skill-astro.md
Backend:      @skill-nodejs-express.md | @skill-python-fastapi.md | @skill-python-django.md
Banco:        @skill-prisma.md | @skill-supabase.md | @skill-mongodb.md
Auth:         @skill-clerk.md | @skill-nextauth.md
UI:           @skill-shadcn.md | @skill-tailwind.md
Infra:        @skill-docker.md | @skill-github-actions.md
Arquitetura:  @skill-rbac-multitenant.md

---

Setup em Nova Máquina

1. Clonar o repositório

Clone na pasta raiz dos seus projetos:

git clone <url-deste-repo> _DevFactory

2. Instalar o AgentKit (Antigravity)

Abra a pasta _DevFactory no Antigravity e rode no terminal integrado (Ctrl + '):

npx @vudovn/ag-kit init

Quando perguntar se deseja sobrescrever a pasta .agent, responda N (não) — a pasta já vem configurada com os workflows da DevFactory.

Este comando instala o motor de slash commands (/sbstart, /create, /brainstorm, etc.) na IDE. Sem ele, os workflows existem mas não são reconhecidos como comandos.

3. Verificar os slash commands

No chat do Antigravity, teste:

/sbstart

A resposta esperada é a ativação da persona Product Manager pedindo a descrição do projeto (Fase 0 do SDD).

4. VS Code / GitHub Copilot

Abra a pasta no VS Code. O arquivo .github/copilot-instructions.md é carregado automaticamente pelo Copilot Chat e ativa toda a inteligência da fábrica. Neste ambiente, referencie os workflows via @sbstart.md no chat (em vez de /sbstart).

---

Regras de Ouro

1. SDD primeiro — PRD → ARCHITECTURE → TASKS → aprovação humana → código
2. Personas corretas — uma persona por bloco; em fases colaborativas use handoff explícito entre PM e Engenharia
3. Cartuchos sob demanda — carregue apenas o relevante para a task atual
4. Session state — ao final de sessões longas, gere session_state.md usando @template-04-SESSION-STATE.md
5. White-label — zero rastros de IA em código e documentação entregues
6. Ponto de parada — toda fase com ⛔ exige aprovação explícita do humano antes de continuar

---

FinOps — Gestão de Compute

Tarefa	Modelo recomendado
Análise de requisitos, arquitetura, debug complexo	Denso (Claude Opus, Gemini Pro)
Implementação, boilerplate, testes repetitivos	Leve (Gemini Flash, GPT-4o-mini)
Formatação, renomeações, refatorações simples	Leve