sinapse-ai 7.7.10 → 8.0.0

package/docs/getting-started.md

@@ -1,311 +1,195 @@
-# Getting Started with SINAPSE
+# Comecando com SINAPSE-AI
 
-> **EN** | [PT](./pt/getting-started.md) | [ES](./es/getting-started.md)
+> Guia de onboarding profissional. Objetivo: **first-value em 10 minutos**.
 
 ---
 
-Welcome to SINAPSE. This guide is optimized for first-value in 10 minutes.
+## Criterio de Sucesso
 
-## Table of Contents
+Voce atingiu o "first-value" quando estas 3 condicoes forem verdadeiras:
 
-1. [10-Minute Quick Path](#10-minute-quick-path)
-2. [Installation](#installation)
-3. [Your First Project](#your-first-project)
-4. [Basic Commands](#basic-commands)
-5. [IDE Compatibility](#ide-compatibility)
-6. [Brownfield: Existing Projects](#brownfield-existing-projects)
-7. [Advanced Path](#advanced-path)
-8. [Troubleshooting](#troubleshooting)
-9. [Next Steps](#next-steps)
+1. Um agente SINAPSE foi ativado
+2. O greeting completo foi exibido
+3. Um comando util foi executado (`*help` ou equivalente)
 
-## 10-Minute Quick Path
+**Regra:** complete as 3 condicoes em ate 10 minutos.
 
-Use this exact flow if you are new:
-
-### Step 1: Install SINAPSE
-
-```bash
-# New project
-npx sinapse-ai init my-first-project
-cd my-first-project
-
-# Existing project
-# cd existing-project
-# npx sinapse-ai install
-```
-
-### Step 2: Pick your IDE activation path
-
-- Claude Code: `/agent-name`
-- Gemini CLI: `/sinapse-menu` then `/sinapse-<agent>`
-- Codex CLI: `/skills` then `sinapse-<agent-id>`
-- Cursor/Copilot: follow constraints in `docs/ide-integration.md`
-
-### Step 3: Validate first value
+---
 
-First value is achieved when all 3 conditions are true:
-1. You activate one SINAPSE agent.
-2. You receive a valid greeting/activation response.
-3. You run one starter command (`*help` or equivalent) and get useful output.
+## Pre-requisitos
 
-PASS rule: complete all 3 conditions in <= 10 minutes.
+| Requisito | Versao Minima | Recomendado |
+|-----------|---------------|-------------|
+| Node.js | >= 18.0.0 | v20+ |
+| npm | >= 9.0.0 | Ultima estavel |
+| Claude Code CLI | Ultima versao | — |
+| Git | Qualquer | Ultima estavel |
 
-## Installation
+> **Codex CLI** tambem e suportado. Veja [IDE Integration](./ide-integration.md) para outras opcoes.
 
-### Prerequisites
+---
 
-- **Node.js** version 18.0.0 or higher (v20+ recommended)
-- **npm** version 9.0.0 or higher
-- **Git** (optional, but recommended)
+## Instalacao (3 minutos)
 
-### Quick Installation
+### Projeto Novo
 
 ```bash
-# Create a new project
-npx sinapse-ai init my-first-project
-
-# Navigate to your project
-cd my-first-project
-
-# Start using SINAPSE agents in your IDE
-# (see Step 2 above for IDE-specific activation)
+npx sinapse-ai init meu-projeto
+cd meu-projeto
 ```
 
-### Installation Options
+### Projeto Existente
 
 ```bash
-# 1. Create new project with custom template
-npx sinapse-ai init my-project --template enterprise
-
-# 2. Install in existing project
-cd existing-project
+cd meu-projeto-existente
 npx sinapse-ai install
-
-# 3. Force installation in non-empty directory
-npx sinapse-ai init my-project --force
-
-# 4. Skip dependency installation (manual install later)
-npx sinapse-ai init my-project --skip-install
 ```
 
-## Your First Project
+O wizard interativo vai configurar:
+- **Idioma** (PT/EN)
+- **LLM provider** (Claude, Gemini, Codex)
+- **Squads** para instalar (escolha quais dominios ativar)
 
-### Project Structure
+A instalacao e **nao-destrutiva** — seus arquivos existentes nao sao sobrescritos.
 
-After installation, your project will include:
-
-```
-my-first-project/
-├── .sinapse-ai/                 # SINAPSE framework core
-│   ├── core/                   # Orchestration, memory, config
-│   ├── data/                   # Knowledge base, entity registry
-│   ├── development/            # Agents, tasks, templates, scripts
-│   └── infrastructure/         # CI/CD templates, validation scripts
-├── .claude/                    # Claude Code integration (if enabled)
-├── .codex/                     # Codex CLI integration (if enabled)
-├── .gemini/                    # Gemini CLI integration (if enabled)
-├── docs/                       # Documentation
-│   └── stories/                # Development stories
-├── packages/                   # Shared packages
-├── tests/                      # Test suites
-└── package.json                # Project dependencies
-```
-
-### Configuration
+---
 
-SINAPSE configuration lives in `.sinapse-ai/core/config/`. The installer handles initial setup. To verify your installation:
+## Verificacao (1 minuto)
 
 ```bash
 npx sinapse-ai doctor
 ```
 
-## Basic Commands
-
-### Agent Activation
-
-SINAPSE agents are activated through your IDE. Once activated, agents respond to commands prefixed with `*`:
+Todos os checks devem passar (verde). Se houver warnings, execute:
 
 ```bash
-# Universal commands (work in any agent)
-*help                    # Show available commands for this agent
-*guide                   # Show detailed usage guide
-*session-info            # Display current session details
-*exit                    # Exit agent mode
-
-# Agent-specific examples
-@developer *help               # Developer agent commands
-@quality-gate *review STORY-42     # QA agent reviews a story
-@project-lead *create-epic         # PM agent creates an epic
-@sprint-lead *draft               # Scrum Master drafts a story
+npx sinapse-ai doctor --fix
 ```
 
-### Available Agents
+---
 
-| Agent | Name | Focus |
-| --- | --- | --- |
-| `@dev` | Dex | Code implementation, bug fixes, refactoring |
-| `@qa` | Quinn | Testing, quality gates, code review |
-| `@architect` | Aria | System design, technical decisions |
-| `@pm` | Bob | PRDs, strategy, roadmap |
-| `@po` | Pax | Backlog, story validation, prioritization |
-| `@sm` | River | Story creation, sprint planning |
-| `@analyst` | Alex | Research, competitive analysis |
-| `@data-engineer` | Dara | Database design, migrations |
-| `@ux-design-expert` | Uma | UI/UX design, accessibility |
-| `@devops` | Gage | Git operations, CI/CD, deployments |
+## Primeiro Agente (3 minutos)
 
-### Typical Workflow
+No Claude Code, digite:
 
 ```
-1. @project-lead creates a PRD          → *create-epic
-2. @sprint-lead drafts stories          → *draft
-3. @product-lead validates stories       → *validate-story-draft
-4. @developer implements             → (works from story file)
-5. @quality-gate reviews                 → *review STORY-ID
-6. @devops pushes              → *push (only agent with push authority)
-7. @product-lead closes story            → *close-story STORY-ID
+@developer
 ```
 
-## IDE Compatibility
-
-Not all IDEs support SINAPSE features equally. See the full comparison at [`docs/ide-integration.md`](./ide-integration.md).
-
-Summary:
-
-| IDE/CLI | Overall Status | How to Activate |
-| --- | --- | --- |
-| Claude Code | Works | `/agent-name` commands |
-| Gemini CLI | Works | `/sinapse-menu` then `/sinapse-<agent>` |
-| Codex CLI | Limited | `/skills` then `sinapse-<agent-id>` |
-| Cursor | Limited | `@agent` + synced rules |
-| GitHub Copilot | Limited | chat modes + repo instructions |
-
-
-- **Works**: fully recommended for new users.
-- **Limited**: usable with documented workarounds.
+O agente **Pixel** vai se apresentar com greeting completo, mostrando seu papel, comandos disponiveis e o estado do projeto.
 
-## Brownfield: Existing Projects
+### Comandos Essenciais
 
-Already have a codebase? SINAPSE handles brownfield projects with a dedicated workflow.
+| Comando | O que faz |
+|---------|-----------|
+| `*help` | Lista todos os comandos do agente ativo |
+| `*guide` | Guia detalhado de uso |
+| `*session-info` | Informacoes da sessao atual |
+| `*exit` | Sair do modo agente |
 
-### Quick Brownfield Setup
-
-```bash
-# Navigate to your existing project
-cd my-existing-project
+---
 
-# Install SINAPSE (non-destructive, preserves your config)
-npx sinapse-ai install
+## Primeiro Workflow (3 minutos)
 
-# Run doctor to verify compatibility
-npx sinapse-ai doctor
+```
+@sprint-lead
+*draft
 ```
 
-### What Happens on First Run
-
-When you first activate an SINAPSE agent in an existing project:
-
-1. **Detection**: SINAPSE detects code but no SINAPSE docs
-2. **Offer**: "I can analyze your codebase. This takes 4-8 hours."
-3. **Discovery**: Multi-agent technical debt assessment (optional)
-4. **Output**: System architecture docs + technical debt report
-
-### Brownfield Workflow Options
-
-| Your Situation | Recommended Workflow |
-|----------------|---------------------|
-| Add major feature to existing project | `@project-lead → *create-doc brownfield-prd` |
-| Audit legacy codebase | `brownfield-discovery.yaml` (full workflow) |
-| Quick enhancement | `@project-lead → *brownfield-create-epic` |
-| Single bug fix | `@project-lead → *brownfield-create-story` |
+O agente **Sync** vai guiar a criacao da sua primeira story de desenvolvimento. Stories sao o ponto de partida de todo trabalho no SINAPSE — elas definem o que sera implementado, com criterios de aceite claros.
 
-### Safety Guarantees
+### Fluxo Completo
 
-- **Non-destructive**: SINAPSE creates files, never overwrites existing
-- **Rollback**: `git checkout HEAD~1 -- .` restores pre-SINAPSE state
-- **Config preservation**: Your `.eslintrc`, `tsconfig.json`, etc. stay intact
+```
+@sprint-lead *draft          --> Cria a story
+@product-lead *validate      --> Valida criterios
+@developer                   --> Implementa
+@quality-gate *review        --> Verifica qualidade
+@devops *push                --> Envia para o repositorio
+```
 
-### Resources
+---
 
-- **[Working in the Brownfield Guide](.sinapse-ai/working-in-the-brownfield.md)** - Complete brownfield documentation
-- **[Compatibility Checklist](.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md)** - Pre/post migration checks
-- **[Risk Report Template](.sinapse-ai/product/templates/brownfield-risk-report-tmpl.yaml)** - Phase-by-phase risk assessment
+## Agentes Disponiveis
+
+| Ativacao | Persona | Foco |
+|----------|---------|------|
+| `@developer` | Pixel | Implementacao de codigo, bug fixes, refactoring |
+| `@quality-gate` | Quinn | Testes, quality gates, code review |
+| `@architect` | Aria | Design de sistema, decisoes tecnicas |
+| `@project-lead` | Morgan | PRDs, estrategia, roadmap |
+| `@product-lead` | Pax | Backlog, validacao de stories, priorizacao |
+| `@sprint-lead` | Sync | Criacao de stories, planejamento de sprint |
+| `@analyst` | Alex | Pesquisa, analise competitiva |
+| `@data-engineer` | Dara | Database design, migracoes |
+| `@ux-design-expert` | Uma | UI/UX design, acessibilidade |
+| `@devops` | Gage | Git operations, CI/CD, deploys |
 
 ---
 
-## Advanced Path
-
-For experienced users who want to go deeper:
+## Greenfield vs Brownfield
 
-### Sync and Validation
+| Cenario | Comando | O que acontece |
+|---------|---------|----------------|
+| **Projeto novo** | `npx sinapse-ai init meu-projeto` | Estrutura completa criada do zero |
+| **Projeto existente** | `npx sinapse-ai install` | Installer detecta automaticamente e preserva seus arquivos |
 
-```bash
-# Sync agents to all configured IDEs
-npm run sync:ide
+Para projetos existentes, o SINAPSE oferece um workflow de **Brownfield Discovery** que analisa a codebase e gera documentacao de arquitetura e divida tecnica. Ative com:
 
-# Validate cross-IDE parity
-npm run validate:parity
-
-# Run all quality checks
-npm run lint && npm run typecheck && npm test
+```
+@project-lead *brownfield-create-epic
 ```
 
-### Documentation-First Development
-
-All SINAPSE development follows the documentation pipeline automatically. Stories live in `docs/stories/`. Each story contains:
-- Acceptance criteria with checkboxes
-- Tasks mapped to specific ACs
-- CodeRabbit integration for automated review
-- Quality gate assignments
-
-See the [User Guide](./guides/user-guide.md) for the complete workflow.
-
-### Squad Expansions
-
-Squads extend SINAPSE beyond software development into any domain. See [Squads Guide](./guides/squads-guide.md).
+---
 
 ## Troubleshooting
 
-### Installation Issues
+| Problema | Solucao |
+|----------|---------|
+| `sinapse-ai: command not found` | Execute `npx sinapse-ai install` novamente |
+| Doctor mostra warnings | Execute `npx sinapse-ai doctor --fix` |
+| Agente nao ativa | Verifique se `.sinapse-ai/` existe no projeto |
+| Hooks nao funcionam | Verifique `.claude/settings.json` |
+| Versao do Node incompativel | Atualize para Node.js >= 18 (`node --version`) |
+| Erro no wizard de instalacao | Tente `npx sinapse-ai install --force` |
+
+### Diagnostico Avancado
 
 ```bash
-# Check Node.js version
-node --version  # Should be >= 18.0.0
+# Verificar versao do Node
+node --version
 
-# Run diagnostics
+# Verificar instalacao
 npx sinapse-ai doctor
 
-# Auto-fix common issues
+# Corrigir problemas automaticamente
 npx sinapse-ai doctor --fix
+
+# Informacoes do sistema
+npx sinapse-ai info
 ```
 
-### Agent Not Responding
+---
 
-1. Verify your IDE is supported (see [IDE Compatibility](#ide-compatibility)).
-2. Run `npm run sync:ide` to refresh agent files.
-3. Restart your IDE/CLI session.
+## Proximos Passos
 
-### Sync Issues
+- **Explorar os squads** — `@sinapse-orqx *status` mostra todos os dominios disponiveis
+- **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)
 
-```bash
-# Preview what would change
-npm run sync:ide -- --dry-run
-
-# Force re-sync
-npm run sync:ide
+---
 
-# Validate after sync
-npm run validate:parity
-```
+## Validacao Final
 
-## Next Steps
+| Criterio | Status |
+|----------|--------|
+| Agente ativou | PASS / FAIL |
+| Greeting exibiu | PASS / FAIL |
+| `*help` mostrou comandos | PASS / FAIL |
 
-- **[User Guide](./guides/user-guide.md)** - Complete workflow from planning to delivery
-- **[IDE Integration](./ide-integration.md)** - Detailed setup per IDE
-- **[Architecture](./architecture/ARCHITECTURE-INDEX.md)** - Technical deep dive
-- **[Squads Guide](./guides/squads-guide.md)** - Extend SINAPSE to any domain
-- **[Troubleshooting](./troubleshooting.md)** - Common issues and solutions
+Se algum criterio falhou, abra uma [issue](https://github.com/caioimori/sinapse-ai/issues/new?template=1-bug-report.yml).
 
 ---
 
-_SINAPSE Getting Started Guide v4.2.11_
+_SINAPSE Getting Started Guide v5.0_

package/docs/guides/agent-reference.md

@@ -0,0 +1,203 @@
+# Referencia de Agentes
+
+> Indice navegavel de todos os agentes do ecossistema SINAPSE-AI.
+
+---
+
+## 12 Agentes Core
+
+Os agentes core cobrem o ciclo completo de desenvolvimento de software.
+
+| ID | Persona | Papel | Comandos Principais |
+|----|---------|-------|---------------------|
+| `@developer` | Pixel | Implementacao de codigo | `*develop`, `*task`, `*improve-code-quality` |
+| `@quality-gate` | Litmus | Testes e qualidade | `*qa-gate`, `*qa-loop`, `*review` |
+| `@architect` | Stratum | Arquitetura e design tecnico | `*create-doc architecture`, `*assess-complexity` |
+| `@project-lead` | Beacon | Product Management e epics | `*create-epic`, `*execute-epic`, `*spec-pipeline` |
+| `@product-lead` | Axis | Product Owner, stories e backlog | `*validate-story-draft`, `*create-story`, `*backlog` |
+| `@sprint-lead` | Sync | Scrum Master e criacao de stories | `*draft`, `*create-story`, `*sprint-plan` |
+| `@analyst` | Scope | Pesquisa e analise | `*research`, `*analyze`, `*report` |
+| `@data-engineer` | Tensor | Database e engenharia de dados | `*create-migration`, `*schema-design`, `*db-audit` |
+| `@ux-design-expert` | Mosaic | UX/UI design | `*create-wireframe`, `*ux-audit`, `*design-system` |
+| `@devops` | Pipeline | CI/CD, git push (EXCLUSIVO) | `*push`, `*release`, `*setup-ci` |
+| `@sinapse-orqx` | Imperator | Orquestrador principal | `*diagnose`, `*route`, `*orchestrate` |
+| `@squad-creator` | Loom | Criacao de novos squads | `*create-squad`, `*scaffold` |
+
+---
+
+## 18 Squads
+
+Squads sao agrupamentos tematicos de agentes especialistas. Cada squad tem um orquestrador (*-orqx) que coordena o trabalho interno.
+
+| Squad | Agentes | Dominio | Orquestrador |
+|-------|---------|---------|-------------|
+| squad-animations | Especialistas em motion | Animacoes web, micro-interacoes | @animations-orqx (Kinetic) |
+| squad-brand | Especialistas em marca | Branding, identidade visual | @brand-orqx (Meridian) |
+| squad-claude | Especialistas Claude Code | Mastery de Claude Code | @claude-orqx (Nucleus) |
+| squad-cloning | Especialistas em clonagem | Clonagem cognitiva de personas | @cloning-orqx (Helix) |
+| squad-commercial | Especialistas em vendas | Vendas, CRM, pipeline | @commercial-orqx (Pipeline) |
+| squad-content | Especialistas em conteudo | Editorial, estrategia de conteudo | @content-orqx |
+| squad-copy | Especialistas em copy | Copywriting, persuasao | @copy-orqx (Quill) |
+| squad-council | Conselheiros estrategicos | Conselho estrategico, decisoes | @council-orqx (Zenith) |
+| squad-courses | Especialistas em cursos | Cursos, workshops, educacao | @courses-orqx (Syllabus) |
+| squad-cybersecurity | Especialistas em seguranca | Seguranca, compliance, LGPD | @cyber-orqx (Fortress) |
+| squad-design | Especialistas em design | UX/UI, design system | @design-orqx (Nexus) |
+| squad-finance | Especialistas financeiros | Financeiro, pricing, valuation | @finance-orqx (Ledger) |
+| squad-growth | Especialistas em growth | SEO, analytics, growth hacking | @growth-orqx (Catalyst) |
+| squad-paidmedia | Especialistas em midia paga | Ads, campanhas, ROAS | @paidmedia-orqx (Apex) |
+| squad-product | Especialistas em produto | Roadmap, discovery, metricas | @product-orqx (Vector) |
+| squad-research | Especialistas em pesquisa | Pesquisa, inteligencia competitiva | @research-orqx (Prism) |
+| squad-storytelling | Especialistas em narrativa | Storytelling, pitch, apresentacoes | @storytelling-orqx (Arc) |
+| claude-code-mastery | Especialistas avancados | Tecnicas avancadas de Claude Code | (integrado ao squad-claude) |
+
+**Total: 175 agentes** (12 core + 163 em squads)
+
+---
+
+## Como Ativar Agentes
+
+### Metodo 1: Comando direto
+
+```
+@developer
+```
+
+Digite `@` seguido do ID do agente. O SYNAPSE Engine carrega a persona, dependencias e contexto automaticamente.
+
+### Metodo 2: Comando completo
+
+```
+/SINAPSE:agents:developer
+```
+
+Formato completo com namespace. Util em ambientes onde `@` tem outro significado.
+
+### O que acontece na ativacao
+
+1. SYNAPSE Engine detecta o comando
+2. Pipeline de 8 camadas (L0-L7) carrega contexto
+3. Greeting personalizado e exibido
+4. Agente aguarda seu comando (HALT)
+
+**O agente NAO executa acoes automaticamente.** Ele apresenta o greeting e espera.
+
+---
+
+## Como Usar Comandos
+
+Todos os comandos de agentes usam o prefixo `*`:
+
+| Comando | Funcao | Exemplo |
+|---------|--------|---------|
+| `*help` | Lista comandos disponiveis do agente ativo | `*help` |
+| `*create-story` | Cria uma story de desenvolvimento | `*create-story` |
+| `*task {nome}` | Executa uma task especifica | `*task develop-story` |
+| `*exit` | Sai do modo agente atual | `*exit` |
+
+### Exemplos de Uso
+
+```
+@developer          --> ativa Pixel (developer)
+*help               --> lista comandos do Pixel
+*develop            --> inicia desenvolvimento da story
+*task fix-qa-issues --> executa task de correcao de QA
+```
+
+```
+@quality-gate       --> ativa Litmus (QA)
+*qa-gate            --> executa quality gate na story
+*qa-loop 8.15       --> inicia loop de QA para story 8.15
+```
+
+```
+@sprint-lead        --> ativa Sync (Scrum Master)
+*draft              --> cria rascunho de nova story
+*create-story       --> cria story completa
+```
+
+---
+
+## Protocolo de Handoff entre Agentes
+
+Quando voce troca de agente (`@developer` → `@quality-gate`), o SINAPSE executa um protocolo de compactacao:
+
+1. **Agente anterior** gera um artefato de handoff (~379 tokens) com:
+   - Story ativa e status
+   - Decisoes tomadas
+   - Arquivos modificados
+   - Blockers ativos
+   - Proxima acao sugerida
+
+2. **Agente novo** recebe:
+   - Sua propria persona completa
+   - Artefato de handoff do agente anterior
+   - NAO recebe a persona completa do agente anterior
+
+**Resultado:** economia de 33-57% de contexto por troca de agente.
+
+Limite: maximo 3 handoffs retidos. O mais antigo e descartado no 4o switch.
+
+---
+
+## Criando Agentes Customizados
+
+O SINAPSE permite criar novos squads com agentes especializados usando @squad-creator (Loom):
+
+```
+@squad-creator
+*create-squad
+```
+
+Loom guia voce pelo processo:
+
+1. Define o dominio do squad
+2. Identifica especialistas necessarios
+3. Cria a estrutura de arquivos (orquestrador + especialistas)
+4. Registra no ecossistema
+
+**Localizacao dos squads:** `squads/squad-{nome}/`
+
+Cada squad segue a mesma estrutura:
+```
+squads/squad-{nome}/
+  squad.yaml          # Configuracao do squad
+  agents/             # Definicoes dos agentes
+  tasks/              # Tasks especificas do dominio
+  templates/          # Templates do dominio
+```
+
+---
+
+## Mapeamento Agente → Codebase
+
+Cada agente core tem diretorios primarios de atuacao:
+
+| Agente | Diretorios Principais |
+|--------|----------------------|
+| @developer (Pixel) | `packages/`, `.sinapse-ai/core/`, `bin/` |
+| @architect (Stratum) | `docs/architecture/`, system design |
+| @data-engineer (Tensor) | `packages/db/`, migrations, schema |
+| @quality-gate (Litmus) | `tests/`, `*.test.js`, quality gates |
+| @product-lead (Axis) | Stories, epics, requirements |
+| @devops (Pipeline) | `.github/`, CI/CD, git operations |
+
+---
+
+## Autoridade Exclusiva
+
+Cada agente tem operacoes que SOMENTE ele pode executar:
+
+| Operacao | Agente Exclusivo | Outros Agentes |
+|----------|-----------------|----------------|
+| `git push` | @devops (Pipeline) | BLOQUEADO |
+| Criar PR | @devops (Pipeline) | BLOQUEADO |
+| Criar story | @sprint-lead (Sync) | BLOQUEADO |
+| Validar story | @product-lead (Axis) | BLOQUEADO |
+| Decisoes de arquitetura | @architect (Stratum) | BLOQUEADO |
+| Verdicts de qualidade | @quality-gate (Litmus) | BLOQUEADO |
+
+Violacoes de autoridade sao bloqueadas via hooks (Constitution Art. II).
+
+---
+
+_Veja tambem: [Workflows Overview](workflows-overview.md) | [Architecture Overview](../architecture-overview.md) | [Guiding Principles](../guiding-principles.md)_

package/docs/guides/{MEMORY-INTEGRATION.md → memory-integration.md}

@@ -464,8 +464,8 @@ npm test -- tests/integration/pipeline-memory-integration.test.js --coverage
 
 ## Related Documentation
 
-- **[Memory System (Current State)](MEMORY-SYSTEM.md)** - Overview of memory architecture
-- **[Memory Intelligence System (Target State)](MEMORY-INTELLIGENCE-SYSTEM.md)** - Full MIS vision
+- **[Memory System (Current State)](memory-system.md)** - Overview of memory architecture
+- **[Memory Intelligence System (Target State)](memory-intelligence-system.md)** - Full MIS vision
 - **Story MIS-3:** Session Digest (PreCompact Hook) - Memory capture
 - **Story MIS-4:** Progressive Memory Retrieval - Retrieval API
 - **Story MIS-6:** Pipeline Integration - This guide

package/docs/guides/{MEMORY-INTELLIGENCE-SYSTEM.md → memory-intelligence-system.md}

@@ -5,10 +5,10 @@
 **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)
-**Documento Atual:** [MEMORY-SYSTEM.md](MEMORY-SYSTEM.md) (estado atual v1.0)
+**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
 
-> **NOTA:** Este documento descreve o **estado futuro** do sistema de memoria apos todas as 7 stories do Epic MIS serem implementadas. Para o estado atual, consulte [MEMORY-SYSTEM.md](MEMORY-SYSTEM.md).
+> **NOTA:** Este documento descreve o **estado futuro** do sistema de memoria apos todas as 7 stories do Epic MIS serem implementadas. Para o estado atual, consulte [memory-system.md](memory-system.md).
 
 > **ARQUITETURA:** O MIS segue o modelo **Open Core** do SINAPSE. Toda a inteligencia de memoria reside no repositorio privado `sinapse-pro` (submodule `pro/`). O `sinapse-ai` (open source) fornece apenas extension points e funciona 100% sem memoria inteligente — exatamente como hoje.
 
@@ -1058,7 +1058,7 @@ gantt
 
 | Recurso | Caminho |
 |---------|---------|
-| Estado Atual (v1.0) | [MEMORY-SYSTEM.md](MEMORY-SYSTEM.md) |
+| 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) |