create-genia-os 2.1.1 → 2.3.0

package/template/.claude/rules/agent-memory.md

@@ -1,61 +1,61 @@
-# Memória Persistente dos Agentes — GEN.IA OS
-
-## Localização
-
-```
-.claude/agent-memory/
-├── analyst/MEMORY.md
-├── pm/MEMORY.md
-├── architect/MEMORY.md
-├── dev/MEMORY.md
-├── devops/MEMORY.md
-├── qa/MEMORY.md
-├── reviewer/MEMORY.md
-├── po/MEMORY.md
-└── sm/MEMORY.md
-```
-
-## Regra de Leitura
-
-Todo agente DEVE ler seu `MEMORY.md` ao ser ativado. Esta leitura é parte do protocolo de ativação.
-
-## Quando Atualizar
-
-Atualizar o MEMORY.md quando:
-- Descobrir padrão recorrente no projeto
-- Resolver problema difícil (documentar a solução)
-- Identificar preferência da usuária (Elidy)
-- Encontrar um gotcha (armadilha) do projeto
-- Tomar decisão arquitetural relevante
-
-## Formato do MEMORY.md
-
-```markdown
-# MEMORY — @[agente] ([Nome])
-
-> Memória persistente. Atualizada a cada sessão relevante.
-> Última atualização: YYYY-MM-DD
-
-## Padrões Confirmados
-- [padrão]: [quando usar]
-
-## Preferências da Usuária
-- [preferência]: [contexto]
-
-## Gotchas do Projeto
-- [problema]: [solução]
-
-## Decisões Importantes
-- [decisão]: [justificativa e data]
-
-## Stack Tecnológica Confirmada
-- [tecnologia]: [versão/contexto]
-```
-
-## Regra de Escrita
-
-- Não adicionar informações duplicadas
-- Verificar se já existe entry antes de criar nova
-- Remover entries desatualizadas
-- Máximo 200 linhas por arquivo (comprimir se necessário)
-- Usar linguagem objetiva: fatos, não opiniões
+# Memória Persistente dos Agentes — GEN.IA OS
+
+## Localização
+
+```
+.claude/agent-memory/
+├── analyst/MEMORY.md
+├── pm/MEMORY.md
+├── architect/MEMORY.md
+├── dev/MEMORY.md
+├── devops/MEMORY.md
+├── qa/MEMORY.md
+├── reviewer/MEMORY.md
+├── po/MEMORY.md
+└── sm/MEMORY.md
+```
+
+## Regra de Leitura
+
+Todo agente DEVE ler seu `MEMORY.md` ao ser ativado. Esta leitura é parte do protocolo de ativação.
+
+## Quando Atualizar
+
+Atualizar o MEMORY.md quando:
+- Descobrir padrão recorrente no projeto
+- Resolver problema difícil (documentar a solução)
+- Identificar preferência da usuária (Elidy)
+- Encontrar um gotcha (armadilha) do projeto
+- Tomar decisão arquitetural relevante
+
+## Formato do MEMORY.md
+
+```markdown
+# MEMORY — @[agente] ([Nome])
+
+> Memória persistente. Atualizada a cada sessão relevante.
+> Última atualização: YYYY-MM-DD
+
+## Padrões Confirmados
+- [padrão]: [quando usar]
+
+## Preferências da Usuária
+- [preferência]: [contexto]
+
+## Gotchas do Projeto
+- [problema]: [solução]
+
+## Decisões Importantes
+- [decisão]: [justificativa e data]
+
+## Stack Tecnológica Confirmada
+- [tecnologia]: [versão/contexto]
+```
+
+## Regra de Escrita
+
+- Não adicionar informações duplicadas
+- Verificar se já existe entry antes de criar nova
+- Remover entries desatualizadas
+- Máximo 200 linhas por arquivo (comprimir se necessário)
+- Usar linguagem objetiva: fatos, não opiniões

package/template/.claude/rules/ids-principles.md

