@lucapimenta/copy-chief-black 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Luca Pimenta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,185 @@
+<p align="center">
+  <h1 align="center">Copy Chief BLACK</h1>
+  <p align="center">
+    <strong>Direct Response Copywriting Framework for Claude Code</strong>
+  </p>
+  <p align="center">
+    <a href="#installation">Installation</a> •
+    <a href="#features">Features</a> •
+    <a href="#architecture">Architecture</a> •
+    <a href="./README.md">Portugues</a> •
+    <a href="./docs/getting-started.md">Getting Started</a>
+  </p>
+  <p align="center">
+    <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen" alt="Node">
+    <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue" alt="Platform">
+    <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
+    <img src="https://img.shields.io/badge/version-1.0.0-orange" alt="Version">
+  </p>
+</p>
+
+---
+
+## What is it
+
+Copy Chief BLACK is a complete Direct Response copywriting framework that runs on Claude Code. It turns Claude into a **team of 12 specialists** (Copy Squad) with an automated pipeline, MCP-powered quality gates, and parallel production of VSLs, Landing Pages, Creatives, and Emails.
+
+### One command to install everything:
+
+```bash
+npx @lucapimenta/copy-chief-black install
+```
+
+## Features
+
+### Copy Squad — 12 Specialized Personas
+
+| Persona | Handle | Specialty |
+|---------|--------|-----------|
+| Helix | @chief | Orchestration and routing |
+| Vox | @researcher | VOC research, avatar, market |
+| Cipher | @miner | Ads spy, scale score, patterns |
+| Atlas | @briefer | HELIX System briefing (10 phases) |
+| Echo | @vsl | VSL production |
+| Forge | @lp | Landing pages (14 blocks) |
+| Scout | @creative | Ad creatives |
+| Blade | @producer | Emails, generic copy |
+| Hawk | @critic | Validation and review |
+| Sentinel | @gatekeeper | Quality gates |
+| Ops | @ops | Git, deploy, infra |
+| Strategist | @strategist | Portfolio strategy |
+
+### Synapse Engine (8 layers)
+
+Context engine that automatically injects domain rules:
+- **L0** Constitution — Non-negotiable principles
+- **L1** Domain Rules — DRE, HELIX, mechanism, anti-homogenization
+- **L2** Agent Rules — Per-persona rules
+- **L6** Keyword Recall — Keyword-triggered activation
+- **L7** Quality Gates — Automatic validation
+
+### Automated Pipeline
+
+```
+Research → Briefing → Production → Validation → Delivery
+   |          |           |            |            |
+  Vox      Atlas    Echo/Forge/     Hawk +       Final
+            +       Scout/Blade    MCP Gates    Package
+          Cipher
+```
+
+### MCP Quality Gates
+
+10 integrated validation tools:
+- `validate_gate` — Advance pipeline phase
+- `blind_critic` — Blind critique (no context)
+- `emotional_stress_test` — Emotional stress test
+- `black_validation` — Final BLACK validation
+- `semantic_memory_search` — Semantic swipe search
+- `layered_review` — Layered review
+- And 4 more specialized tools
+
+### 30+ Automated Hooks
+
+Thin wrappers that orchestrate the pipeline:
+- **SessionStart** — Orchestrator boot, health check, context loading
+- **SubagentStart** — Persona activation, deps, offer context
+- **SubagentStop** — Contract validation, chaining, memory writeback
+- **PreToolUse** — Circuit breaker, authority gate, story validation
+- **PostToolUse** — State recording, gate auto-advance
+- **UserPromptSubmit** — Intent detection, dispatch queue
+
+### 77 Production Templates
+
+Ready-to-use templates for VSL, Landing Page, Creatives, Emails — validated in real campaigns.
+
+## Installation
+
+### Requirements
+
+- Node.js >= 18
+- Git
+- Claude Code (`npm install -g @anthropic-ai/claude-code`)
+
+### Install everything (Core + MCP + Dashboard)
+
+```bash
+npx @lucapimenta/copy-chief-black install-all
+```
+
+### Install core only
+
+```bash
+npx @lucapimenta/copy-chief-black install
+```
+
+### Verify installation
+
+```bash
+npx @lucapimenta/copy-chief-black doctor
+```
+
+### Create new offer
+
+```bash
+npx @lucapimenta/copy-chief-black new-offer health my-product
+```
+
+## Architecture
+
+```
+~/.claude/                              Installed by framework
+  .aios-core/                           Synapse engine + modules
+    core/synapse/                       8-layer engine
+    copy-chief/                         ~55 domain modules
+  hooks/                                30+ thin wrappers
+  agents/                               12 persona files
+  copy-squad/                           28 expert clones
+  skills/                               Slash commands
+  knowledge/                            Frameworks, VOC, patterns
+  templates/                            77 production templates
+  workflows/                            Pipeline YAMLs
+  schemas/                              Validation schemas
+
+~/copywriting-ecosystem/                Your workspace
+  .synapse/                             Domain rules
+  squads/copy-chief/                    Squad manifest
+  health/florayla/                      Offer 1
+  ...
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `install` | Install framework to ~/.claude/ |
+| `install-all` | Install core + MCP server + dashboard |
+| `update` | Update preserving customizations |
+| `verify` | Verify installation integrity |
+| `doctor` | Diagnose environment issues |
+| `new-offer <niche> <name>` | Scaffold new offer project |
+
+## Related Packages
+
+| Package | Description | Repo |
+|---------|-------------|------|
+| `@lucapimenta/copy-chief-dashboard` | Next.js Dashboard (pipeline, kanban, helix) | [copy-chief-dashboard](https://github.com/lckx777/copy-chief-dashboard) |
+| `@lucapimenta/copywriting-mcp` | MCP Server (10 quality tools, SQLite) | [copywriting-mcp](https://github.com/lckx777/copywriting-mcp) |
+
+## Documentation
+
+- [Getting Started](./docs/getting-started.md) — First value in 10 minutes
+- [User Guide](./docs/guides/user-guide.md) — Complete reference
+- [Copy Squad](./docs/guides/squad-guide.md) — How to use 12 agents
+- [HELIX System](./docs/guides/helix-guide.md) — 10-phase briefing
+- [macOS Installation](./docs/installation/macos.md)
+- [Linux Installation](./docs/installation/linux.md)
+- [Windows Installation](./docs/installation/windows.md)
+
+## License
+
+MIT License — see [LICENSE](./LICENSE)
+
+## Author
+
+**Luca Pimenta** — [@lckx777](https://github.com/lckx777)

package/README.md

@@ -0,0 +1,211 @@
+<p align="center">
+  <h1 align="center">Copy Chief BLACK</h1>
+  <p align="center">
+    <strong>Framework de Copywriting Direct Response para Claude Code</strong>
+  </p>
+  <p align="center">
+    <a href="#instalacao">Instalacao</a> •
+    <a href="#funcionalidades">Funcionalidades</a> •
+    <a href="#arquitetura">Arquitetura</a> •
+    <a href="./README.en.md">English</a> •
+    <a href="./docs/getting-started.md">Getting Started</a>
+  </p>
+  <p align="center">
+    <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen" alt="Node">
+    <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue" alt="Platform">
+    <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
+    <img src="https://img.shields.io/badge/version-1.0.0-orange" alt="Version">
+  </p>
+</p>
+
+---
+
+## O que e
+
+Copy Chief BLACK e um framework completo de copywriting Direct Response que roda sobre o Claude Code. Ele transforma o Claude em um **time de 12 especialistas** (Copy Squad) com pipeline automatizado, quality gates via MCP, e producao paralela de VSLs, Landing Pages, Criativos e Emails.
+
+### Um comando para instalar tudo:
+
+```bash
+npx @lucapimenta/copy-chief-black install
+```
+
+## Funcionalidades
+
+### Copy Squad — 12 Personas Especializadas
+
+| Persona | Handle | Especialidade |
+|---------|--------|--------------|
+| Helix | @chief | Orquestracao e routing |
+| Vox | @researcher | Pesquisa VOC, avatar, mercado |
+| Cipher | @miner | Ads spy, scale score, patterns |
+| Atlas | @briefer | Briefing HELIX System (10 fases) |
+| Echo | @vsl | Producao de VSL |
+| Forge | @lp | Landing pages (14 blocos) |
+| Scout | @creative | Criativos para ads |
+| Blade | @producer | Emails, copy generica |
+| Hawk | @critic | Validacao e review |
+| Sentinel | @gatekeeper | Quality gates |
+| Ops | @ops | Git, deploy, infra |
+| Strategist | @strategist | Estrategia de portfolio |
+
+### Synapse Engine (8 camadas)
+
+Motor de contexto que injeta regras de dominio automaticamente:
+- **L0** Constitution — Principios inegociaveis
+- **L1** Domain Rules — DRE, HELIX, mecanismo, anti-homogeneizacao
+- **L2** Agent Rules — Regras per-persona
+- **L6** Keyword Recall — Ativacao por palavras-chave
+- **L7** Quality Gates — Validacao automatica
+
+### Pipeline Automatizado
+
+```
+Research → Briefing → Production → Validation → Delivery
+   |          |           |            |            |
+  Vox      Atlas    Echo/Forge/     Hawk +       Final
+            +       Scout/Blade    MCP Gates    Package
+          Cipher
+```
+
+### Quality Gates via MCP
+
+10 ferramentas de validacao integradas:
+- `validate_gate` — Avanca fase do pipeline
+- `blind_critic` — Critica cega (sem contexto)
+- `emotional_stress_test` — Teste de estresse emocional
+- `black_validation` — Validacao final BLACK
+- `semantic_memory_search` — Busca semantica em swipes
+- `layered_review` — Review em camadas
+- E mais 4 ferramentas especializadas
+
+### 30+ Hooks Automatizados
+
+Thin wrappers que orquestram o pipeline:
+- **SessionStart** — Boot do orquestrador, health check, context loading
+- **SubagentStart** — Ativacao de persona, deps, offer context
+- **SubagentStop** — Validacao de contratos, chaining, memory writeback
+- **PreToolUse** — Circuit breaker, authority gate, story validation
+- **PostToolUse** — State recording, gate auto-advance
+- **UserPromptSubmit** — Intent detection, dispatch queue
+
+### 77 Templates de Producao
+
+Templates prontos para VSL, Landing Page, Criativos, Emails — validados em campanhas reais.
+
+## Instalacao
+
+### Requisitos
+
+- Node.js >= 18
+- Git
+- Claude Code (`npm install -g @anthropic-ai/claude-code`)
+
+### Instalar tudo (Core + MCP + Dashboard)
+
+```bash
+npx @lucapimenta/copy-chief-black install-all
+```
+
+### Instalar apenas o Core
+
+```bash
+npx @lucapimenta/copy-chief-black install
+```
+
+### Verificar instalacao
+
+```bash
+npx @lucapimenta/copy-chief-black doctor
+```
+
+### Criar nova oferta
+
+```bash
+npx @lucapimenta/copy-chief-black new-offer saude meu-produto
+```
+
+## Arquitetura
+
+```
+~/.claude/                              Instalado pelo framework
+  .aios-core/                           Synapse engine + modulos
+    core/synapse/                       Motor de 8 camadas
+    copy-chief/                         ~55 modulos de dominio
+      state/                            Session state, offer state
+      gates/                            Quality gates, validation
+      workflow/                         HELIX phases, skill triggers
+      orchestration/                    Routing, offer scanner
+      execution/                        Prompt builder, workflow executor
+      memory/                           Agent memory, writeback
+      dispatch/                         Auto-dispatch queue
+      ...
+  hooks/                                30+ thin wrappers (.cjs + .js)
+  agents/                               12 persona files (.md)
+  copy-squad/                           28 expert clones
+  skills/                               Slash commands
+  knowledge/                            Frameworks, VOC, patterns
+  templates/                            77 production templates
+  workflows/                            Pipeline YAMLs
+  schemas/                              Validation schemas
+  config/                               Framework configuration
+  commands/                             Custom commands
+
+~/copywriting-ecosystem/                Seu workspace
+  .synapse/                             Domain rules
+  squads/copy-chief/                    Squad manifest
+  saude/florayla/                       Oferta 1
+  saude/neuvelys/                       Oferta 2
+  relacionamento/quimica-amarracao/     Oferta 3
+  ...
+```
+
+## Comandos CLI
+
+| Comando | Descricao |
+|---------|-----------|
+| `install` | Instala framework em ~/.claude/ |
+| `install-all` | Instala core + MCP server + dashboard |
+| `update` | Atualiza preservando customizacoes |
+| `verify` | Verifica integridade da instalacao |
+| `doctor` | Diagnostica problemas de ambiente |
+| `new-offer <nicho> <nome>` | Cria scaffold de oferta nova |
+
+## Pacotes Relacionados
+
+| Pacote | Descricao | Repo |
+|--------|-----------|------|
+| `@lucapimenta/copy-chief-dashboard` | Dashboard Next.js (pipeline, kanban, helix) | [copy-chief-dashboard](https://github.com/lckx777/copy-chief-dashboard) |
+| `@lucapimenta/copywriting-mcp` | MCP server (10 quality tools, SQLite) | [copywriting-mcp](https://github.com/lckx777/copywriting-mcp) |
+
+## Documentacao
+
+- [Getting Started](./docs/getting-started.md) — Primeiro valor em 10 minutos
+- [Guia do Usuario](./docs/guides/user-guide.md) — Referencia completa
+- [Copy Squad](./docs/guides/squad-guide.md) — Como usar os 12 agentes
+- [HELIX System](./docs/guides/helix-guide.md) — Briefing em 10 fases
+- [Instalacao macOS](./docs/installation/macos.md)
+- [Instalacao Linux](./docs/installation/linux.md)
+- [Instalacao Windows](./docs/installation/windows.md)
+
+## Suporte a Plataformas
+
+| Plataforma | Metodo | Notas |
+|------------|--------|-------|
+| macOS | `npx @lucapimenta/copy-chief-black install` | Plataforma primaria |
+| Linux | `npx @lucapimenta/copy-chief-black install` | Ubuntu, Debian, Fedora |
+| Windows | `npx @lucapimenta/copy-chief-black install` | Via Node.js cross-platform |
+
+## Licenca
+
+MIT License — veja [LICENSE](./LICENSE)
+
+## Autor
+
+**Luca Pimenta** — [@lckx777](https://github.com/lckx777)
+
+---
+
+<p align="center">
+  <sub>Copy Chief BLACK — Framework de Copywriting Direct Response para Claude Code</sub>
+</p>

package/bin/cli.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+/**
+ * Copy Chief BLACK — CLI Entry Point
+ * Usage: npx @lucapimenta/copy-chief-black <command>
+ */
+'use strict';
+
+const { Command } = require('commander');
+const path = require('path');
+const pkg = require('../package.json');
+
+const program = new Command();
+
+program
+  .name('copy-chief-black')
+  .description('Copy Chief BLACK — Direct Response Copywriting Framework for Claude Code')
+  .version(pkg.version);
+
+program
+  .command('install')
+  .description('Install Copy Chief BLACK framework into ~/.claude/')
+  .option('--force', 'Overwrite existing installation')
+  .option('--no-backup', 'Skip backup of existing ~/.claude/')
+  .option('--ecosystem <path>', 'Custom ecosystem root path')
+  .action(async (opts) => {
+    const { install } = require('../installer/install');
+    await install(opts);
+  });
+
+program
+  .command('update')
+  .description('Update framework preserving customizations')
+  .option('--force', 'Force update even if versions match')
+  .action(async (opts) => {
+    const { update } = require('../installer/update');
+    await update(opts);
+  });
+
+program
+  .command('verify')
+  .description('Verify installation integrity')
+  .option('--fix', 'Attempt to fix issues found')
+  .action(async (opts) => {
+    const { verify } = require('../installer/verify');
+    await verify(opts);
+  });
+
+program
+  .command('doctor')
+  .description('Diagnose environment and configuration issues')
+  .action(async () => {
+    const { doctor } = require('../installer/doctor');
+    await doctor();
+  });
+
+program
+  .command('new-offer <niche> <name>')
+  .description('Scaffold a new offer project')
+  .option('--template <type>', 'Offer template (vsl, quiz, webinar)', 'vsl')
+  .action(async (niche, name, opts) => {
+    const { newOffer } = require('../installer/new-offer');
+    await newOffer(niche, name, opts);
+  });
+
+program
+  .command('install-all')
+  .description('Install everything: core + MCP server + dashboard')
+  .option('--force', 'Overwrite existing installation')
+  .option('--no-backup', 'Skip backup')
+  .option('--ecosystem <path>', 'Custom ecosystem root path')
+  .option('--skip-dashboard', 'Skip dashboard installation')
+  .action(async (opts) => {
+    const { install } = require('../installer/install');
+    await install(opts);
+
+    // MCP Server
+    console.log('\n--- Installing Copywriting MCP Server ---\n');
+    const { execSync } = require('child_process');
+    try {
+      execSync('npx @lucapimenta/copywriting-mcp install', { stdio: 'inherit' });
+    } catch {
+      console.log('⚠️  MCP install failed. Run separately: npx @lucapimenta/copywriting-mcp install');
+    }
+
+    // Dashboard (optional)
+    if (!opts.skipDashboard) {
+      console.log('\n--- Installing Copy Chief Dashboard ---\n');
+      try {
+        execSync('npx @lucapimenta/copy-chief-dashboard install', { stdio: 'inherit' });
+      } catch {
+        console.log('⚠️  Dashboard install failed. Run separately: npx @lucapimenta/copy-chief-dashboard install');
+      }
+    }
+
+    console.log('\n✅ Full installation complete!');
+  });
+
+program.parse();

package/framework/.aios-core/.dispatch-iterations.json

@@ -0,0 +1,8 @@
+{
+  "dispatch-001": {
+    "dispatch_id": "dispatch-001",
+    "iteration_count": 1,
+    "max_iterations": 3,
+    "timestamp": 1772649545829
+  }
+}

package/framework/.aios-core/constitution.md

@@ -0,0 +1,171 @@
+# Synkra AIOS Constitution
+
+> **Version:** 1.0.0 | **Ratified:** 2025-01-30 | **Last Amended:** 2025-01-30
+
+Este documento define os princípios fundamentais e inegociáveis do Synkra AIOS. Todos os agentes, tasks, e workflows DEVEM respeitar estes princípios. Violações são bloqueadas automaticamente via gates.
+
+---
+
+## Core Principles
+
+### I. CLI First (NON-NEGOTIABLE)
+
+O CLI é a fonte da verdade onde toda inteligência, execução, e automação vivem.
+
+**Regras:**
+- MUST: Toda funcionalidade nova DEVE funcionar 100% via CLI antes de qualquer UI
+- MUST: Dashboards apenas observam, NUNCA controlam ou tomam decisões
+- MUST: A UI NUNCA é requisito para operação do sistema
+- MUST: Ao decidir onde implementar, sempre CLI > Observability > UI
+
+**Hierarquia:**
+```
+CLI (Máxima) → Observability (Secundária) → UI (Terciária)
+```
+
+**Gate:** `dev-develop-story.md` - WARN se UI criada antes de CLI funcional
+
+---
+
+### II. Agent Authority (NON-NEGOTIABLE)
+
+Cada agente tem autoridades exclusivas que não podem ser violadas.
+
+**Regras:**
+- MUST: Apenas @devops pode executar `git push` para remote
+- MUST: Apenas @devops pode criar Pull Requests
+- MUST: Apenas @devops pode criar releases e tags
+- MUST: Agentes DEVEM delegar para o agente apropriado quando fora de seu escopo
+- MUST: Nenhum agente pode assumir autoridade de outro
+
+**Exclusividades:**
+
+| Autoridade | Agente Exclusivo |
+|------------|------------------|
+| git push | @devops |
+| PR creation | @devops |
+| Release/Tag | @devops |
+| Story creation | @sm, @po |
+| Architecture decisions | @architect |
+| Quality verdicts | @qa |
+
+**Gate:** Implementado via definição de agentes (não requer gate adicional)
+
+---
+
+### III. Story-Driven Development (MUST)
+
+Todo desenvolvimento começa e termina com uma story.
+
+**Regras:**
+- MUST: Nenhum código é escrito sem uma story associada
+- MUST: Stories DEVEM ter acceptance criteria claros antes de implementação
+- MUST: Progresso DEVE ser rastreado via checkboxes na story
+- MUST: File List DEVE ser mantida atualizada na story
+- SHOULD: Stories seguem o workflow: @po/@sm cria → @dev implementa → @qa valida → @devops push
+
+**Gate:** `dev-develop-story.md` - BLOCK se não houver story válida
+
+---
+
+### IV. No Invention (MUST)
+
+Especificações não inventam - apenas derivam dos requisitos.
+
+**Regras:**
+- MUST: Todo statement em spec.md DEVE rastrear para:
+  - Um requisito funcional (FR-*)
+  - Um requisito não-funcional (NFR-*)
+  - Uma constraint (CON-*)
+  - Um finding de research (verificado e documentado)
+- MUST NOT: Adicionar features não presentes nos requisitos
+- MUST NOT: Assumir detalhes de implementação não pesquisados
+- MUST NOT: Especificar tecnologias não validadas
+
+**Gate:** `spec-write-spec.md` - BLOCK se spec contiver invenções
+
+---
+
+### V. Quality First (MUST)
+
+Qualidade não é negociável. Todo código passa por múltiplos gates antes de merge.
+
+**Regras:**
+- MUST: `npm run lint` passa sem erros
+- MUST: `npm run typecheck` passa sem erros
+- MUST: `npm test` passa sem falhas
+- MUST: `npm run build` completa com sucesso
+- MUST: CodeRabbit não reporta issues CRITICAL
+- MUST: Story status é "Done" ou "Ready for Review"
+- SHOULD: Cobertura de testes não diminui
+
+**Gate:** `pre-push.md` - BLOCK se qualquer check falhar
+
+---
+
+### VI. Absolute Imports (SHOULD)
+
+Imports relativos criam acoplamento e dificultam refatoração.
+
+**Regras:**
+- SHOULD: Sempre usar imports absolutos com alias `@/`
+- SHOULD NOT: Usar imports relativos (`../../../`)
+- EXCEPTION: Imports dentro do mesmo módulo/feature podem ser relativos
+
+**Exemplo:**
+```typescript
+// CORRETO
+import { useStore } from '@/stores/feature/store'
+
+// INCORRETO
+import { useStore } from '../../../stores/feature/store'
+```
+
+**Gate:** ESLint rule (já implementado)
+
+---
+
+## Governance
+
+### Amendment Process
+
+1. Proposta de mudança documentada com justificativa
+2. Review por @architect e @po
+3. Aprovação requer consenso
+4. Mudança implementada com atualização de versão
+5. Propagação para templates e tasks dependentes
+
+### Versioning
+
+- **MAJOR:** Remoção ou redefinição incompatível de princípio
+- **MINOR:** Novo princípio ou expansão significativa
+- **PATCH:** Clarificações, correções de texto, refinamentos
+
+### Compliance
+
+- Todos os PRs DEVEM verificar compliance com Constitution
+- Gates automáticos BLOQUEIAM violações de princípios NON-NEGOTIABLE
+- Gates automáticos ALERTAM violações de princípios MUST
+- Violações de SHOULD são reportadas mas não bloqueiam
+
+### Gate Severity Levels
+
+| Severidade | Comportamento | Uso |
+|------------|---------------|-----|
+| BLOCK | Impede execução, requer correção | NON-NEGOTIABLE, MUST críticos |
+| WARN | Permite continuar com alerta | MUST não-críticos |
+| INFO | Apenas reporta | SHOULD |
+
+---
+
+## References
+
+- **Princípios derivados de:** `.claude/CLAUDE.md`
+- **Inspirado por:** GitHub Spec-Kit Constitution System
+- **Gates implementados em:** `.aios-core/development/tasks/`
+- **Checklists relacionados:** `.aios-core/product/checklists/`
+
+---
+
+*Synkra AIOS Constitution v1.0.0*
+*CLI First | Agent-Driven | Quality First*