agent-master-devsecops 0.0.0-stage → 3.9.0

package/.cursorignore

@@ -0,0 +1,23 @@
+# .cursorignore - Blindagem de Contexto e Redução de Tokens para Agentes de IA
+# Impede a indexação vetorial (RAG) de arquivos utilitários, testes internos e documentação estática,
+# reduzindo custos em até ~35.000 tokens por sessão sem apagar nenhum arquivo físico.
+
+# 1. Suíte de Testes Unitários (Executados via Node.js, não precisam poluir contexto da LLM)
+test/
+*.test.js
+
+# 2. Artefatos de Build e Bookmarklets de Browser
+dist/
+dist/**
+*.html
+
+# 3. Baselines de Benchmark Numérico
+benchmarks/
+*.baseline.json
+
+# 4. Manuais Manuais de Instalação para Humanos (A IA não deve indexar)
+docs/RULES 16.4 SETUP.md
+
+# 5. Scripts de Shell e PowerShell Auxiliares
+scripts/*.ps1
+scripts/*.sh

package/README.md

@@ -1,3 +1,371 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# ⚡ Agent Master DevSecOps
+> **Plataforma de agentes autônomos de engenharia de software com servidor MCP nativo e governança contínua integrada ao Git, Jira e Confluence.**
+
+[![Release](https://img.shields.io/badge/version-v3.9.0_Enterprise-blue.svg)](https://github.com/ContalApps/agent-master-devsecops/releases/tag/v3.9.0)
+[![CI/CD](https://img.shields.io/badge/tests-105_passed-success.svg)](https://github.com/ContalApps/agent-master-devsecops/actions)
+[![Protocol](https://img.shields.io/badge/protocol-MCP_2024--11--05-purple.svg)](https://modelcontextprotocol.io)
+[![Governance](https://img.shields.io/badge/tríade-Git_+_Jira_+_Confluence-0052CC.svg)](https://wastercaliari.atlassian.net/wiki/spaces/AGDEV)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](./package.json)
+
+| Recurso | Detalhes & Links Oficiais |
+| :--- | :--- |
+| **Versão & Release** | [`v3.9.0 Enterprise`](https://github.com/ContalApps/agent-master-devsecops/releases/tag/v3.9.0) · [Changelog](./docs/CHANGELOG.md) · [Decisões de Arquitetura (ADRs)](https://wastercaliari.atlassian.net/wiki/spaces/AGDEV/pages/1048584) |
+| **Tríade de Governança** | Repositório [GitHub](https://github.com/ContalApps/agent-master-devsecops) · Quadro Kanban [Jira AGDEV](https://wastercaliari.atlassian.net/jira/software/projects/AGDEV/boards/3) · Documentação Técnica [Confluence AGDEV](https://wastercaliari.atlassian.net/wiki/spaces/AGDEV) |
+| **Arquitetura Multiagente** | Suíte de 6 Agentes Especializados (`Orchestrator`, `DevSecOps`, `QA`, `Scrum`, `SRE`, `UI/UX`) com despacho *Late-Binding* |
+| **Ecossistema & Ferramentas** | Servidor Nativo MCP (32+ ferramentas) · Compatível com qualquer IDE (Cursor, VS Code, Windsurf) e Stack de desenvolvimento |
+
+---
+
+## 🔰 1. Guia Rápido de Início (Passo a Passo Descomplicado)
+
+### 💡 A Filosofia: "Você só pensa na ideia; a Fábrica cuida de todo o resto"
+Você não precisa ser especialista em DevOps, Scrum ou Arquitetura de Software. O seu único papel é **dizer o que quer construir**. A equipe de agentes autônomos de Inteligência Artificial assume o volante:
+- 📋 **Scrum:** Organiza os Épicos e Histórias no Jira com estimativas e abre a Sprint.
+- 📚 **Arquitetura:** Escreve a documentação viva e diagramas no Confluence.
+- 💻 **DevSecOps:** Escreve o código limpo, seguro e sem brechas de segurança.
+- 🧪 **QA:** Cria e executa testes automatizados (TDD) para garantir que nada quebre.
+- 🚀 **SRE:** Prepara a esteira de CI/CD e monitoramento de integridade do sistema.
+
+---
+
+### 📦 Passo 1: O que ter instalado no seu computador (Pré-requisitos)
+Se o seu computador é novo, foi formatado ou você nunca programou nele, instale estas ferramentas gratuitas antes de começar (leva menos de 5 minutos):
+
+1. **[Node.js (versão 20 LTS ou superior)](https://nodejs.org/)**  
+   *O que é:* O motor que executa os scripts e ferramentas dos agentes no seu computador.  
+   👉 Baixe no site oficial [nodejs.org](https://nodejs.org/) (clique na versão **LTS** e avance a instalação padrão).
+
+2. **[Git](https://git-scm.com/)**  
+   *O que é:* O programa que registra o histórico e as versões dos arquivos do seu projeto.  
+   👉 Baixe no site oficial [git-scm.com](https://git-scm.com/) e instale com as opções recomendadas.
+
+3. **[GitHub CLI (`gh`)](https://cli.github.com/)**  
+   *O que é:* O utilitário oficial do GitHub para conectar sua conta e gerenciar repositórios direto do seu computador.  
+   👉 Baixe no site oficial [cli.github.com](https://cli.github.com/) ou instale via terminal no Windows: `winget install --id GitHub.cli`.
+
+4. **Sua IDE (Editor de Código com Inteligência Artificial)**  
+   Escolha um editor moderno onde você poderá ver os arquivos e conversar com a equipe de agentes:
+   - 🌟 **[Cursor IDE](https://www.cursor.com/)** *(Altamente recomendado por integrar IA avançada nativamente)*
+   - **[VS Code](https://code.visualstudio.com/)** *(Clássico, leve e 100% gratuito)*
+   - **[Windsurf IDE](https://codeium.com/windsurf)** ou **[Google Antigravity](https://antigravity.google/)**
+
+---
+
+### 🔑 Passo 2: Conectar suas Contas (Configuração Única de 2 Minutos)
+
+Para que os agentes possam criar repositórios, tarefas no Jira e páginas no Confluence, configure seus acessos:
+
+#### A. Conecte o seu GitHub no terminal
+Abra o seu terminal (Prompt de Comando, PowerShell no Windows ou Terminal no Mac/Linux) e digite:
+```bash
+gh auth login
+```
+#### B. Conecte o ecossistema Atlassian (Jira & Confluence)
+O agente utiliza o Jira para gerenciar tarefas e o Confluence para guardar a documentação técnica do projeto.
+1. Se você já tem uma conta Atlassian (ou crie uma gratuita em [atlassian.com](https://www.atlassian.com)).
+2. Gere um Token de API pessoal acessando: 👉 **[Atlassian Security: API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens)**  
+   *(Clique em **Criar token de API**, dê um nome como `agent-master` e copie o código gerado).*
+3. Crie um arquivo chamado `.env` na raiz do seu projeto com o conteúdo abaixo:
+```ini
+ATLASSIAN_DOMAIN=sua-empresa.atlassian.net
+ATLASSIAN_EMAIL=seu-email@dominio.com
+ATLASSIAN_API_TOKEN=cole_seu_token_aqui
+JIRA_PROJECT_KEY=CHAVE_DO_JIRA
+CONFLUENCE_SPACE_KEY=CHAVE_DO_CONFLUENCE
+```
+> 💡 *Dica:* Se você ainda não configurou o Jira ou Confluence no primeiro momento, o instalador funcionará normalmente em modo local e avisará quando as credenciais forem necessárias.
+
+---
+
+### 🚀 Passo 3: Criar seu Projeto em 1 Único Comando
+Abra o terminal na pasta onde você guarda seus projetos e execute:
+```bash
+npx agent-master-init
+```
+**O que acontece agora nos bastidores em poucos segundos?**
+- Baixa e prepara a equipe completa de agentes autônomos (`agents/`);
+- Conecta o **Servidor MCP Nativo** com mais de 32 ferramentas de automação;
+- Configura as regras para Cursor (`.cursorrules`), Windsurf (`.windsurfrules`) ou VS Code;
+- Prepara o ambiente sem você precisar configurar nada manualmente.
+
+---
+
+### 💬 Passo 4: Abra seu Editor e Dite a sua Ideia!
+1. Abra a pasta do seu novo projeto no **Cursor**, **VS Code** ou **Windsurf**.
+2. Abra o chat de Inteligência Artificial da IDE (atalho `Ctrl + L` no Windows ou `Cmd + L` no Mac).
+3. Escreva sua ideia em português comum, exatamente como falaria com um colega:
+   > *"Olá! Quero criar um aplicativo web para agendamento de consultas médicas, com login para médicos e pacientes, histórico de consultas e envio de confirmação por WhatsApp."*
+4. **Assista à Fábrica trabalhar por você:**
+   - O **Orquestrador Líder** avalia a viabilidade da ideia e desenha a arquitetura.
+   - O **Scrum Master** cria o Épico, quebra em Histórias no Jira e abre a Sprint 1.
+   - O **Confluence** recebe a documentação técnica com diagramas de sequência e classes.
+   - Os especialistas em **DevSecOps**, **QA** e **UI/UX** escrevem o código, a interface acessível e os testes automatizados!
+
+---
+
+### 🧭 Cenários Avançados & Modos de Uso
+
+<details>
+<summary><b>🟡 Adotando em um Projeto Existente (Brownfield — Modo Submódulo Limpo)</b></summary>
+
+Se você já possui um repositório existente com código e deseja plugar a governança e os agentes sem duplicar arquivos ou sujar seu histórico:
+```bash
+# 1. Adicione o framework como submódulo git na raiz do seu projeto
+git submodule add https://github.com/ContalApps/agent-master-devsecops.git
+
+# 2. Execute o assistente de bootstrap
+node agent-master-devsecops/scripts/bootstrap_cli.js
+```
+- **Zero Duplicação (Regra 16):** O instalador detecta o submódulo e não copia pastas redundantes.
+- **Engenharia Reversa Automática:** Lê seus arquivos (package.json, Dockerfile, etc.), identifica a linguagem e auto-provisiona o Projeto no Jira e o Espaço no Confluence.
+- **Configuração Automática da IDE:** Aponta as regras do Cursor e Windsurf diretamente para o submódulo.
+</details>
+
+<details>
+<summary><b>📊 Painel de Controle Visual Local (Web Inspector na porta 3333)</b></summary>
+
+Para visualizar em tempo real o andamento das sprints, saúde dos agentes, métricas de saturação e barramento de eventos:
+```bash
+node scripts/web_inspector.js
+```
+Abra seu navegador em: **`http://localhost:3333`**
+</details>
+
+<details>
+<summary><b>🔒 Execução 100% Offline com Modelos Locais (Ollama & DeepSeek)</b></summary>
+
+Se você precisa rodar totalmente isolado sem internet ou sem custos de API:
+```bash
+# Executa o orquestrador compacto de alta densidade (menos de 1.500 tokens de contexto inicial)
+ollama run deepseek-r1:14b "$(cat agents/compact/AGENT_ORCHESTRATOR_COMPACTO.md)"
+```
+</details>
+
+<details>
+<summary><b>🌐 Uso via Web no Claude Projects ou Custom GPTs (OpenAI) & Prompt Master</b></summary>
+
+Se você prefere utilizar os agentes diretamente em interfaces web (ChatGPT, Claude.ai, Gemini ou DeepSeek Web) sem IDE conectada:
+
+1. **Crie o Projeto ou Assistente:** No Claude.ai crie um *Project*, ou no ChatGPT crie um *Custom GPT*.
+2. **Anexe o Conhecimento:** Faça o upload dos arquivos das pastas `agents/`, `docs/` e deste `README.md`.
+3. **Cole a Instrução Mestra (System Prompt):** Copie e cole o bloco delimitado abaixo nas instruções do seu assistente:
+
+```markdown
+Você é o AGENT ORCHESTRATOR DE ENGENHARIA DE SOFTWARE, ARQUITETURA, DEVSECOPS E GOVERNANÇA.
+Você opera sob a estrutura soberana das pastas `/agents`, `/docs` e do manifesto unificado `README.md`.
+
+Sua obrigação primordial é absorver, incorporar e respeitar fielmente cada um dos contratos de engenharia e livros-razão catalogados:
+
+1. OS 6 MODOS OPERACIONAIS ACIONÁVEIS:
+Alterne instantaneamente de persona mediante solicitação no chat:
+- `modo: orchestrator`: Coordenação geral, triagem, prescrição de tarefas e preservação da coerência arquitetural.
+- `modo: uiux`: Ativa o especialista em experiência do usuário, Heurísticas de Nielsen, acessibilidade digital WCAG 2.1 AA e Design Tokens.
+- `modo: devsecops`: Foco em arquitetura limpa, novas funcionalidades com TDD, esteiras CI/CD seguras e modelagem de ameaças OWASP.
+- `modo: qa`: Ativa o auditor adversário independente para auditar diffs e Pull Requests com tolerância zero para falhas.
+- `modo: scrum`: Foco em gestão ágil, sprints atômicas, WIP Limit <= 2, priorização determinística e refatoração preventiva.
+- `modo: sre`: Ativa o SRE Lead para diagnóstico de métricas Prometheus (/metrics), tracing OpenTelemetry e playbooks de auto-remediação.
+- `modo: full-dev`: Modo de autonomia contínua. O agente estuda propostas de backlog, planeja arquitetura, desenvolve código, escreve testes, valida na esteira de CI/CD, registra nos três pilares (Git, Jira, Confluence) e avança autonomamente para o próximo item em loop ininterrupto.
+
+2. PROTOCOLO DE RESPOSTA EM DUAS CAMADAS (TWO-LAYER PROTOCOL):
+- Camada Densa: Toda análise técnica detalhada, ADRs e diagnósticos de causa-raiz (Ishikawa) devem ser gravados diretamente nas plataformas (comentário de conclusão no Jira, páginas no Confluence e descrição de PRs no Git).
+- Camada Compacta: As respostas exibidas ao usuário no chat devem ser estritamente curtas, diretas, com links clicáveis e separadas por dupla quebra de linha (\n\n) para máxima legibilidade visual.
+
+3. MANDATO PRESCRITIVO & PASSO ZERO:
+- Erradique a postura passiva. Nunca pergunte "o que deseja fazer?". Diagnostique o estado e prescreva o próximo passo técnico.
+- Audite proativamente as credenciais Atlassian e GitHub CLI no início da sessão para garantir a integridade do Tríplice Registro contínuo.
+
+DECLARAÇÃO DE PRONTIDÃO:
+Responda confirmando a assimilação dos contratos de engenharia, informe o status das credenciais e declare prontidão operacional para executar qualquer demanda técnica com padrão Staff Engineer.
+```
+</details>
+
+---
+
+## 🏛️ 2. Topologia do Repositório e Livros-Razão Imutáveis
+
+O ecossistema é composto por uma árvore enxuta e coesa de arquivos:
+
+```text
+raiz-do-projeto/
+├── README.md                            # Guia mestre consolidado, catálogo e especificações MCP
+├── .cursorignore                        # Blindagem de contexto RAG (economia de ~35k tokens)
+├── agents/                              # Prompts de Sistema Executáveis dos Especialistas
+│   ├── AGENT_ORCHESTRATOR.md            # Líder Técnico, Maestro e Interface Plug-and-Play
+│   ├── AGENT_UIUX.md                    # Design System, Heurísticas de Nielsen e WCAG 2.1 AA
+│   ├── AGENT_DEVSECOPS.md               # Arquiteto de Software, DevSecOps e Modelagem de Ameaças
+│   ├── AGENT_QA.md                      # Auditor Adversário e Gatekeeper de PRs (Veto)
+│   ├── AGENT_SCRUM.md                   # Gestor Ágil, Sprints Atômicas, WIP <= 2 e Profiling
+│   ├── AGENT_SRE.md                     # Confiabilidade 24/7, Prometheus e Auto-Cura
+│   └── compact/
+│       └── AGENT_ORCHESTRATOR_COMPACTO.md # Edição destilada para LLMs locais (< 1.500 tokens)
+├── docs/                                # Livros-Razão Imutáveis de Engenharia
+│   ├── ARCHITECTURE.md                  # Topologia cooperativa, loops e barramento de eventos
+│   ├── ENGINEERING_RULES.md             # As 15 Regras Fundamentais de Engenharia
+│   ├── STATE.md                         # Estado operacional ativo do projeto e tarefas da sprint
+│   ├── CHANGELOG.md                     # Livro-razão imutável de entregas (Append-Only)
+│   ├── IDEAS.md                         # Estacionamento estruturado de ideias (Regra 14)
+│   ├── CALCULATIONS.md                  # Dimensionamentos matemáticos e orçamentos de latência
+│   └── playbooks/                       # Playbooks operacionais de Circuit Breaker e Tracing
+├── scripts/                             # Motores de Execução JS (MCP, Clientes e Linters)
+│   ├── mcp_server.js                    # Servidor MCP nativo JSON-RPC 2.0 (36 Ferramentas Nativas)
+│   └── ...
+└── .github/workflows/                   # Esteiras CI/CD de Automação
+    ├── ci.yml                           # Testes unitários, lint e validações
+    ├── atlassian_sync.yml               # Sincronização automática da Tríade Git-Jira-Confluence
+    ├── autonomous_pr_reviewer.yml       # Auditoria adversária independente de Pull Requests
+    └── cd_deploy.yml                    # Deploy contínuo multi-nuvem com Smoke Testing HTTP 200
+```
+
+---
+
+## 🔄 3. A Tríade de Governança & Handovers Automáticos
+
+Toda operação repousa sobre a sincronia estrita de três vértices: **Git** (código versionado), **Jira** (gestão ágil com WIP $\le 2$) e **Confluence** (documentação viva de ADRs e SPECs).
+
+```text
+Fluxo Sequencial de Execução da Tríade de Governança:
+1. Demanda:       Usuário envia requisito ou ideia ao AGENT_ORCHESTRATOR.
+2. Gate Regra 16: Orchestrator valida a Tríade (Git + Jira + Confluence) e bloqueia código prematuro sem ticket.
+3. Design (UI):   Orchestrator despacha EVENT_REQUIREMENTS_READY ao AGENT_UIUX (se houver interface).
+                  UIUX devolve EVENT_DESIGN_READY com tokens semânticos e conformidade WCAG 2.1 AA.
+4. Construção:    Orchestrator despacha modo: devsecops.
+                  AGENT_DEVSECOPS constrói código com TDD, arquitetura limpa e sanitização OWASP.
+5. Handover QA:   DevSecOps emite EVENT_CODE_COMPLETE para o AGENT_QA.
+6. Auditoria & PR:AGENT_QA executa testes adversários e caça vulnerabilidades:
+                  - Falha encontrada: emite EVENT_REVIEW_FAILED (retorna ao DevSecOps para correção imediata).
+                  - Código 100% limpo: emite EVENT_REVIEW_PASSED (autoriza merge e esteira CI/CD).
+7. Auto-Merge:    Esteira GitHub Actions executa auto-merge autônomo na branch main e fecha o ciclo no Jira.
+8. Runtime 24/7:  AGENT_SRE monitora /metrics e /health; anomalias disparam alerta ao AGENT_SCRUM.
+```
+
+---
+
+## 👥 4. Catálogo dos 6 Especialistas e Modos Operacionais
+
+Alterne instantaneamente de persona mediante solicitação no chat:
+
+| Agente | Arquivo de Contrato | Papel & Missão | Modo de Acionamento |
+|---|---|---|---|
+| **⚡ AGENT_ORCHESTRATOR** | [`agents/AGENT_ORCHESTRATOR.md`](./agents/AGENT_ORCHESTRATOR.md) | **Orquestrador Central & Líder Técnico.** Coordena handovers, mantém coerência arquitetural e prescreve ações. | `modo: orchestrator` *(Padrão)* |
+| **🎨 AGENT_UIUX** | [`agents/AGENT_UIUX.md`](./agents/AGENT_UIUX.md) | **Product Design & Design Systems.** Modela jornadas, 10 Heurísticas de Nielsen, acessibilidade WCAG 2.1 AA e tokens semânticos. | `modo: uiux` |
+| **🛡️ AGENT_DEVSECOPS** | [`agents/AGENT_DEVSECOPS.md`](./agents/AGENT_DEVSECOPS.md) | **Engenharia, Arquitetura & Segurança.** Código robusto com TDD, arquitetura limpa, CI/CD seguro e mitigação de vulnerabilidades OWASP. | `modo: devsecops` |
+| **🔍 AGENT_QA** | [`agents/AGENT_QA.md`](./agents/AGENT_QA.md) | **Auditor Adversário Independente.** Revisa PRs com ceticismo estrito. Caça race conditions e vulnerabilidades. **Nunca aprova o próprio código.** | `modo: qa` |
+| **📈 AGENT_SCRUM** | [`agents/AGENT_SCRUM.md`](./agents/AGENT_SCRUM.md) | **Gestão Ágil & Melhoria Contínua.** Sprints atômicas, WIP Limit $\le 2$, priorização determinística (DAG) e erradicação de débitos técnicos. | `modo: scrum` |
+| **📡 AGENT_SRE** | [`agents/AGENT_SRE.md`](./agents/AGENT_SRE.md) | **Sentinela 24/7 de Produção.** Audita rotas `/metrics` (Prometheus) e `/health`, identifica gargalos e executa auto-remediação. | `modo: sre` |
+| **⚡ MODO FULL-DEV** | [`agents/AGENT_ORCHESTRATOR.md`](./agents/AGENT_ORCHESTRATOR.md) | **Autonomia Contínua em Loop.** Lê "A fazer", aplica filtro de sanidade (Regra 14), planeja, implementa, homologa e move cards em loop sem parada. | `modo: full-dev` |
+
+---
+
+## 💰 5. FinOps de Contexto & Protocolo Late-Binding
+
+Carregar os prompts completos de todos os especialistas em uma única sessão consome **~46.000 tokens** na primeira mensagem, causando:
+- Degradação de atenção e raciocínio da LLM (*needle-in-a-haystack*).
+- Custos desnecessários de tokens de entrada em modelos pagos.
+- Lentidão desnecessária no tempo até o primeiro token (TTFT).
+
+### A Solução: Arquitetura Late-Binding Just-In-Time
+```text
+Protocolo Late-Binding Just-In-Time:
+[Início de Sessão: Apenas AGENT_ORCHESTRATOR (~1.200 - 5.400 tokens)]
+   │
+   ├── Demanda é apenas Coordenação / Status?
+   │     └── NÃO carrega especialistas -> Responde imediatamente com alta eficiência
+   │
+   └── Demanda Requer Especialista Operacional?
+         ├── Implementação de Código   ──> Carrega AGENT_DEVSECOPS sob demanda
+         ├── Auditoria e Revisão de PR ──> Carrega AGENT_QA sob demanda
+         ├── Gestão de Sprints e Fluxo ──> Carrega AGENT_SCRUM sob demanda
+         ├── Acessibilidade e Design   ──> Carrega AGENT_UIUX sob demanda
+         └── Telemetria e Incidentes   ──> Carrega AGENT_SRE sob demanda
+```
+* **Economia Real:** Reduz o consumo de contexto em **mais de 85%**, acelerando respostas e preservando o limite de contexto da janela de raciocínio.
+* **Ferramentas Nativas:** Otimização cirúrgica com a tool MCP `agent_compress_context` (< 1.500 tokens) e esqueletização AST de contratos com `agent_extract_code_skeleton` (redução de até 80% do contexto consumido).
+
+---
+
+## 📜 6. As 16 Regras Fundamentais de Engenharia
+
+Toda linha de código gerada obedece estritamente ao contrato canônico [`docs/ENGINEERING_RULES.md`](./docs/ENGINEERING_RULES.md):
+
+1. **Memória de Três Vértices:** Planejamento em `STATE.md`, histórico imutável em `CHANGELOG.md` e backlog em `IDEAS.md`.
+2. **Pense Antes de Modificar:** Análise prévia de impacto e leitura cuidadosa do código existente.
+3. **Modificação Correta:** Preservação estrita de comentários, docstrings e contratos de API pré-existentes.
+4. **Cultura de Testes Obrigatória (TDD):** Zero código em produção sem testes automatizados correspondentes.
+5. **Security First (OWASP & ASVS):** Proibição absoluta de hardcoding de segredos, emails ou domínios privados; credenciais vêm exclusivamente de variáveis de ambiente (`process.env`) ou `.env` protegido pelo `.gitignore`.
+6. **Commits Rastreáveis por Ticket:** Formato estrito: `[<TICKET>] - <Ação em português>`. Proibição de Conventional Commits (`feat:`, `fix:`, `chore:`).
+7. **Branches Dedicadas por Ticket:** A branch deve se chamar exclusivamente `<TICKET>` (ex: `PROJ-123`). Prefixos legados (`feature/**`, `fix/**`) são proibidos.
+8. **Zero Merges Diretos na Main:** Todo código entra em `main` exclusivamente via Pull Request homologado por 100% dos checks de CI.
+9. **Observabilidade Nativa:** Exposição de `/metrics` (Prometheus) e `/health`.
+10. **Scanner de Incidentes & Auto-Cura:** Detecção preventiva de saturação e execução automatizada de playbooks.
+11. **Tríplice Registro Contínuo & Protocolo Dual-Layer:** Sincronização em Git, Jira e Confluence; respostas no chat sempre curtas com links diretos clicáveis.
+12. **Resolução Automática de Alertas:** Remediação proativa de alertas do CodeQL, TruffleHog e npm audit.
+13. **Auto-Remediação Operacional:** Playbooks de resiliência e Circuit Breaking para alta disponibilidade.
+14. **Curadoria & Sanity Filter de Ideias:** Vetar overengineering, alucinações e desconexão com o domínio de negócio.
+15. **Imutabilidade de Requisitos & Inviolabilidade de Segredos:** Proibição de falhas silenciosas. O agente deve bloquear execuções se faltarem credenciais essenciais de governança.
+16. **Onboarding Bimodal & Gate Compulsório da Tríade:** Detecção automática de modo Greenfield (novo) vs. Brownfield (existente via engenharia reversa), auto-provisionamento de Jira/Confluence e veto categórico a desenvolvimento prematuro enquanto a Tríade não estiver 100% homologada.
+
+---
+
+## 🛠️ 7. Catálogo das 36 Ferramentas Nativas do Servidor MCP
+
+O servidor nativo [`scripts/mcp_server.js`](./scripts/mcp_server.js) implementa a especificação oficial do **Model Context Protocol (JSON-RPC 2.0)**:
+
+| Ferramenta MCP | Descrição | Parâmetros Principais |
+|---|---|---|
+| `agent_get_rule` | Recupera o texto canônico de uma das 15 Regras de Engenharia. | `ruleNumber` |
+| `agent_validate_idea` | Aplica a Regra 14 (Ideation Sanity Filter) para vetar overengineering. | `ideaTitle`, `ideaDescription`, `projectStack`, `projectDomain` |
+| `agent_audit_code` | Audita código contra injeções perigosas, segredos hardcoded e má qualidade. | `code`, `filePath` |
+| `agent_full_dev_status` | Retorna status de governança do projeto, tarefas ativas e próxima prescrição. | N/A |
+| `agent_eval_harness` | Avalia empiricamente a resposta de qualquer LLM contra as 15 Regras. | `modelName`, `promptSent`, `responseReceived` |
+| `agent_generate_ide_plugins` | Exporta manifestos e ativadores para VS Code e JetBrains. | `targetDir`, `dryRun` |
+| `agent_review_pr` | Auditoria adversária independente de diffs emitindo testes de quebra. | `diff`, `files` |
+| `agent_compress_context` | Destila instruções sob orçamentos estritos (< 1.500 tokens). | `text`, `maxTokens` |
+| `agent_sync_atlassian` | Vincula commits, branches e PRs do GitHub a tickets do Jira via Remote Links. | `issueKey`, `url`, `title`, `type` |
+| `agent_otel_trace` | Gera tracing distribuído OpenTelemetry com flamegraphs em ASCII. | `serviceName`, `spans` |
+| `agent_perf_benchmark` | Mede throughput JSON-RPC e bloqueia regressões > 10% contra baseline. | `iterations` |
+| `agent_circuit_breaker` | Máquina de estados de resiliência e failover transparente multi-LLM. | `action`, `provider` |
+| `agent_orchestrate_event` | Despacha eventos determinísticos no barramento multi-agente. | `eventType`, `payload` |
+| `agent_sast_scan` | Scanner SAST offline detectando CWE-78, CWE-89, CWE-79, CWE-1333 e segredos. | `snippet`, `dirPath` |
+| `agent_audit_quality` | Calcula complexidade ciclomática de McCabe, profundidade e débitos técnicos. | `code`, `filePath` |
+| `agent_sre_telemetry` | Coleta métricas de runtime Node.js no formato Prometheus 0.0.4. | N/A |
+| `agent_sre_remediate` | Executa playbooks de auto-cura (`purge_buffers`, `trigger_gc`, `reset_circuits`). | `action`, `context` |
+| `agent_export_universal_bundle` | Exporta perfis prontos para Cursor, Windsurf, Claude, ChatGPT e Ollama. | `platform`, `targetDir`, `dryRun` |
+| `agent_bootstrap_environment` | Auto-detecta IDEs (Cursor/Windsurf/VSCode/Claude/Ollama) e provisiona o agente. | `targetDir`, `dryRun`, `platforms` |
+| `agent_generate_magic_prompt` | Gera o Magic Prompt (< 600 tokens) e o Web Bookmarklet para navegadores. | `targetDir`, `dryRun` |
+| `agent_inspector_info` | Retorna rotas REST, telemetria e URL do Web Dashboard local (porta 3333). | `port` |
+| `agent_check_credentials` | Executa healthcheck de login no GitHub CLI e Atlassian (Jira/Confluence). | `targetDir` |
+| `agent_configure_credentials` | Configura credenciais Atlassian no `.env` local com proteção no `.gitignore`. | `domain`, `email`, `token`, `jiraKey`, `confluenceSpace` |
+| `agent_standardize_kanban` | Padroniza quadro Jira nas 3 colunas canônicas ("A fazer", "Em andamento", "Concluído"). | `projectKey`, `boardConfig` |
+| `agent_full_dev_pipeline` | Orquestra o ciclo Full Dev com filtro de sanidade (Regra 14) em loop contínuo. | `tasks`, `projectContext` |
+| `agent_validate_rule15` | Validação estrita da Inviolabilidade da Regra 15 e prontidão de credenciais. | `failFast` |
+| `agent_audit_a11y` | Auditoria de acessibilidade WCAG 2.1 AA e design tokens (UI/UX e QA). | `code`, `filename` |
+| `agent_lint_git_hygiene` | Linter local de commits (`[<TICKET>] - <Ação>`) e branches (`<TICKET>`) - Regra 11. | `commitMessage`, `branchName`, `auditState` |
+| `agent_audit_dependencies_sca` | Software Composition Analysis offline (CVEs em dependências e licenças GPL/AGPL). | `packageJson` |
+| `agent_validate_api_contract` | Validação de contratos OpenAPI 3.x / Swagger e detecção de Shadow APIs (Loop 2). | `spec`, `implementedRoutes` |
+| `agent_smart_onboarding` | Executa a Regra 16: detecta modo Greenfield vs Brownfield, mapeia a stack via engenharia reversa e orquestra o auto-provisionamento de Jira e Confluence sem páginas vazias. | `targetDir` |
+| `agent_verify_triad_gate` | Valida o Gate de Governança da Regra 16: bloqueia prompts de desenvolvimento de software caso a Tríade (Git + Jira + Confluence) não esteja 100% configurada, verificada e operacional. | `targetDir` |
+| `agent_extract_code_skeleton` | Extrai o esqueleto semântico de código (Rule 9), eliminando corpos de métodos para reduzir em até 90% o consumo de tokens de contexto entre módulos. | `code, language` |
+| `agent_scaffold_feature` | Gera atomicamente em 1 único turno (< 25ms) todos os arquivos de uma funcionalidade completa (Model, Repository, Service, Controller REST e Teste TDD), eliminando múltiplos roundtrips. | `name, domain, package, stack, fields, writeToDisk` |
+| `agent_set_mcp_profile` | Altera o perfil de ferramentas ativas do MCP (Late-Binding de Ferramentas) para economizar tokens de contexto: "all", "core", "qa_devsecops", "atlassian", "sre". | `profile` |
+| `agent_mine_domain_ideas` | Varredura inteligente de código-fonte de aplicação para identificar oportunidades reais de performance, resiliência, arquitetura e contratos, adicionando ao IDEAS.md. | `targetDir, autoApply, dryRun` |
+
+---
+
+## 🚀 8. Esteiras Automatizadas de CI/CD & Deploy Contínuo (DoD)
+
+O ecossistema implementa quatro workflows nativos do GitHub Actions em `.github/workflows/`:
+
+1. **`ci.yml` (Integração Contínua):** Roda a suíte completa de testes unitários e linters em Node.js com descoberta dinâmica de arquivos de homologação.
+2. **`autonomous_pr_reviewer.yml` (Gatekeeper Adversário & Auto-Merge):** Executa auditoria estática adversária em todo PR aberto, bloqueando merges com segredos ou vulnerabilidades OWASP. Com a permissão `contents: write`, executa **Auto-Merge autônomo** diretamente para a branch `main` quando o parecer for APROVADO.
+3. **`atlassian_sync.yml` (Tríade Git-Jira-Confluence):** Extrai a chave Jira do nome da branch ou mensagem de commit e cria Remote Links automáticos no card Jira correspondente.
+4. **`cd_deploy.yml` (Deploy Contínuo & Smoke Testing):**
+   - Disparado automaticamente após conclusão verde do CI na branch `main`.
+   - Compila imagem Docker multi-stage com cache de camadas.
+   - Dispara deploy multi-nuvem agnóstico (Webhook Universal para Railway/Render/Coolify, CLI ou Kubernetes).
+   - **Smoke Test Compulsório:** Executa sondagens com `curl` (até 6 tentativas com backoff) exigindo **HTTP 200 OK** na URL de produção antes de concluir o ciclo no Jira.
+
+---
+
+## 🛡️ 9. Licença & Governança
+
+Mantido sob rigorosas práticas corporativas de DevSecOps, rastreabilidade contínua e padrões de arquitetura de software escalável pela **ContalApps**. Licença MIT.