@@ -1,52 +1,52 @@
-# Princípios IDS — GEN.IA OS
-## Incremental Decision System
-
-## Hierarquia de Decisão
-
-```
-REUSAR > ADAPTAR > CRIAR
-```
-
-Antes de criar qualquer artefato (componente, task, template, módulo, contexto):
-
-**1. REUSAR** — Buscar no projeto algo que já resolve o problema
-**2. ADAPTAR** — Se 70%+ compatível, adaptar o existente
-**3. CRIAR** — Apenas se reutilização não é viável
-
-## Onde Buscar Antes de Criar
-
-| Tipo | Buscar em |
-|------|-----------|
-| Task | `.genia/development/tasks/` |
-| Template de doc | `.claude/templates/` (se existir) |
-| Contexto de API | `.genia/contexts/` |
-| Skill | `.genia/skills/` |
-| Guideline | `.genia/guidelines/` |
-| Checklist | `.genia/development/checklists/` |
-
-## Justificativa Obrigatória para CRIAR
-
-Ao criar novo artefato que poderia ser reusado, documentar inline:
-
-```
-// NOVO: não foi possível reusar porque [razão]
-// Adaptação de: [nada existente] | [X arquivo, mas incompatível por Y]
-```
-
-## Prevenção de Duplicação em Stories
-
-Antes de criar `STORY-NNN`, verificar:
-1. Existe story similar em `docs/stories/`?
-2. Está dentro de um épico já existente?
-3. Já foi implementado e mergeado?
-
-## Circuit Breaker
-
-Se a busca por artefato reutilizável demorar mais de 30 segundos, prosseguir com criação e documentar a tentativa de busca.
-
-## Benefícios
-
-- Reduz explosão de arquivos no projeto
-- Mantém consistência entre implementações similares
-- Facilita manutenção no longo prazo
-- Evita reinventar soluções já validadas
+# Princípios IDS — GEN.IA OS
+## Incremental Decision System
+
+## Hierarquia de Decisão
+
+```
+REUSAR > ADAPTAR > CRIAR
+```
+
+Antes de criar qualquer artefato (componente, task, template, módulo, contexto):
+
+**1. REUSAR** — Buscar no projeto algo que já resolve o problema
+**2. ADAPTAR** — Se 70%+ compatível, adaptar o existente
+**3. CRIAR** — Apenas se reutilização não é viável
+
+## Onde Buscar Antes de Criar
+
+| Tipo | Buscar em |
+|------|-----------|
+| Task | `.genia/development/tasks/` |
+| Template de doc | `.claude/templates/` (se existir) |
+| Contexto de API | `.genia/contexts/` |
+| Skill | `.genia/skills/` |
+| Guideline | `.genia/guidelines/` |
+| Checklist | `.genia/development/checklists/` |
+
+## Justificativa Obrigatória para CRIAR
+
+Ao criar novo artefato que poderia ser reusado, documentar inline:
+
+```
+// NOVO: não foi possível reusar porque [razão]
+// Adaptação de: [nada existente] | [X arquivo, mas incompatível por Y]
+```
+
+## Prevenção de Duplicação em Stories
+
+Antes de criar `STORY-NNN`, verificar:
+1. Existe story similar em `docs/stories/`?
+2. Está dentro de um épico já existente?
+3. Já foi implementado e mergeado?
+
+## Circuit Breaker
+
+Se a busca por artefato reutilizável demorar mais de 30 segundos, prosseguir com criação e documentar a tentativa de busca.
+
+## Benefícios
+
+- Reduz explosão de arquivos no projeto
+- Mantém consistência entre implementações similares
+- Facilita manutenção no longo prazo
+- Evita reinventar soluções já validadas

package/template/.claude/rules/mcp-usage.md

