sinapse-ai 1.21.0 → 1.22.0

package/CHANGELOG.md

@@ -1,17 +1,31 @@
-## [1.21.0](https://github.com/caioimori/sinapse-ai/compare/1.20.1...1.21.0) (2026-07-04)
+## [1.22.0](https://github.com/caioimori/sinapse-ai/compare/1.21.0...1.22.0) (2026-07-07)
 
 ### Features
 
-* **constitution:** Artigo IV ganha dente determinístico — traceability arquivo→AC ([#346](https://github.com/caioimori/sinapse-ai/issues/346)) ([9c0f991](https://github.com/caioimori/sinapse-ai/commit/9c0f991fda8e456d85e9338c904575fda13a907b))
-* **evals:** golden set comportamental do gate de épicos + eval:e2e no gate de merge [Story onda3-s4-behavioral-eval-regression] ([#349](https://github.com/caioimori/sinapse-ai/issues/349)) ([4c22695](https://github.com/caioimori/sinapse-ai/commit/4c226958bfa830f83c813f1ccf28bdf46f161c35))
-* **orchestration:** brownfield discovery ganha progresso determinístico + gate QA em código [Story onda3-s3-brownfield-progress-gate] ([#348](https://github.com/caioimori/sinapse-ai/issues/348)) ([8b3930e](https://github.com/caioimori/sinapse-ai/commit/8b3930e0b27a4431b6d21ad60832759bbd7ce74d))
-* **orchestration:** gates determinísticos de artefato na Phase 1 do greenfield ([#347](https://github.com/caioimori/sinapse-ai/issues/347)) ([ca61c0f](https://github.com/caioimori/sinapse-ai/commit/ca61c0f8c65d89a5cd8e2ff0c381330f25ee3c6f)), closes [#317](https://github.com/caioimori/sinapse-ai/issues/317)
-* **orchestration:** wave-gate executável + piloto medido de epic waves — REPROVADO pelo critério pré-registrado [Story onda3-s5-epic-waves-wrapper-pilot] ([#350](https://github.com/caioimori/sinapse-ai/issues/350)) ([172cd86](https://github.com/caioimori/sinapse-ai/commit/172cd86004adfb796c8e4eea18d992940c42aca3))
+* **gate:** M2 — verificação de substância do spec no gate doc-first [Story rodada2-m2-spec-substance-gate] ([#358](https://github.com/caioimori/sinapse-ai/issues/358)) ([bc2e192](https://github.com/caioimori/sinapse-ai/commit/bc2e192322b36de54dd5a91383950a7cc8e39a49))
+* **gate:** M5 — check de constituição CLAUDE/AGENTS no gate de PR [Story rodada2-m5-claude-agents-single-source] ([#361](https://github.com/caioimori/sinapse-ai/issues/361)) ([e08be2e](https://github.com/caioimori/sinapse-ai/commit/e08be2eb407043b9ad77de08cf48a08bf3690ba4)), closes [#7](https://github.com/caioimori/sinapse-ai/issues/7)
+* **lint:** M3 — guard de descrição de ferramentas/comandos [Story rodada2-m3-tool-description-lint] ([#359](https://github.com/caioimori/sinapse-ai/issues/359)) ([bd9a4a9](https://github.com/caioimori/sinapse-ai/commit/bd9a4a9d977ecd60b95209bf540c926c63f6489f))
+* **lint:** mesa2 — ACs em GWT executável (template + guard advisory) [Story mesa2-acs-gwt-guard] ([#364](https://github.com/caioimori/sinapse-ai/issues/364)) ([ef24dc3](https://github.com/caioimori/sinapse-ai/commit/ef24dc36a5e5df05b5761b676fc140906739e006))
+* **spec:** M4 — cerimônia COMPLEX≥16 do spec-pipeline em código [Story rodada2-m4-complex-ceremony-code] ([#360](https://github.com/caioimori/sinapse-ai/issues/360)) ([e15f04b](https://github.com/caioimori/sinapse-ai/commit/e15f04b418111ce5cbead2a8321444e5ae2288ca))
+
+### Bug Fixes
+
+* **orchestration:** rodada 2 lote B — guardas runtime, gate CI cross-platform e higiene [Story rodada2-lote-b-codigo-ci] ([#354](https://github.com/caioimori/sinapse-ai/issues/354)) ([ce18459](https://github.com/caioimori/sinapse-ai/commit/ce18459dc0884510f43287cebe221e06d0669b6b))
+* **vitrine:** rodada 2 lote A — números exatos e era-de-modelo [Story rodada2-lote-a-vitrine-numeros] ([#353](https://github.com/caioimori/sinapse-ai/issues/353)) ([615aaf4](https://github.com/caioimori/sinapse-ai/commit/615aaf4d3d5dcced5a7f0aa575b8d33c324f8798))
+
+### Documentation
+
+* **audit:** fecha relatório rodada 2 com PRs [#353](https://github.com/caioimori/sinapse-ai/issues/353)/[#354](https://github.com/caioimori/sinapse-ai/issues/354) mergeados [Story rodada2-lote-b-codigo-ci] ([#355](https://github.com/caioimori/sinapse-ai/issues/355)) ([e81cb79](https://github.com/caioimori/sinapse-ai/commit/e81cb79f6f560c28109ecdfcd4e205102e244231))
+* **epic:** fundação doc-first rodada 2 — épicos Mesa + instalação global [Story rodada2-mesa] ([#356](https://github.com/caioimori/sinapse-ai/issues/356)) ([3d6169f](https://github.com/caioimori/sinapse-ai/commit/3d6169f10c1f0e0a13946827dce9ba4f1a6a5d77))
+* **links:** M1 — zera 121 links markdown quebrados [Story rodada2-m1-link-sweep] ([#357](https://github.com/caioimori/sinapse-ai/issues/357)) ([d9e4f53](https://github.com/caioimori/sinapse-ai/commit/d9e4f53afef01a3447f9b1af57eeee79c8986b1e))
 
 ### Maintenance
 
-* regenera manifests pós-consolidação da Onda 3 (S1-S5 na main) [Story onda3-s5-epic-waves-wrapper-pilot] ([#351](https://github.com/caioimori/sinapse-ai/issues/351)) ([302e99f](https://github.com/caioimori/sinapse-ai/commit/302e99fdcbca44bf8ec56064632e01ffd66fd40e)), closes [346-#350](https://github.com/caioimori/346-/issues/350)
-* **release:** sync da main pós-release 1.20.1 ([#345](https://github.com/caioimori/sinapse-ai/issues/345)) ([4bd61b4](https://github.com/caioimori/sinapse-ai/commit/4bd61b4c7cbdc06b76b0dec6b300a8fb3be5f06a)), closes [#277](https://github.com/caioimori/sinapse-ai/issues/277)
+* **release:** sync da main pós-release 1.21.0 ([#352](https://github.com/caioimori/sinapse-ai/issues/352)) ([8f15c86](https://github.com/caioimori/sinapse-ai/commit/8f15c868f5808a1673a663398b1194ce5b0189e5)), closes [#277](https://github.com/caioimori/sinapse-ai/issues/277)
+
+### Refactoring
+
+* **agents:** M6 — dedup da integração CodeRabbit (single-source) [Story rodada2-m6] ([#362](https://github.com/caioimori/sinapse-ai/issues/362)) ([a574dd5](https://github.com/caioimori/sinapse-ai/commit/a574dd50833610342ff03178a5275ec4d00d7c0e))
 
 # Changelog
 
@@ -22,6 +36,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.21.0] — 2026-07-04 — 🏗️ Onda 3 estrutural: gates determinísticos em todos os fluxos + eval como gate de merge
+
+> Minor. Atualização segura via `npx sinapse-ai update`. Fecha a Onda 3 da auditoria AF-20260702 (épico `epic-onda3-estrutural`, PRs #346–#351) — do "otimizado" ao "robusto por design".
+
+### Features
+
+- **constitution:** Artigo IV (No Invention) ganha dente determinístico — `validate:article-iv` no pre-push rastreia arquivos de produto alterados contra o File List da story referenciada; órfão = warning na calibração, `--strict` promove a bloqueio. CI reporta SKIP explícito (stories são locais por design) (#346)
+- **orchestration:** Phase 1 do greenfield só avança com artefatos reais no disco (gate `fileHasContent` por estágio) + `metadata.confirmation_required` do YAML passa a ser consumido de verdade (`false` = auto-GO nas pausas go_pause) (#347)
+- **orchestration:** brownfield discovery com progresso determinístico (`brownfield-progress.js` mede as 10 fases pelos artefatos no disco, com ponto exato de retomada) + gate QA da Fase 7 avaliado em código (APPROVED/NEEDS WORK, máx 2 reworks → escalate) (#348)
+- **evals:** golden set comportamental permanente do gate de épicos (6 casos travando os bugs medidos em 30/06: build vazio, plano stub, zero-checks, sinal de falha ignorado) + `npm run eval:e2e` rodando dentro de `npm test` — regressão comportamental agora bloqueia merge. Protocolo de medição 2 braços promovido a doc executável (#349)
+- **orchestration:** `scripts/wave-gate.js` — gate determinístico por wave (testes verdes + arquivos realmente escritos). O wrapper autônomo de epic waves foi construído, MEDIDO pelo protocolo pré-registrado e **reprovado** (empate em correctness, ~2x custo vs caminho nativo) — não vira produto; o gate fica como utilitário standalone e os templates ganham nota de honestidade (#350)
+
+### Maintenance
+
+- manifests regenerados pós-consolidação da Onda 3; entidades novas registradas (#351)
+
 ## [1.20.1] — 2026-07-03 — 🛡️ Segurança em 3 ondas + ativação enxuta + corte do cluster órfão (DEC-03)
 
 > Patch. Atualização segura via `npx sinapse-ai update`. Fecha a execução da mesa de decisões da otimização: PRs #337–#344.

package/README.en.md

@@ -294,7 +294,7 @@ Both IDEs have access to all 17 squads, 172 agents, workflows, and knowledge bas
 | Feature | Claude Code | Codex CLI |
 |---------|:-----------:|:---------:|
 | Agent activation (@agent) | Full | Full |
-| Constitutional hooks (17) | Full | Partial (5) |
+| Constitutional hooks (20) | Full | Partial (5) |
 | Story-driven development | Full | Full |
 | Quality gates | Full | Full |
 | Delegation enforcement | Full | Partial |

package/README.md

@@ -21,7 +21,7 @@
 
 ## O que é o SINAPSE?
 
-SINAPSE é um meta-framework open source que organiza **172 agentes de IA em 17 squads especializados**, operando direto no terminal via Claude Code ou Codex CLI. Cada agente tem um papel definido, cada squad domina uma disciplina, e o sistema inteiro é governado por uma **Constitution com enforcement real** — 17 hooks ativos que bloqueiam violações em tempo de execução.
+SINAPSE é um meta-framework open source que organiza **172 agentes de IA em 17 squads especializados**, operando direto no terminal via Claude Code ou Codex CLI. Cada agente tem um papel definido, cada squad domina uma disciplina, e o sistema inteiro é governado por uma **Constitution com enforcement real** — 20 hooks registrados que bloqueiam violações em tempo de execução.
 
 O conceito central é simples: em vez de um único assistente de IA tentando fazer tudo, o SINAPSE estrutura o trabalho em equipes especializadas. Um squad de branding cuida da identidade visual. Um squad de cybersecurity cuida de compliance e pentest. Um squad de copywriting cuida de persuasão e conversão. Cada um com sua própria knowledge base, workflows e tasks — totalizando **1.200 tasks executáveis** prontas para uso, distribuídas pelos 17 squads.
 
@@ -35,7 +35,7 @@ IA generativa tem um problema conhecido: quanto mais você pede, pior fica. Um
 
 O SINAPSE resolve isso do jeito que times humanos resolvem: **especialização coordenada**. Em vez de um generalista cansado, você tem 172 agentes em 17 squads, cada um com papel definido, knowledge base própria e tasks executáveis. Um orquestrador roteia seu pedido para quem realmente sabe resolver — automaticamente, sem você precisar decorar nomes de agentes ou comandos.
 
-O diferencial não é apenas a quantidade de agentes. É **governança real**: 17 hooks ativos interceptam operações em tempo de execução, uma Constitution com 11 artigos rege o framework, e 7 desses artigos são NON-NEGOTIABLE — violações são bloqueadas antes de executar, não detectadas depois. **Velocidade com rigor, sem escolher entre os dois.**
+O diferencial não é apenas a quantidade de agentes. É **governança real**: 20 hooks registrados interceptam operações em tempo de execução, uma Constitution com 11 artigos rege o framework, e 7 desses artigos são NON-NEGOTIABLE — violações são bloqueadas antes de executar, não detectadas depois. **Velocidade com rigor, sem escolher entre os dois.**
 
 ---
 
@@ -193,7 +193,7 @@ Deny rules em `.claude/settings.json` reforçam isso deterministicamente. **O up
 
 ### Constitution
 
-O SINAPSE é governado por uma Constitution formal com 11 artigos e 17 hooks de enforcement:
+O SINAPSE é governado por uma Constitution formal com 11 artigos e 20 hooks de enforcement:
 
 | Artigo | Princípio | Severidade |
 |--------|-----------|------------|
@@ -219,7 +219,7 @@ O SINAPSE inclui 12 agentes core que cobrem o ciclo completo de desenvolvimento:
 
 | Agente | Persona | Papel |
 |--------|---------|-------|
-| `sinapse-orqx` | **Imperator** | Orquestrador principal — routing e coordenação cross-squad |
+| `snps-orqx` | **Imperator** | Orquestrador principal — routing e coordenação cross-squad |
 | `developer` | **Pixel** | Implementação de código e story development |
 | `quality-gate` | **Litmus** | Testes, QA e quality gates |
 | `architect` | **Stratum** | Arquitetura e decisões de tecnologia |
@@ -313,7 +313,7 @@ Ambas as IDEs têm acesso a todos os 17 squads, 172 agentes, workflows e knowled
 | Funcionalidade | Claude Code | Codex CLI |
 |---------------|:-----------:|:---------:|
 | Ativação de agentes (@agent) | Completo | Completo |
-| Hooks constitucionais (19) | Completo | Parcial (5) |
+| Hooks constitucionais (20) | Completo | Parcial (5) |
 | Story-driven development | Completo | Completo |
 | Quality gates | Completo | Completo |
 | Enforcement de delegação | Completo | Parcial |
@@ -354,7 +354,7 @@ Se você se identifica com o primeiro grupo, você está no lugar certo.
 
 ### Enforcement Constitucional
 
-O SINAPSE não apenas documenta regras — ele as impõe com **17 hooks ativos**:
+O SINAPSE não apenas documenta regras — ele as impõe com **20 hooks registrados**:
 
 - `enforce-git-push-authority.sh` — bloqueia push por agentes não autorizados
 - `enforce-story-gate.cjs` — bloqueia código sem story validada

package/bin/sinapse-minimal.js

@@ -5,10 +5,11 @@
  *
  * REMOVED FROM PUBLIC SURFACE — Story 10.30 (Cycle 5)
  *
- * As of v10.0.0 this binary is no longer registered in package.json
- * `bin`, so `npm install -g sinapse-ai` does not install a
- * `sinapse-minimal` shim anymore. The file is kept in the repo for one
- * release cycle as a forwarder, then will be deleted entirely in v11.
+ * This binary is no longer registered in package.json `bin`, so
+ * `npm install -g sinapse-ai` does not install a `sinapse-minimal` shim
+ * anymore. The file is kept in the repo as a forwarder only, scheduled
+ * for physical removal in the next MAJOR release (the old "v10/v11"
+ * timeline predates the 1.x version reset and no longer applies).
  *
  * Originally deprecated in v3.11.1 (Story 10.13 added the deprecation
  * warning). The "minimal" install is no longer a real distinct mode —

package/docs/community/README-community-snippet-core.md

@@ -49,7 +49,7 @@ We welcome contributions! Check out our:
 
 - 📖 [Contributing Guide](../../CONTRIBUTING.md)
 - 📜 [Code of Conduct](../../CODE_OF_CONDUCT.md)
-- 🏗️ [Coding Standards](../architecture/coding-standards.md)
+- 🏗️ [Coding Standards](../framework/coding-standards.md)
 - 🏷️ [Good First Issues](https://github.com/caioimori/sinapse-ai/labels/good-first-issue)
 
 ---

package/docs/community/README-community-snippet-mcp.md

@@ -31,8 +31,8 @@ For discussions, questions, and community interaction, visit our central hub:
 
 ### Quick Links
 
-- [Docker MCP Toolkit Setup](../docker-mcp-setup.md)
-- [Available Presets](../../presets/)
+- [Docker MCP Toolkit Setup](../guides/docker-mcp-setup.md)
+- [Available Presets](../../.sinapse-ai/presets/)
 - [IDE Integration Guide](../ide-integration.md)
 - [Troubleshooting Guide](../troubleshooting.md)
 

package/docs/framework/README.md

@@ -83,9 +83,9 @@ For backward compatibility, framework docs remain accessible at **both** locatio
 
 ## 🔗 Related Documents
 
-- **Architecture Overview**: [`docs/architecture/`](../architecture/)
+- **Architecture Overview**: [`docs/architecture/`](../pt/architecture/)
 - **Installation Guide**: [`docs/installation/`](../installation/)
-- **Platform Guides**: [`docs/platforms/`](../platforms/)
+- **Platform Guides**: [`docs/platforms/`](../pt/platforms/)
 - **Architecture Decisions**: `docs/decisions/` *(coming soon)*
 - **Epic Planning**: `docs/epics/` *(coming soon)*
 

package/docs/framework/architecture-overview.md

@@ -74,7 +74,7 @@ Localizacao: `.sinapse-ai/development/tasks/`
 
 ### Workflows
 
-Workflows conectam tasks em sequencias. O SINAPSE tem 4 workflows primarios (detalhados em [workflows-overview.md](guides/workflows-overview.md)):
+Workflows conectam tasks em sequencias. O SINAPSE tem 4 workflows primarios (detalhados em [workflows-overview.md](../guides/workflows-overview.md)):
 
 1. **Story Development Cycle (SDC)** --- fluxo principal de desenvolvimento
 2. **QA Loop** --- ciclo iterativo de revisao-correcao
@@ -237,4 +237,4 @@ Cada etapa e rastreavel, documentada e verificavel. O sistema e desenhado para q
 
 ---
 
-_Veja tambem: [Agent Reference](guides/agent-reference.md) | [Workflows Overview](guides/workflows-overview.md) | [Guiding Principles](guiding-principles.md)_
+_Veja tambem: [Agent Reference](../guides/agent-reference.md) | [Workflows Overview](../guides/workflows-overview.md) | [Guiding Principles](guiding-principles.md)_

package/docs/framework/core-architecture.md

@@ -1,6 +1,6 @@
 # SINAPSE Method: Core Architecture
 
-> 🌐 **EN** | [PT](./pt/core-architecture.md)
+> 🌐 **EN** | [PT](../pt/core-architecture.md)
 
 ---
 

package/docs/framework/feature-process.md

@@ -17,13 +17,13 @@ Ideia → Discussao → Decisao → Story → Implementacao → Release
 ## Passo 1: Abra uma Discussion ou Issue
 
 **Para ideias e sugestoes:**
-- Abra uma [Discussion](../../discussions) na categoria **Ideas**
+- Abra uma [Discussion](https://github.com/caioimori/sinapse-ai/discussions) na categoria **Ideas**
 - Descreva o problema que a feature resolve
 - Proponha uma solucao (pode ser alto nivel)
 - Inclua exemplos de uso se possivel
 
 **Para bugs ou melhorias pontuais:**
-- Abra uma [Issue](../../issues) usando o template **Feature Request** ou **Bug Report**
+- Abra uma [Issue](https://github.com/caioimori/sinapse-ai/issues) usando o template **Feature Request** ou **Bug Report**
 - Preencha todos os campos do template
 
 ---
@@ -88,7 +88,7 @@ A implementacao segue o Story Development Cycle (SDC):
 @sprint-lead *draft → @product-lead *validate → @developer *develop → @quality-gate *qa-gate → @devops *push
 ```
 
-O contribuidor pode implementar a feature seguindo o [CONTRIBUTING.md](../CONTRIBUTING.md).
+O contribuidor pode implementar a feature seguindo o [CONTRIBUTING.md](../../CONTRIBUTING.md).
 
 ---
 
@@ -155,8 +155,8 @@ Contribuidores cujas ideias sao implementadas recebem credito em:
 ## Perguntas?
 
 - Abra uma Discussion na categoria **Q&A**
-- Consulte o [Troubleshooting Guide](troubleshooting.md)
+- Consulte o [Troubleshooting Guide](../troubleshooting.md)
 
 ---
 
-_Veja tambem: [CONTRIBUTING.md](../CONTRIBUTING.md) | [Guiding Principles](guiding-principles.md) | [Code of Conduct](../CODE_OF_CONDUCT.md)_
+_Veja tambem: [CONTRIBUTING.md](../../CONTRIBUTING.md) | [Guiding Principles](guiding-principles.md) | [Code of Conduct](../../CODE_OF_CONDUCT.md)_

package/docs/framework/guiding-principles.md

@@ -169,7 +169,7 @@ O SINAPSE e distribuido sob licenca MIT --- qualquer pessoa pode usar, modificar
 
 Isso garante que o framework mantem coerencia e qualidade mesmo com contribuicoes externas.
 
-> Processo de contribuicao: [CONTRIBUTING.md](../CONTRIBUTING.md)
+> Processo de contribuicao: [CONTRIBUTING.md](../../CONTRIBUTING.md)
 
 ---
 

package/docs/framework/roadmap.md

@@ -1,6 +1,6 @@
 # SINAPSE Roadmap
 
-> 🇧🇷 [Versão em Português](ROADMAP-PT.md)
+> 🇧🇷 [Versão em Português](../pt/roadmap.md)
 
 This document outlines the planned development direction for SINAPSE.
 
@@ -89,15 +89,15 @@ Have a new idea? Open an [Idea Discussion](https://github.com/caioimori/sinapse-
 
 ### 3. Write an RFC
 
-For significant features that need detailed design, [submit an RFC](/.github/RFC_TEMPLATE.md) following our structured process.
+For significant features that need detailed design, [submit an RFC](../../.github/RFC_TEMPLATE.md) following our structured process.
 
 ### 4. Contribute Directly
 
-Found something you want to implement? Check our [Contributing Guide](CONTRIBUTING.md) and [Feature Process](docs/feature-process.md).
+Found something you want to implement? Check our [Contributing Guide](../../CONTRIBUTING.md) and [Feature Process](feature-process.md).
 
 ## Changelog
 
-For what's already shipped, see [CHANGELOG.md](CHANGELOG.md).
+For what's already shipped, see [CHANGELOG.md](../../CHANGELOG.md).
 
 ## Update Process
 

package/docs/framework/source-tree.md

@@ -866,7 +866,7 @@ Runtime state is persisted in `.sinapse/`:
 
 - [Coding Standards](./coding-standards.md)
 - [Tech Stack](./tech-stack.md)
-- [ADE Architecture](../architecture/ade-architecture.md) _(planned)_
+- ADE Architecture _(planned)_
 
 ---
 

package/docs/framework/versioning-and-releases.md

@@ -1,6 +1,6 @@
 # How to Release a New Version
 
-> 🌐 **EN** | [PT](./pt/versioning-and-releases.md)
+> 🌐 **EN** | [PT](../pt/versioning-and-releases.md)
 
 ---
 

package/docs/getting-started.md

@@ -20,7 +20,7 @@ O wizard detecta seu ambiente, escolhe IDE (Claude Code ou Codex), instala os 17
 
 ```bash
 npx sinapse-ai status   # squads + agentes instalados
-npx sinapse-ai doctor   # 12 health checks
+npx sinapse-ai doctor   # 16 health checks
 ```
 
 Se algo falhar: `npx sinapse-ai doctor --fix` corrige automaticamente.

package/docs/guides/agent-selection-guide.md

@@ -282,7 +282,7 @@ Retries < 3? → @developer retry with variation
 ## Full Documentation
 
 - **[ADE Complete Guide](./ade-guide.md)** - Full tutorial for Autonomous Development Engine
-- **[Agent Responsibility Matrix](../architecture/agent-responsibility-matrix.md)** - Complete boundary definitions
+- **Agent Responsibility Matrix** - Complete boundary definitions
 
 ---
 

package/docs/guides/agents/traces/README.md

@@ -23,7 +23,7 @@ This directory contains comprehensive runtime execution trace documentation for
 | @architect | Aria (Visionary) | 21 | Direct | [architect-execution-trace.md](./architect-execution-trace.md) |
 | @developer | Dex (Builder) | 36 | Direct | [dev-execution-trace.md](./dev-execution-trace.md) |
 | @quality-gate | Quinn (Guardian) | 25 | Direct | [qa-execution-trace.md](./qa-execution-trace.md) |
-| @sinapse-orqx | Nova (Orchestrator) | 33 | Direct | [sinapse-orqx-execution-trace.md](./sinapse-orqx-execution-trace.md) |
+| @sinapse-orqx | Nova (Orchestrator) | 33 | Direct | [snps-orqx-execution-trace.md](./snps-orqx-execution-trace.md) |
 | @devops | Gage (Pipeline) | 30 | CLI Wrapper | [devops-execution-trace.md](./devops-execution-trace.md) |
 | @data-engineer | Dara (Architect) | 27 | CLI Wrapper | [data-engineer-execution-trace.md](./data-engineer-execution-trace.md) |
 | @ux-design-expert | Uma (Harmonizer) | 24 | CLI Wrapper | [ux-design-expert-execution-trace.md](./ux-design-expert-execution-trace.md) |

package/docs/guides/config-migration-guide.md

@@ -2,7 +2,7 @@
 
 Migrate from monolithic `core-config.yaml` to the layered configuration hierarchy.
 
-**ADR:** [ADR-PRO-002 — Configuration Hierarchy](../architecture/adr/adr-pro-002-configuration-hierarchy.md)
+**ADR:** ADR-PRO-002 — Configuration Hierarchy
 **Story:** PRO-4 — Core-Config Split Implementation
 
 ---

package/docs/guides/development-setup.md

@@ -1103,7 +1103,7 @@ node --inspect node_modules/.bin/jest
 ## Related Documentation
 
 - [User Guide](./user-guide.md) - End-user documentation
-- [Architecture Overview](../architecture/ARCHITECTURE-INDEX.md) - System design
+- [Architecture Overview](../pt/architecture/ARCHITECTURE-INDEX.md) - System design
 - [Contributing Squads](./contributing-squads.md) - Squad development
 - [Quality Gates Guide](./quality-gates.md) - Quality assurance
 - [MCP Global Setup](./mcp-global-setup.md) - MCP configuration

package/docs/guides/docker-mcp-setup.md

@@ -415,11 +415,11 @@ Only use docker-gateway when:
 
 ## Related Documentation
 
-- [Docker Gateway Tutorial](./guides/mcp/docker-gateway-tutorial.md)
-- [Desktop Commander MCP Guide](./guides/mcp/desktop-commander.md)
-- [MCP Global Setup Guide](./guides/mcp-global-setup.md)
-- [MCP Architecture Diagrams](./architecture/mcp-system-diagrams.md)
-- [DevOps Agent](../.sinapse-ai/development/agents/devops.md)
+- [Docker Gateway Tutorial](./mcp/docker-gateway-tutorial.md)
+- [Desktop Commander MCP Guide](./mcp/desktop-commander.md)
+- [MCP Global Setup Guide](./mcp-global-setup.md)
+- MCP Architecture Diagrams
+- [DevOps Agent](../../.sinapse-ai/development/agents/devops.md)
 
 ---
 

package/docs/guides/getting-started.md

@@ -176,7 +176,7 @@ npx sinapse-ai info
 - **Explorar os squads** — `@snps-orqx *status` mostra todos os dominios disponiveis (alias `@sinapse-orqx` ate v1.3.0)
 - **Entender os workflows** — Leia `docs/guides/workflows-overview.md`
 - **Integracao com IDEs** — Veja [IDE Integration](./ide-integration.md) para Claude Code, Gemini CLI, Codex CLI, Cursor e GitHub Copilot
-- **Contribuir** — Leia [CONTRIBUTING.md](../CONTRIBUTING.md)
+- **Contribuir** — Leia [CONTRIBUTING.md](../../CONTRIBUTING.md)
 
 ---
 

package/docs/guides/git-workflow-guide.md

@@ -1,6 +1,6 @@
 # SINAPSE Git Workflow Guide
 
-> 🌐 **EN** | [PT](./pt/git-workflow-guide.md)
+> 🌐 **EN** | [PT](../pt/git-workflow-guide.md)
 
 ---
 
@@ -978,8 +978,8 @@ strategy:
 
 ## References
 
-- **SINAPSE Validator:** [.sinapse-ai/utils/sinapse-validator.js](../.sinapse-ai/utils/sinapse-validator.js)
-- **CI Workflow:** [.github/workflows/ci.yml](../.github/workflows/ci.yml)
+- **SINAPSE Validator:** [.sinapse-ai/utils/sinapse-validator.js](../../.sinapse-ai/utils/sinapse-validator.js)
+- **CI Workflow:** [.github/workflows/ci.yml](../../.github/workflows/ci.yml)
 
 ---
 

package/docs/guides/ide-integration.md

@@ -228,9 +228,9 @@ cat ~/.claude.json  # For Claude Code
 
 ## Related Documentation
 
-- [Claude Code Guide](./pt/platforms/claude-code.md)
-- [Agent Selection Guide](./guides/agent-selection-guide.md)
-- [MCP Global Setup](./guides/mcp-global-setup.md)
+- [Claude Code Guide](../pt/platforms/claude-code.md)
+- [Agent Selection Guide](./agent-selection-guide.md)
+- [MCP Global Setup](./mcp-global-setup.md)
 
 ---
 

package/docs/guides/ide-sync-guide.md

@@ -185,5 +185,5 @@ Check that the IDE is enabled in `active_ides` section.
 
 - [Squads Overview](./squads-overview.md)
 - [Agent Reference](../agent-reference-guide.md)
-- [SINAPSE Architecture](../core-architecture.md)
+- [SINAPSE Architecture](../framework/core-architecture.md)
 

package/docs/guides/mcp/desktop-commander.md

@@ -344,9 +344,9 @@ npm install -g @anthropic/desktop-commander@latest
 
 - [Docker Gateway Tutorial](./docker-gateway-tutorial.md)
 - [MCP Global Setup Guide](../mcp-global-setup.md)
-- [Docker MCP Setup](../../docker-mcp-setup.md)
+- [Docker MCP Setup](../docker-mcp-setup.md)
 - [MCP Usage Rules](../../../.claude/rules/mcp-usage.md)
-- [Agent Tool Integration](../../architecture/agent-tool-integration-guide.md)
+- [Agent Tool Integration](../../pt/architecture/agent-tool-integration-guide.md)
 
 ---
 

package/docs/guides/mcp/docker-gateway-tutorial.md

@@ -329,7 +329,7 @@ echo "~/.docker/mcp/" >> ~/.gitignore_global
 
 - [Desktop Commander MCP Guide](./desktop-commander.md)
 - [MCP Global Setup Guide](../mcp-global-setup.md)
-- [Docker MCP Setup](../../docker-mcp-setup.md)
+- [Docker MCP Setup](../docker-mcp-setup.md)
 
 ---
 

package/docs/guides/mcp-global-setup.md

@@ -687,9 +687,9 @@ Create `.mcp.json` in project root to override global settings:
 
 - [Docker Gateway Tutorial](./mcp/docker-gateway-tutorial.md)
 - [Desktop Commander MCP Guide](./mcp/desktop-commander.md)
-- [Docker MCP Setup](../docker-mcp-setup.md)
-- [Module System Architecture](../architecture/module-system.md)
-- [MCP Architecture Diagrams](../architecture/mcp-system-diagrams.md)
+- [Docker MCP Setup](./docker-mcp-setup.md)
+- [Module System Architecture](../pt/architecture/module-system.md)
+- [MCP Architecture Diagrams](../pt/architecture/mcp-system-diagrams.md)
 
 ---
 

package/docs/guides/memory-intelligence-system.md

@@ -3,8 +3,8 @@
 **Versao:** 2.1 (Target State — Core/Pro Split)
 **Ultima Atualizacao:** 2026-02-09
 **Autor:** @architect (Aria)
-**Epic:** [MIS — Memory Intelligence System](../stories/epics/epic-memory-intelligence-system/EPIC-MIS-INDEX.md)
-**Baseado Em:** [MIS-1 Investigation](../stories/epics/epic-memory-intelligence-system/story-mis-1-investigation.md)
+**Epic:** MIS — Memory Intelligence System
+**Baseado Em:** MIS-1 Investigation
 **Documento Atual:** [memory-system.md](memory-system.md) (estado atual v1.0)
 **Tags:** memory, intelligence, session-digest, progressive-retrieval, self-learning, attention-routing, core-pro-split
 
@@ -1059,14 +1059,14 @@ gantt
 | Recurso | Caminho |
 |---------|---------|
 | Estado Atual (v1.0) | [memory-system.md](memory-system.md) |
-| Epic MIS Index | [EPIC-MIS-INDEX.md](../stories/epics/epic-memory-intelligence-system/EPIC-MIS-INDEX.md) |
-| MIS-1 Investigation | [story-mis-1-investigation.md](../stories/epics/epic-memory-intelligence-system/story-mis-1-investigation.md) |
-| MIS-2 Dead Code Cleanup | [story-mis-2-dead-code-cleanup.md](../stories/epics/epic-memory-intelligence-system/story-mis-2-dead-code-cleanup.md) |
-| Epic PRO Architecture | [EPIC-PRO-INDEX.md](../stories/epics/epic-pro-sinapse-pro-architecture/EPIC-PRO-INDEX.md) |
-| ADR-PRO-001 Repository Strategy | [adr-pro-001-repository-strategy.md](../architecture/adr/adr-pro-001-repository-strategy.md) |
-| ADR-PRO-003 Feature Gating | [adr-pro-003-feature-gating-licensing.md](../architecture/adr/adr-pro-003-feature-gating-licensing.md) |
-| Pro Detector | [bin/utils/pro-detector.js](../../bin/utils/pro-detector.js) |
-| Feature Registry | [pro/feature-registry.yaml](../../pro/feature-registry.yaml) |
+| Epic MIS Index | EPIC-MIS-INDEX.md |
+| MIS-1 Investigation | story-mis-1-investigation.md |
+| MIS-2 Dead Code Cleanup | story-mis-2-dead-code-cleanup.md |
+| Epic PRO Architecture | EPIC-PRO-INDEX.md |
+| ADR-PRO-001 Repository Strategy | adr-pro-001-repository-strategy.md |
+| ADR-PRO-003 Feature Gating | adr-pro-003-feature-gating-licensing.md |
+| Pro Detector | bin/utils/pro-detector.js |
+| Feature Registry | pro/feature-registry.yaml |
 
 ---
 

package/docs/guides/meta-agent-commands.md

@@ -1,6 +1,6 @@
 # Meta-Agent Commands Reference
 
-> 🌐 **EN** | [PT](./pt/meta-agent-commands.md)
+> 🌐 **EN** | [PT](../pt/meta-agent-commands.md)
 
 ---
 

package/docs/guides/quality-gates.md

@@ -600,7 +600,7 @@ verbose:
 
 ## Related Documentation
 
-- [Module System Architecture](../architecture/module-system.md)
+- Module System Architecture
 - [Service Discovery Guide](./service-discovery.md)
 
 ---

package/docs/guides/security-hardening.md

@@ -1349,7 +1349,7 @@ Currently, SINAPSE does not have a formal bug bounty program. However, significa
 
 ## Related Documentation
 
-- [Security Best Practices](../security-best-practices.md) - General security guidelines
+- [Security Best Practices](../security/security-best-practices.md) - General security guidelines
 - [Permission Modes Guide](./permission-modes.md) - Agent autonomy control
 - [MCP Global Setup](./mcp-global-setup.md) - Secure MCP configuration
 - [Quality Gates](./quality-gates.md) - Security checks in CI/CD

package/docs/guides/service-discovery.md

@@ -507,7 +507,7 @@ await registry.load(true);
 
 ## Related Documentation
 
-- [Module System Architecture](../architecture/module-system.md)
+- [Module System Architecture](../pt/architecture/module-system.md)
 - [Quality Gates Guide](./quality-gates.md)
 
 ---

package/docs/guides/squad-examples/README.md

@@ -45,7 +45,7 @@ Each example includes comments explaining:
 
 ## Creating Your Own
 
-1. Start with the [Squad Template](../../../templates/squad/)
+1. Start with the [Squad Template](../../../.sinapse-ai/development/templates/squad-template/)
 2. Reference these examples for patterns
 3. Follow the [Squads Guide](../squads-guide.md)
 

package/docs/guides/squads-guide.md

@@ -809,7 +809,7 @@ npm test -- tests/squads/my-squad/
 - [TASK-FORMAT-SPECIFICATION-V1](../../.sinapse-ai/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md)
 - [Contributing Squads Guide](./contributing-squads.md)
 - [Squad Migration Guide](./squad-migration.md)
-- [Squads API Reference](../api/squads-api.md)
+- Squads API Reference
 - [@squad-creator Agent](../../.sinapse-ai/development/agents/squad-creator.md)
 - [sinapse-squads Repository](https://github.com/caioimori/sinapse-squads)
 

package/docs/guides/testing-guide.md

@@ -1207,8 +1207,8 @@ module.exports = {
 ## Related Documentation
 
 - [Quality Gates Guide](./quality-gates.md) - Automated quality checks
-- [CI/CD Architecture](../architecture/ci-cd.md) - Pipeline configuration
-- [Contributing Guide](../how-to-contribute-with-pull-requests.md) - Development workflow
+- CI/CD Architecture - Pipeline configuration
+- [Contributing Guide](../../CONTRIBUTING.md) - Development workflow
 
 ---