create-genia-os 2.0.0 → 2.1.1

package/README.md

@@ -0,0 +1,154 @@
+# create-genia-os
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/create-genia-os"><img src="https://img.shields.io/npm/v/create-genia-os.svg?style=flat-square" /></a>
+  <img src="https://img.shields.io/badge/Claude%20Code-Compatible-blue?style=flat-square" />
+  <img src="https://img.shields.io/badge/Agentes-9%20%2B%20Squads-purple?style=flat-square" />
+  <img src="https://img.shields.io/node/v/create-genia-os.svg?style=flat-square" />
+  <img src="https://img.shields.io/npm/l/create-genia-os.svg?style=flat-square" />
+</p>
+
+> **Transforma o Claude Code em um time completo de especialistas.**
+> 9 agentes de desenvolvimento + Squads de negócio, Synapse Engine, governança automática e documentação profissional — tudo em 30 segundos.
+
+---
+
+## Instalação
+
+```bash
+npx create-genia-os meu-projeto
+cd meu-projeto
+code .
+```
+
+O wizard interativo configura nome do projeto, equipe, GitHub, idioma e stack. Em seguida, chame seu primeiro agente:
+
+```
+@analyst quero criar [seu projeto em uma frase]
+```
+
+---
+
+## O que você recebe
+
+### Sistema 1 — 9 Agentes de Desenvolvimento
+
+Um time completo com papéis, personas e autoridades únicas. Cada agente sabe exatamente o que pode e o que não pode fazer.
+
+| Agente | Persona | Papel | Autoridade exclusiva |
+|--------|---------|-------|---------------------|
+| `@analyst` | Cypher | Analista de Negócios | Briefing, requisitos, pesquisa |
+| `@pm` | Morpheus | Product Manager | PRD, épicos, roadmap |
+| `@architect` | Trinity | Arquiteta de Sistemas | Arquitetura, **veto técnico** |
+| `@po` | Oracle | Product Owner | **Aprovação de stories** |
+| `@sm` | Mouse | Scrum Master | **Criação exclusiva de stories** |
+| `@dev` | Neo | Desenvolvedor Full Stack | Implementação (sem push) |
+| `@qa` | Smith | QA Engineer | Veredictos de qualidade |
+| `@reviewer` | Switch | Code Reviewer | Aprovação de código |
+| `@devops` | Tank | DevOps Engineer | **git push, PR, releases** |
+
+### Sistema 2 — Squads Xquads (negócio e estratégia)
+
+Consultores de alto nível disponíveis a qualquer momento. Recomendam — o SQUAD executa.
+
+| Squad | Agentes |
+|-------|---------|
+| Advisory Board | `@ray-dalio`, `@charlie-munger`, `@naval-ravikant` |
+| Copy Squad | `@dan-kennedy`, `@david-ogilvy`, `@gary-halbert` |
+| Hormozi Squad | `@hormozi-offer` |
+| Brand Squad | `@brand-chief`, `@marty-neumeier` |
+| C-Level Squad | `@cmo-architect`, `@cto-architect` |
+| Data Squad | `@avinash-kaushik`, `@sean-ellis` |
+
+```
+@dan-kennedy escreva o pitch de vendas
+@ray-dalio analise os riscos desta estratégia
+@hormozi-offer monte a estrutura de oferta do plano Enterprise
+```
+
+---
+
+## Como funciona — o Synapse Engine
+
+A cada prompt que você digita, um hook JavaScript (`synapse-engine.cjs`) roda em **menos de 100ms** e injeta o contexto certo automaticamente:
+
+```
+Você digita: "@dev implemente o login"
+                    │
+                    ▼
+        Synapse Engine detecta "@dev"
+                    │
+                    ▼
+    L0 — Constituição  (SEMPRE)
+    L1 — Global + Contexto do projeto  (SEMPRE)
+    L2 — Regras específicas do @dev  (detectado)
+                    │
+                    ▼
+    Claude recebe prompt + contexto completo
+    e responde como Neo, com as regras certas
+```
+
+Para agentes Xquads, o engine injeta também:
+- Quem é você (`.business/OWNER.md`)
+- Prioridades atuais (`.business/PRIORIDADES.md`)
+- Contexto da empresa
+- Memória do agente (`.claude/agent-memory/squads/`)
+
+---
+
+## Governança automática — 5 hooks
+
+| Hook | Quando ativa | O que faz |
+|------|-------------|-----------|
+| `synapse-engine.cjs` | Todo prompt | Injeta contexto em camadas |
+| `enforce-git-push-authority.py` | Antes de Bash | **Bloqueia** push fora do @devops |
+| `sql-governance.py` | Antes de Bash | **Bloqueia** DDL perigoso |
+| `write-path-validation.py` | Antes de Write | Valida paths de arquivo |
+| `precompact-session-digest.cjs` | Antes de compactar | Salva memória da sessão |
+
+---
+
+## Documentação profissional criada automaticamente
+
+Todo projeto novo inclui:
+
+```
+docs/
+├── produto/     PRD.md · ROADMAP.md · CHANGELOG.md
+├── tecnico/     ARQUITETURA.md · STACK.md · SETUP.md · API.md · DEPLOY.md · adr/
+├── comercial/   PITCH.md · PROPOSTA.md · ONBOARDING.md · CASOS-DE-USO.md
+├── stories/     criadas pelo @sm (Mouse)
+└── handover/    atualizado pelo @devops (Tank) a cada sessão
+```
+
+---
+
+## A Constituição — regras que não se negociam
+
+| Artigo | Regra |
+|--------|-------|
+| I — CLI First | Claude Code é fonte de verdade |
+| II — Autoridade | @devops = único com push; @sm = único cria stories |
+| III — Story-Driven | Zero código sem story aprovada pelo @po |
+| IV — Sem Invenção | Apenas features dos requisitos explícitos |
+| V — Qualidade | Lint + testes + build devem passar |
+
+---
+
+## Requisitos
+
+- **Node.js** ≥ 18.0.0
+- **Claude Code** (CLI da Anthropic)
+- **VS Code** (recomendado)
+- **Python 3.8+** (para hooks de governança)
+- **Git**
+
+---
+
+## Documentação completa
+
+[github.com/elidyizzy/GENIA-SQUAD-OS](https://github.com/elidyizzy/GENIA-SQUAD-OS)
+
+---
+
+*GEN.IA OS v2.1 · Criado por **Elidy Izidio** · Founder, GEN.IA SQUAD · 2026*

package/bin/index.js

@@ -0,0 +1,240 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * create-genia-os — CLI de setup do GEN.IA OS
+ * Uso: npx create-genia-os [nome-do-projeto]
+ * Sem dependências externas — Node.js puro.
+ */
+
+const readline = require('readline');
+const fs = require('fs');
+const path = require('path');
+
+// ─── Cores no terminal ───────────────────────────────────────────────────────
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  gray: '\x1b[90m',
+  magenta: '\x1b[35m',
+};
+
+function log(msg) { console.log(msg); }
+function info(msg) { console.log(`${c.cyan}${msg}${c.reset}`); }
+function ok(msg) { console.log(`${c.green}✓ ${msg}${c.reset}`); }
+function warn(msg) { console.log(`${c.yellow}⚠ ${msg}${c.reset}`); }
+function err(msg) { console.error(`${c.red}✗ ${msg}${c.reset}`); }
+function bold(msg) { return `${c.bold}${msg}${c.reset}`; }
+
+// ─── Banner ──────────────────────────────────────────────────────────────────
+function banner() {
+  log('');
+  log(`${c.cyan}${c.bold}╔═══════════════════════════════════════════╗${c.reset}`);
+  log(`${c.cyan}${c.bold}║       GEN.IA OS — Setup Wizard v1.1       ║${c.reset}`);
+  log(`${c.cyan}${c.bold}║  Sistema operacional de dev com IA         ║${c.reset}`);
+  log(`${c.cyan}${c.bold}╚═══════════════════════════════════════════╝${c.reset}`);
+  log('');
+}
+
+// ─── Helpers de prompt ───────────────────────────────────────────────────────
+function prompt(rl, question, defaultVal) {
+  const hint = defaultVal ? ` ${c.gray}(${defaultVal})${c.reset}` : '';
+  return new Promise((resolve) => {
+    rl.question(`${c.cyan}?${c.reset} ${question}${hint}: `, (answer) => {
+      resolve(answer.trim() || defaultVal || '');
+    });
+  });
+}
+
+function promptChoice(rl, question, choices, defaultIdx = 0) {
+  log(`${c.cyan}?${c.reset} ${question}`);
+  choices.forEach((ch, i) => {
+    const marker = i === defaultIdx ? `${c.green}›${c.reset}` : ' ';
+    log(`  ${marker} ${i + 1}. ${ch}`);
+  });
+  return new Promise((resolve) => {
+    rl.question(`  ${c.gray}Escolha (1-${choices.length})${c.reset} [${defaultIdx + 1}]: `, (answer) => {
+      const idx = parseInt(answer.trim(), 10) - 1;
+      resolve((idx >= 0 && idx < choices.length) ? idx : defaultIdx);
+    });
+  });
+}
+
+// ─── Template substitution ───────────────────────────────────────────────────
+function applyVars(content, vars) {
+  let result = content;
+  for (const [key, value] of Object.entries(vars)) {
+    result = result.split(`{{${key}}}`).join(value);
+  }
+  return result;
+}
+
+// ─── Copiar template recursivamente ─────────────────────────────────────────
+function copyTemplate(srcDir, destDir, vars) {
+  if (!fs.existsSync(srcDir)) return;
+  fs.mkdirSync(destDir, { recursive: true });
+
+  for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+    const srcPath = path.join(srcDir, entry.name);
+    const destPath = path.join(destDir, entry.name);
+
+    if (entry.isDirectory()) {
+      copyTemplate(srcPath, destPath, vars);
+    } else {
+      const raw = fs.readFileSync(srcPath, 'utf8');
+      const processed = applyVars(raw, vars);
+      fs.writeFileSync(destPath, processed, 'utf8');
+    }
+  }
+}
+
+// ─── Main ────────────────────────────────────────────────────────────────────
+async function main() {
+  banner();
+
+  const projectArg = process.argv[2];
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  log(`${c.gray}Responda as perguntas abaixo para configurar seu GEN.IA OS.${c.reset}`);
+  log(`${c.gray}Pressione Enter para aceitar o valor padrão entre parênteses.${c.reset}`);
+  log('');
+
+  // ── Perguntas ──
+  const projectName = await prompt(rl, 'Nome do projeto', projectArg || 'meu-projeto');
+  const teamName    = await prompt(rl, 'Nome da equipe/empresa', 'Minha Equipe');
+  const creatorName = await prompt(rl, 'Seu nome', 'Desenvolvedor');
+  const githubUser  = await prompt(rl, 'GitHub username', 'usuario');
+  const githubRepo  = await prompt(rl, 'Nome do repositório GitHub', projectName);
+
+  log('');
+  const langIdx = await promptChoice(rl, 'Idioma principal do projeto', ['Português do Brasil (PT-BR)', 'English (EN)'], 0);
+  const language = langIdx === 0 ? 'PT-BR' : 'EN';
+
+  log('');
+  const stackIdx = await promptChoice(rl, 'Stack principal', [
+    'Next.js / React',
+    'Python / FastAPI',
+    'Node.js / Express',
+    'Flutter / Dart',
+    'Outra (configurar depois)',
+  ], 0);
+  const stacks = ['Next.js/React', 'Python/FastAPI', 'Node.js/Express', 'Flutter/Dart', 'Personalizada'];
+  const stack = stacks[stackIdx];
+
+  log('');
+  const initGit = await prompt(rl, 'Inicializar repositório git? (s/n)', 's');
+
+  rl.close();
+
+  // ── Validações ──
+  const targetDir = path.resolve(process.cwd(), projectName);
+  if (fs.existsSync(targetDir)) {
+    err(`Pasta '${projectName}' já existe. Escolha outro nome ou remova a pasta.`);
+    process.exit(1);
+  }
+
+  const today = new Date().toISOString().split('T')[0];
+
+  const vars = {
+    PROJECT_NAME:  projectName,
+    TEAM_NAME:     teamName,
+    CREATOR_NAME:  creatorName,
+    GITHUB_USER:   githubUser,
+    GITHUB_REPO:   githubRepo,
+    LANGUAGE:      language,
+    STACK:         stack,
+    SETUP_DATE:    today,
+    VERSION:       '1.0.0',
+  };
+
+  // ── Copiar template ──
+  log('');
+  info('Criando estrutura do GEN.IA OS...');
+
+  const templateDir = path.join(__dirname, '..', 'template');
+  copyTemplate(templateDir, targetDir, vars);
+  ok(`Projeto criado em ./${projectName}/`);
+
+  // ── Criar docs/ estrutura profissional obrigatória ──
+  const docsDirs = [
+    ['docs', 'stories'],
+    ['docs', 'handover'],
+    ['docs', 'produto'],
+    ['docs', 'tecnico', 'adr'],
+    ['docs', 'comercial'],
+  ];
+  for (const parts of docsDirs) {
+    fs.mkdirSync(path.join(targetDir, ...parts), { recursive: true });
+    fs.writeFileSync(path.join(targetDir, ...parts, '.gitkeep'), '');
+  }
+
+  // ── Criar squads/ estrutura ──
+  const squadsDirs = [
+    ['squads', 'advisory-board'],
+    ['squads', 'copy-squad'],
+    ['squads', 'hormozi-squad'],
+    ['squads', 'brand-squad'],
+    ['squads', 'clevel-squad'],
+    ['squads', 'data-squad'],
+  ];
+  for (const parts of squadsDirs) {
+    fs.mkdirSync(path.join(targetDir, ...parts), { recursive: true });
+    fs.writeFileSync(path.join(targetDir, ...parts, '.gitkeep'), '');
+  }
+
+  // ── Criar .genia/session/ ──
+  fs.mkdirSync(path.join(targetDir, '.genia', 'session'), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, '.genia', 'session-digests'), { recursive: true });
+  fs.writeFileSync(path.join(targetDir, '.genia', 'session', '.gitkeep'), '');
+  fs.writeFileSync(path.join(targetDir, '.genia', 'session-digests', '.gitkeep'), '');
+  ok('Estrutura docs/ profissional e squads/ criados');
+
+  // ── Criar .claude/agent-memory/squads/ ──
+  fs.mkdirSync(path.join(targetDir, '.claude', 'agent-memory', 'squads'), { recursive: true });
+  fs.writeFileSync(path.join(targetDir, '.claude', 'agent-memory', 'squads', '.gitkeep'), '');
+  ok('Diretórios de memória e sessão criados');
+
+  // ── Git init ──
+  if (initGit.toLowerCase() !== 'n') {
+    try {
+      const { execSync } = require('child_process');
+      execSync('git init', { cwd: targetDir, stdio: 'ignore' });
+      execSync('git add .', { cwd: targetDir, stdio: 'ignore' });
+      execSync(`git commit -m "chore: GEN.IA OS v1.1 — setup inicial\n\nCo-Authored-By: GEN.IA OS <genia@bedata.com.br>"`, {
+        cwd: targetDir, stdio: 'ignore',
+      });
+      ok('Repositório git inicializado com commit inicial');
+    } catch {
+      warn('Git init falhou. Inicialize manualmente: git init && git add . && git commit');
+    }
+  }
+
+  // ── Sucesso ──
+  log('');
+  log(`${c.green}${c.bold}╔═══════════════════════════════════════════╗${c.reset}`);
+  log(`${c.green}${c.bold}║        GEN.IA OS pronto para uso! 🚀      ║${c.reset}`);
+  log(`${c.green}${c.bold}╚═══════════════════════════════════════════╝${c.reset}`);
+  log('');
+  log(bold('Próximos passos:'));
+  log('');
+  log(`  ${c.cyan}1.${c.reset} Abra o projeto no VS Code com Claude Code:`);
+  log(`     ${c.gray}cd ${projectName} && code .${c.reset}`);
+  log('');
+  log(`  ${c.cyan}2.${c.reset} Inicie uma conversa e chame um agente:`);
+  log(`     ${c.gray}"@sm crie a primeira story do projeto"${c.reset}`);
+  log('');
+  log(`  ${c.cyan}3.${c.reset} Leia a documentação:`);
+  log(`     ${c.gray}README.md${c.reset}`);
+  log('');
+  log(`${c.gray}Documentação: https://github.com/elidyizzy/GENIA-SQUAD-OS${c.reset}`);
+  log('');
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});