@@ -1,49 +1,49 @@
-# Uso de Ferramentas e MCP — GEN.IA OS
-
-## Prioridade de Ferramentas
-
-```
-1. Ferramentas nativas Claude Code  (sempre preferir)
-2. Ferramentas MCP configuradas     (quando necessário)
-3. Bash com CLI tools               (último recurso)
-```
-
-## Ferramentas Nativas — Sempre Preferir
-
-| Operação | Ferramenta Correta | NÃO usar |
-|----------|--------------------|----------|
-| Ler arquivo | Read | Bash cat/head/tail |
-| Criar arquivo | Write | Bash echo/cat heredoc |
-| Editar arquivo | Edit | Bash sed/awk |
-| Buscar arquivo | Glob | Bash find/ls |
-| Buscar conteúdo | Grep | Bash grep/rg |
-| Perguntar usuário | AskUserQuestion | — |
-| Tarefa complexa | Task | — |
-
-## Gerenciamento MCP
-
-**@devops é o ÚNICO autorizado a:**
-- Adicionar servidores MCP
-- Remover servidores MCP
-- Configurar MCP (editar settings.json de MCP)
-- Fazer upgrade de versão de servidor MCP
-
-Outros agentes são **consumidores apenas**.
-
-## Regra de Ouro
-
-> "Se uma ferramenta nativa do Claude Code resolve, não use MCP."
-
-## Servidores MCP Disponíveis
-
-Ver configuração em `.claude/settings.json` (gerenciado por @devops).
-
-## Quando Usar Bash
-
-Use Bash apenas para:
-- Comandos git (quando necessário)
-- Executar scripts (npm, python, etc.)
-- Operações de sistema que não têm ferramenta nativa
-- Comandos CLI específicos (supabase, gh, etc.)
-
-Nunca para: leitura/escrita/busca de arquivos.
+# Uso de Ferramentas e MCP — GEN.IA OS
+
+## Prioridade de Ferramentas
+
+```
+1. Ferramentas nativas Claude Code  (sempre preferir)
+2. Ferramentas MCP configuradas     (quando necessário)
+3. Bash com CLI tools               (último recurso)
+```
+
+## Ferramentas Nativas — Sempre Preferir
+
+| Operação | Ferramenta Correta | NÃO usar |
+|----------|--------------------|----------|
+| Ler arquivo | Read | Bash cat/head/tail |
+| Criar arquivo | Write | Bash echo/cat heredoc |
+| Editar arquivo | Edit | Bash sed/awk |
+| Buscar arquivo | Glob | Bash find/ls |
+| Buscar conteúdo | Grep | Bash grep/rg |
+| Perguntar usuário | AskUserQuestion | — |
+| Tarefa complexa | Task | — |
+
+## Gerenciamento MCP
+
+**@devops é o ÚNICO autorizado a:**
+- Adicionar servidores MCP
+- Remover servidores MCP
+- Configurar MCP (editar settings.json de MCP)
+- Fazer upgrade de versão de servidor MCP
+
+Outros agentes são **consumidores apenas**.
+
+## Regra de Ouro
+
+> "Se uma ferramenta nativa do Claude Code resolve, não use MCP."
+
+## Servidores MCP Disponíveis
+
+Ver configuração em `.claude/settings.json` (gerenciado por @devops).
+
+## Quando Usar Bash
+
+Use Bash apenas para:
+- Comandos git (quando necessário)
+- Executar scripts (npm, python, etc.)
+- Operações de sistema que não têm ferramenta nativa
+- Comandos CLI específicos (supabase, gh, etc.)
+
+Nunca para: leitura/escrita/busca de arquivos.

package/template/.claude/rules/new-project.md