package/package.json

@@ -1,42 +1,40 @@
-{
-  "name": "create-genia-os",
-  "version": "2.0.0",
-  "description": "GEN.IA OS — Sistema operacional de desenvolvimento com IA para Claude Code. Instala 9 agentes especializados, Synapse Engine e governança automática direto do repositório oficial.",
-  "keywords": [
-    "claude-code",
-    "ai",
-    "artificial-intelligence",
-    "desenvolvimento",
-    "agentes",
-    "squads",
-    "genia",
-    "claude",
-    "anthropic",
-    "developer-tools",
-    "pt-br",
-    "create"
-  ],
-  "author": "Elidy Izidio <elidyizidio@gmail.com>",
-  "license": "MIT",
-  "homepage": "https://github.com/elidyizzy/GENIA-SQUAD-OS#readme",
-  "bugs": {
-    "url": "https://github.com/elidyizzy/GENIA-SQUAD-OS/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/elidyizzy/GENIA-SQUAD-OS.git",
-    "directory": ".Apps/create-genia-os"
-  },
-  "bin": {
-    "create-genia-os": "./bin/create.js"
-  },
-  "files": [
-    "bin/"
-  ],
-  "dependencies": {
-    "fs-extra": "^11.2.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "create-genia-os",
+  "version": "2.1.1",
+  "description": "GEN.IA OS — Transforma o Claude Code em um time completo de especialistas. 9 agentes de desenvolvimento + Squads Xquads de negócio, Synapse Engine, governança automática e docs profissional obrigatório.",
+  "keywords": [
+    "claude-code",
+    "ai",
+    "artificial-intelligence",
+    "desenvolvimento",
+    "agentes",
+    "squads",
+    "xquads",
+    "genia",
+    "claude",
+    "anthropic",
+    "developer-tools",
+    "synapse-engine",
+    "governance",
+    "pt-br"
+  ],
+  "author": "Elidy Izidio <elidyizidio@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/elidyizzy/GENIA-SQUAD-OS#readme",
+  "bugs": {
+    "url": "https://github.com/elidyizzy/GENIA-SQUAD-OS/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elidyizzy/GENIA-SQUAD-OS.git",
+    "directory": "packages/create-genia-os"
+  },
+  "bin": "./bin/index.js",
+  "files": [
+    "bin/",
+    "template/"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/template/.claude/CLAUDE.md

@@ -0,0 +1,215 @@
+# GEN.IA OS — Master Instructions
+
+> Sistema operacional de desenvolvimento assistido por IA
+> {{TEAM_NAME}} | {{CREATOR_NAME}} | v1.0 | Idioma: Português do Brasil
+
+---
+
+## Identidade e Ativação Automática
+
+**Em TODA tarefa**, antes de responder:
+1. Identificar a fase: Planning / Development / QA / Delivery
+2. Assumir o agente apropriado
+3. Anunciar: `[@agente] [Nome] iniciando...`
+4. Ler `.claude/agent-memory/[agente]/MEMORY.md`
+5. Seguir as regras de `.claude/rules/`
+
+---
+
+## Constituição (6 Artigos)
+
+| Artigo | Nome | Severidade | Regra |
+|--------|------|-----------|-------|
+| I | CLI First | **BLOQUEIO** | Claude Code é fonte de verdade |
+| II | Autoridade do Agente | **BLOQUEIO** | @devops = único com push; @sm = único cria stories |
+| III | Story-Driven | **OBRIG** | Zero código sem story aprovada por @po |
+| IV | Sem Invenção | **OBRIG** | Apenas features dos requisitos explícitos |
+| V | Qualidade Primeiro | **OBRIG** | Lint + testes + build devem passar |
+| VI | Imports Absolutos | INFO | Sempre `@/`, nunca `../../../` |
+
+---
+
+## Os 9 Agentes
+
+| Comando | Nome | Papel | Autoridade Exclusiva |
+|---------|------|-------|---------------------|
+| `@analyst` | Ana | Analista de Negócios | Briefing, requisitos, pesquisa |
+| `@pm` | Marina | Product Manager | PRD, épicos, escopo |
+| `@architect` | Arqui | Arquiteta de Sistemas | Arquitetura, VETO técnico |
+| `@dev` | Dev | Desenvolvedor Full Stack | Implementação (SEM push) |
+| `@devops` | Gate | DevOps Engineer | **git push, PR, release, MCP** |
+| `@qa` | Quinn | QA Engineer | Veredictos de qualidade |
+| `@reviewer` | Rev | Code Reviewer | Aprovação de código |
+| `@po` | Pax | Product Owner | **Aprovação de stories** |
+| `@sm` | Sami | Scrum Master | **Criação de stories** |
+
+### Workflow do SQUAD
+
+```
+PLANNING                           DEVELOPMENT                    QA / DELIVERY
+@analyst → @pm → @architect → @po → @sm → @dev → @qa → @reviewer → @devops
+[Briefing] [PRD]  [SPEC]      [Val] [Story] [Código] [Teste] [Review]  [Push/PR]
+```
+
+---
+
+## Estrutura do Projeto
+
+```
+GENIA - SQUAD - OS/
+├── .claude/                    ← Integração Claude Code (este diretório)
+│   ├── CLAUDE.md               ← Este arquivo
+│   ├── hooks/                  ← 5 hooks de governança
+│   ├── rules/                  ← 7 arquivos de regras
+│   ├── agents/                 ← Slash commands dos agentes
+│   ├── agent-memory/           ← MEMORY.md por agente
+│   └── settings.json           ← Permissões e hooks config
+│
+├── .genia/                     ← Framework core
+│   ├── CONSTITUTION.md         ← Constituição completa
+│   ├── core-config.yaml        ← Configuração central
+│   ├── development/
+│   │   ├── agents/             ← 9 definições completas
+│   │   ├── workflows/          ← 8 workflows
+│   │   ├── tasks/              ← 7 tasks reutilizáveis
+│   │   └── checklists/         ← 5 checklists
+│   ├── skills/                 ← Capacidades especializadas
+│   ├── contexts/               ← Bases de conhecimento
+│   └── guidelines/             ← Padrões de código
+│
+├── .synapse/                   ← Runtime do Synapse Engine
+│   ├── manifest                ← Registry de domínios
+│   ├── constitution            ← L0 (sempre ativa)
+│   ├── global                  ← L1 (sempre ativa)
+│   ├── context                 ← L1 (sempre ativa)
+│   └── agent-*/                ← L2 (por agente detectado)
+│
+├── Apps/                       ← Projetos de apps
+├── docs/                       ← Documentação de projetos
+│   └── stories/                ← STORY-NNN-slug.md
+└── .gitignore
+```
+
+---
+
+## Hooks de Governança Ativos
+
+| Hook | Trigger | Ação |
+|------|---------|------|
+| `synapse-engine.cjs` | UserPromptSubmit | Injeta contexto em cada prompt |
+| `precompact-session-digest.cjs` | PreCompact | Salva digest antes de compactar |
+| `enforce-git-push-authority.py` | PreToolUse(Bash) | BLOQUEIA push não-devops |
+| `write-path-validation.py` | PreToolUse(Write) | Avisa sobre paths incorretos |
+| `sql-governance.py` | PreToolUse(Bash) | BLOQUEIA DDL SQL perigoso |
+
+---
+
+## Push Protocol — OBRIGATÓRIO
+
+**Sempre que houver necessidade de git push**, antes de executar qualquer coisa:
+
+1. Perguntar: _"Deseja invocar @devops (Gate) para fazer o push?"_
+2. Se sim → ativar @devops e executar o protocolo abaixo
+3. Se não → informar que o push deve ser feito manualmente no terminal
+
+### Protocolo @devops para push
+
+```
+[@devops] Gate iniciando push...
+1. Criar flag: Write → .genia/session/devops-active (conteúdo: "authorized")
+2. Executar: git push [args]
+3. Hook enforce-git-push-authority.py lê o flag, consome e permite
+4. Reportar resultado
+```
+
+> O flag é de **uso único** — consumido automaticamente pelo hook após o push.
+> Force push (`--force`, `-f`) requer confirmação explícita da usuária.
+
+---
+
+## Story-Driven Development
+
+**Todo código começa em uma story.**
+
+```
+STORY-NNN estados: Draft → Ready → InProgress → InReview → Done
+```
+
+- @sm cria → @po valida → @dev implementa → @qa testa → @reviewer revisa → @devops push
+- Stories em: `docs/stories/STORY-NNN-slug.md`
+- Aprovação de @po obrigatória antes de @dev codar
+
+---
+
+## Padrões de Código
+
+### Git
+- **Commits**: `tipo(escopo): descrição` (conventional commits)
+- **Tipos**: feat, fix, docs, refactor, test, chore, perf
+- **Branch**: `tipo/STORY-NNN-slug`
+- **Co-author**: `Co-Authored-By: GEN.IA OS <genia@bedata.com.br>`
+- **NUNCA** commitar `.env` ou credenciais
+
+### Imports
+- Sempre usar imports absolutos: `@/components/Button`
+- Nunca: `../../../components/Button`
+
+### Padrões gerais
+- TypeScript: tipagem explícita em APIs públicas
+- Funções: máximo 50 linhas; extrair se maior
+- Nomes: `camelCase` para funções/vars, `PascalCase` para classes/tipos
+- Testes: cobertura >80% para novo código
+
+---
+
+## Ferramentas — Prioridade
+
+```
+1. Ferramentas nativas Claude Code (Read, Write, Edit, Grep, Glob, Bash)
+2. MCP configurado (gerenciado por @devops)
+3. CLI tools via Bash
+```
+
+**Nunca** usar Bash para ler/escrever/buscar arquivos — usar Read/Write/Edit/Grep/Glob.
+
+---
+
+## Uso de Memória
+
+- Cada agente tem `MEMORY.md` em `.claude/agent-memory/[agente]/`
+- Ler ao ativar, atualizar ao descobrir padrões importantes
+- Formato: Padrões Confirmados | Preferências | Gotchas | Decisões
+
+---
+
+## Contextos Disponíveis
+
+Carregar quando relevante: `@load-context [nome]`
+
+| Contexto | Conteúdo |
+|----------|---------|
+| `kommo-crm` | API Kommo, endpoints, IDs, autenticação |
+| `supabase` | Supabase patterns, RLS, Edge Functions |
+| `whatsapp-cloud` | WhatsApp Cloud API, webhooks |
+| `nextjs-react` | Next.js 14+, React patterns, App Router |
+| `api-patterns` | REST, autenticação, rate limiting |
+
+---
+
+## Skills Disponíveis
+
+| Skill | Comando | Descrição |
+|-------|---------|-----------|
+| PDF | `/pdf` | Extrair, mesclar, preencher formulários |
+| Excel | `/xlsx` | Criar planilhas com fórmulas |
+| Word | `/docx` | Criar e editar documentos Word |
+| PowerPoint | `/pptx` | Criar apresentações |
+| Frontend Design | `/frontend-design` | Design de interfaces |
+| Canvas Design | `/canvas-design` | Design gráfico |
+| MCP Builder | `/mcp-builder` | Criar servidores MCP |
+| Webapp Testing | `/webapp-testing` | Testes de aplicações web |
+
+---
+
+_GEN.IA OS v1.0 — {{TEAM_NAME}} — {{CREATOR_NAME}}_
+_Baseado em AIOS Core (MIT License, SynkraAI) — Adaptado e reescrito_