@@ -0,0 +1,157 @@
+# Protocolo de Novo Projeto — GEN.IA OS
+> Regra obrigatória. Todo projeto novo segue este protocolo sem exceção.
+> Adicionar em `.claude/rules/new-project.md`
+
+---
+
+## Trigger
+
+Qualquer solicitação que envolva criar:
+- Novo app / sistema / produto
+- Novo site
+- Nova automação
+- Novo agente
+- Qualquer entregável com mais de 1 arquivo de código
+
+---
+
+## Passo 1 — Nunca começar sem o briefing
+
+Antes de criar qualquer arquivo, pasta ou linha de código:
+
+```
+[@analyst] Cypher iniciando briefing...
+
+Antes de criar [nome do projeto], preciso entender:
+
+1. Qual problema isso resolve? (em uma frase)
+2. Quem vai usar? (persona real)
+3. Qual o resultado esperado quando funcionar?
+4. Tem prazo ou restrição importante?
+5. Qual empresa / negócio é responsável por este projeto?
+```
+
+Sem respostas → sem projeto. Não é burocracia, é clareza antes de custo.
+
+---
+
+## Passo 2 — Criar a estrutura de pastas com GEN.IA OS instalado
+
+Após briefing aprovado, criar dentro de `.Apps/` **com instalação completa do GEN.IA OS**:
+
+```
+.Apps/
+└── [nome-do-projeto]/
+    ├── .claude/                 ← GEN.IA OS — copiado do repositório oficial
+    │   ├── CLAUDE.md
+    │   ├── hooks/
+    │   ├── rules/
+    │   ├── agent-memory/
+    │   └── settings.json
+    ├── .genia/                  ← GEN.IA OS — framework core
+    ├── .synapse/                ← GEN.IA OS — runtime
+    ├── .business/               ← contexto de negócio do projeto
+    ├── docs/
+    │   ├── BRIEFING.md          ← @analyst preenche
+    │   ├── PRD.md               ← @pm preenche
+    │   ├── SPEC-TECNICO.md      ← @architect preenche
+    │   ├── PITCH.md             ← @analyst + @pm preenchem
+    │   └── stories/
+    │       └── STORY-001.md     ← @sm cria, @po valida
+    ├── src/                     ← código fonte
+    ├── tests/                   ← testes
+    └── README.md                ← @pm preenche ao final
+```
+
+**Instalação obrigatória do GEN.IA OS — NUNCA usar `npx create-genia-os`:**
+```bash
+cd .Apps/[nome-do-projeto]
+git clone https://github.com/elidyizzy/GENIA-SQUAD-OS temp-genia-os
+cp -r temp-genia-os/.claude .claude
+cp -r temp-genia-os/.genia .genia
+cp -r temp-genia-os/.synapse .synapse
+rm -rf temp-genia-os
+mkdir -p docs/stories src tests
+```
+
+**Verificação obrigatória após instalação:**
+```bash
+grep -i "cypher\|morpheus\|trinity\|neo\|tank\|oracle\|mouse\|smith\|switch" .claude/CLAUDE.md
+```
+Se não retornar resultado — PARAR. Refazer antes de continuar.
+
+---
+
+## Passo 3 — Sequência obrigatória de documentação
+
+Nenhum código é escrito antes desta sequência estar completa:
+
+```
+@analyst  → BRIEFING.md    (entendimento do problema)
+    ↓
+@pm       → PRD.md         (requisitos e escopo)
+    ↓
+@architect → SPEC-TECNICO.md (arquitetura e stack)
+    ↓
+@analyst + @pm → PITCH.md  (documento comercial)
+    ↓
+@sm       → STORY-001.md   (primeira story)
+    ↓
+@po       → validação       (aprova antes do @dev codar)
+    ↓
+@dev      → src/            (só aqui começa o código)
+```
+
+---
+
+## Passo 4 — Associar ao negócio correto
+
+Todo projeto pertence a uma empresa. Registrar no cabeçalho de todos os docs:
+
+```markdown
+**Empresa:** [GEN.IA SQUAD / BrasilUp / Cuore]
+**Responsável:** Elidy Izidio
+**Projeto:** [nome]
+**Iniciado:** YYYY-MM-DD
+```
+
+---
+
+## Passo 5 — Atualizar PRIORIDADES.md
+
+Ao criar projeto novo, adicionar em `.business/PRIORIDADES.md`:
+
+```markdown
+| [Nome do projeto] | [Empresa] | Em planejamento | Aguarda PRD |
+```
+
+---
+
+## O que NUNCA fazer ao criar projeto
+
+- ❌ Criar pasta `src/` antes do `BRIEFING.md` existir
+- ❌ Escrever código antes da `STORY-001` estar aprovada pelo @po
+- ❌ Pular o `PITCH.md` — ele é obrigatório mesmo para automações internas
+- ❌ Criar projeto fora da pasta `.Apps/`
+- ❌ Começar sem saber a qual empresa/negócio o projeto pertence
+
+---
+
+## Sobre o PITCH.md em projetos internos
+
+Mesmo para automações internas (relatórios, scripts, bots):
+o PITCH.md simplificado deve existir.
+
+Por quê: toda solução tem um problema que resolve e um valor que entrega.
+Documentar isso desde o início evita que projetos morram sem deixar rastro do que eram e por que existiam.
+
+Para automações internas, as seções obrigatórias são apenas:
+- Seção 1 (a frase)
+- Seção 2 (o problema)
+- Seção 3 (a solução)
+- Seção 5 (os resultados esperados)
+
+---
+
+_Esta regra é parte da Constituição do GEN.IA OS._
+_Só pode ser alterada com aprovação explícita de Elidy Izidio._

package/template/.claude/rules/story-lifecycle.md

@@ -1,87 +1,87 @@
-# Ciclo de Vida de Stories — GEN.IA OS
-
-## Estados
-
-```
-Draft → Ready → InProgress → InReview → Done
-                                      ↘ Blocked
-```
-
-## Responsabilidades por Estado
-
-| Estado | Responsável | O que acontece |
-|--------|-------------|----------------|
-| **Draft** | @sm | Cria story com template padrão |
-| **Ready** | @po | Valida com checklist 10 pontos |
-| **InProgress** | @dev | Implementa o código |
-| **InReview** | @qa + @reviewer | Testa e revisa código |
-| **Done** | @devops | Faz push/PR; @pm atualiza backlog |
-| **Blocked** | agente atual | Documenta blocker e escalona |
-
-## Checklist de Validação — @po (10 pontos obrigatórios)
-
-- [ ] Título claro e acionável (verbo + objeto)
-- [ ] Formato: "Como [persona] quero [ação] para [benefício]"
-- [ ] Acceptance criteria definidos (mínimo 3 critérios)
-- [ ] Tasks técnicas listadas (mínimo 2 tasks)
-- [ ] Dependências de outras stories mapeadas
-- [ ] Estimativa de esforço definida (P/M/G/XG)
-- [ ] Nome da branch definido: `tipo/STORY-NNN-slug`
-- [ ] Arquivos a criar/modificar listados
-- [ ] Testes necessários identificados
-- [ ] Riscos e pontos de atenção documentados
-
-**Story com menos de 8 pontos = REJEITADA pelo @po**
-
-## Localização das Stories
-
-```
-docs/stories/STORY-[NNN]-[slug].md
-```
-
-Exemplo: `docs/stories/STORY-001-autenticacao-usuario.md`
-
-## Atualização de Status na Story
-
-Sempre atualizar o cabeçalho quando mudar de estado:
-
-```markdown
-**Status:** InProgress
-**Agente:** @dev
-**Atualizado:** 2026-02-24
-```
-
-## Template de Story
-
-```markdown
-# STORY-NNN — Título da Story
-
-**Status:** Draft
-**Agente:** @sm
-**Criado:** YYYY-MM-DD
-**Estimativa:** M
-
-## Descrição
-Como [persona] quero [ação] para [benefício].
-
-## Acceptance Criteria
-- [ ] AC1: ...
-- [ ] AC2: ...
-- [ ] AC3: ...
-
-## Tasks Técnicas
-- [ ] Task 1: ...
-- [ ] Task 2: ...
-
-## Branch
-`feat/STORY-NNN-slug`
-
-## Arquivos Envolvidos
-- `src/...`
-
-## Dependências
-- STORY-XXX (se houver)
-
-## Riscos
-- ...
-```
+# Ciclo de Vida de Stories — GEN.IA OS
+
+## Estados
+
+```
+Draft → Ready → InProgress → InReview → Done
+                                      ↘ Blocked
+```
+
+## Responsabilidades por Estado
+
+| Estado | Responsável | O que acontece |
+|--------|-------------|----------------|
+| **Draft** | @sm | Cria story com template padrão |
+| **Ready** | @po | Valida com checklist 10 pontos |
+| **InProgress** | @dev | Implementa o código |
+| **InReview** | @qa + @reviewer | Testa e revisa código |
+| **Done** | @devops | Faz push/PR; @pm atualiza backlog |
+| **Blocked** | agente atual | Documenta blocker e escalona |
+
+## Checklist de Validação — @po (10 pontos obrigatórios)
+
+- [ ] Título claro e acionável (verbo + objeto)
+- [ ] Formato: "Como [persona] quero [ação] para [benefício]"
+- [ ] Acceptance criteria definidos (mínimo 3 critérios)
+- [ ] Tasks técnicas listadas (mínimo 2 tasks)
+- [ ] Dependências de outras stories mapeadas
+- [ ] Estimativa de esforço definida (P/M/G/XG)
+- [ ] Nome da branch definido: `tipo/STORY-NNN-slug`
+- [ ] Arquivos a criar/modificar listados
+- [ ] Testes necessários identificados
+- [ ] Riscos e pontos de atenção documentados
+
+**Story com menos de 8 pontos = REJEITADA pelo @po**
+
+## Localização das Stories
+
+```
+docs/stories/STORY-[NNN]-[slug].md
+```
+
+Exemplo: `docs/stories/STORY-001-autenticacao-usuario.md`
+
+## Atualização de Status na Story
+
+Sempre atualizar o cabeçalho quando mudar de estado:
+
+```markdown
+**Status:** InProgress
+**Agente:** @dev
+**Atualizado:** 2026-02-24
+```
+
+## Template de Story
+
+```markdown
+# STORY-NNN — Título da Story
+
+**Status:** Draft
+**Agente:** @sm
+**Criado:** YYYY-MM-DD
+**Estimativa:** M
+
+## Descrição
+Como [persona] quero [ação] para [benefício].
+
+## Acceptance Criteria
+- [ ] AC1: ...
+- [ ] AC2: ...
+- [ ] AC3: ...
+
+## Tasks Técnicas
+- [ ] Task 1: ...
+- [ ] Task 2: ...
+
+## Branch
+`feat/STORY-NNN-slug`
+
+## Arquivos Envolvidos
+- `src/...`
+
+## Dependências
+- STORY-XXX (se houver)
+
+## Riscos
+- ...
+```