sinapse-ai 1.24.0 → 1.25.1

package/docs/framework/react-bits/text-animations.md

@@ -0,0 +1,41 @@
+# React Bits - TextAnimations
+
+> Snapshot oficial: `3acbd54115330a42e39f63dda2d4859e998b6684` (2026-07-14T17:21:39+03:00). Total nesta categoria: **23**.
+
+Cada item abaixo aponta para a documentacao e para o codigo TypeScript/CSS oficial fixado no commit pesquisado.
+
+| Componente                                                                                                                                                                                                                     | O que faz                                                                       | Dependencias                      | Props publicas                                                                                                                                                                                                                                                                                                            | Variantes                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
+| [ASCIIText](https://reactbits.dev/text-animations/ascii-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ASCIIText))                         | Renders text with an animated ASCII background for a retro feel.                | `three@^0.180.0`                  | `text`, `enableWaves`, `asciiFontSize`, `textFontSize`, `planeBaseHeight`, `textColor`, `strokeColor`                                                                                                                                                                                                                     | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [BlurText](https://reactbits.dev/text-animations/blur-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/BlurText))                            | Text starts blurred then crisply resolves for a soft-focus reveal effect.       | `motion@^12.23.12`                | `text`, `animateBy`, `direction`, `delay`, `stepDuration`, `threshold`, `rootMargin`, `onAnimationComplete`                                                                                                                                                                                                               | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [CircularText](https://reactbits.dev/text-animations/circular-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/CircularText))                | Layouts characters around a circle with optional rotation animation.            | `motion@^12.23.12`                | `text`, `spinDuration`, `onHover`, `className`                                                                                                                                                                                                                                                                            | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [CountUp](https://reactbits.dev/text-animations/count-up) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/CountUp))                               | Animated number counter supporting formatting and decimals.                     | `motion@^12.23.12`                | `to`, `from`, `direction`, `delay`, `duration`, `className`, `startWhen`, `separator`, `onStart`, `onEnd`                                                                                                                                                                                                                 | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [CurvedLoop](https://reactbits.dev/text-animations/curved-loop) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/CurvedLoop))                      | Flowing looping text path along a customizable curve with drag interaction.     | `none`                            | `marqueeText`, `speed`, `className`, `curveAmount`, `direction`, `interactive`                                                                                                                                                                                                                                            | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [DecryptedText](https://reactbits.dev/text-animations/decrypted-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/DecryptedText))             | Hacker-style decryption cycling random glyphs until resolving to real text.     | `motion@^12.23.12`                | `text`, `speed`, `maxIterations`, `sequential`, `revealDirection`, `useOriginalCharsOnly`, `className`, `parentClassName`, `encryptedClassName`, `animateOn`, `clickMode`                                                                                                                                                 | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [FallingText](https://reactbits.dev/text-animations/falling-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/FallingText))                   | Characters fall with gravity + bounce creating a playful entrance.              | `matter-js@^0.20.0`               | `text`, `highlightWords`, `highlightClass`, `trigger`, `backgroundColor`, `wireframes`, `gravity`, `mouseConstraintStiffness`, `fontSize`, `wordSpacing`                                                                                                                                                                  | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [FuzzyText](https://reactbits.dev/text-animations/fuzzy-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/FuzzyText))                         | Vibrating fuzzy text with controllable hover intensity.                         | `none`                            | `children`, `fontSize`, `fontWeight`, `fontFamily`, `color`, `enableHover`, `baseIntensity`, `hoverIntensity`, `fuzzRange`, `fps`, `direction`, `transitionDuration`, `clickEffect`, `glitchMode`, `glitchInterval`, `glitchDuration`, `gradient`, `letterSpacing`, `className`                                           | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [GlitchText](https://reactbits.dev/text-animations/glitch-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/GlitchText))                      | RGB split and distortion glitch effect with jitter effects.                     | `none`                            | `children`, `speed`, `enableShadows`, `enableOnHover`, `className`                                                                                                                                                                                                                                                        | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [GradientText](https://reactbits.dev/text-animations/gradient-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/GradientText))                | Animated gradient sweep across live text with speed and color control.          | `motion@^12.23.12`                | `children`, `className`, `colors`, `animationSpeed`, `direction`, `pauseOnHover`, `yoyo`, `showBorder`                                                                                                                                                                                                                    | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [RotatingText](https://reactbits.dev/text-animations/rotating-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/RotatingText))                | Cycles through multiple phrases with 3D rotate / flip transitions.              | `motion@^12.23.12`                | `texts`, `rotationInterval`, `initial`, `animate`, `exit`, `animatePresenceMode`, `animatePresenceInitial`, `staggerDuration`, `staggerFrom`, `transition`, `loop`, `auto`, `splitBy`, `onNext`, `mainClassName`, `splitLevelClassName`, `elementLevelClassName`                                                          | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ScrambledText](https://reactbits.dev/text-animations/scrambled-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ScrambledText))             | Detects cursor position and applies a distortion effect to text.                | `gsap@^3.13.0`                    | `radius`, `duration`, `speed`, `scrambleChars`, `children`, `className`, `style`                                                                                                                                                                                                                                          | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ScrollFloat](https://reactbits.dev/text-animations/scroll-float) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ScrollFloat))                   | Text gently floats / parallax shifts on scroll.                                 | `gsap@^3.13.0`                    | `children`, `scrollContainerRef`, `containerClassName`, `textClassName`, `animationDuration`, `ease`, `scrollStart`, `scrollEnd`, `stagger`                                                                                                                                                                               | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ScrollReveal](https://reactbits.dev/text-animations/scroll-reveal) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ScrollReveal))                | Text gently unblurs and reveals on scroll.                                      | `gsap@^3.13.0`                    | `children`, `scrollContainerRef`, `enableBlur`, `baseOpacity`, `baseRotation`, `blurStrength`, `containerClassName`, `textClassName`, `rotationEnd`, `wordAnimationEnd`                                                                                                                                                   | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ScrollVelocity](https://reactbits.dev/text-animations/scroll-velocity) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ScrollVelocity))          | Text marquee animatio - speed and distortion scale with user's scroll velocity. | `motion@^12.23.12`                | `scrollContainerRef`, `texts`, `velocity`, `className`, `damping`, `stiffness`, `numCopies`, `velocityMapping`, `parallaxClassName`, `scrollerClassName`, `parallaxStyle`, `scrollerStyle`                                                                                                                                | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ShinyText](https://reactbits.dev/text-animations/shiny-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ShinyText))                         | Metallic sheen sweeps across text producing a reflective highlight.             | `motion@^12.23.12`                | `text`, `color`, `shineColor`, `speed`, `delay`, `spread`, `yoyo`, `pauseOnHover`, `direction`, `disabled`, `className`                                                                                                                                                                                                   | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [Shuffle](https://reactbits.dev/text-animations/shuffle) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/Shuffle))                                | Animated text reveal where characters shuffle before settling.                  | `gsap@^3.13.0 @gsap/react@^2.1.2` | `text`, `className`, `style`, `shuffleDirection`, `duration`, `maxDelay`, `ease`, `threshold`, `rootMargin`, `tag`, `textAlign`, `onShuffleComplete`, `shuffleTimes`, `animationMode`, `loop`, `loopDelay`, `stagger`, `scrambleCharset`, `colorFrom`, `colorTo`, `triggerOnce`, `respectReducedMotion`, `triggerOnHover` | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [SplitText](https://reactbits.dev/text-animations/split-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/SplitText))                         | Splits text into characters / words for staggered entrance animation.           | `gsap@^3.13.0 @gsap/react@^2.1.2` | `tag`, `text`, `className`, `delay`, `duration`, `ease`, `splitType`, `from`, `to`, `threshold`, `rootMargin`, `textAlign`, `onLetterAnimationComplete`                                                                                                                                                                   | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [TextCursor](https://reactbits.dev/text-animations/text-cursor) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/TextCursor))                      | Make any text element follow your cursor, leaving a trail of copies behind it.  | `motion@^12.23.12`                | `text`, `spacing`, `followMouseDirection`, `randomFloat`, `exitDuration`, `removalInterval`, `maxPoints`                                                                                                                                                                                                                  | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [TextPressure](https://reactbits.dev/text-animations/text-pressure) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/TextPressure))                | Characters scale / warp interactively based on pointer pressure zone.           | `none`                            | `text`, `fontFamily`, `fontUrl`, `flex`, `scale`, `alpha`, `stroke`, `width`, `weight`, `italic`, `textColor`, `strokeColor`, `className`, `minFontSize`                                                                                                                                                                  | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [TextType](https://reactbits.dev/text-animations/text-type) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/TextType))                            | Typewriter effect with blinking cursor and adjustable typing cadence.           | `gsap@^3.13.0`                    | `text`, `as`, `typingSpeed`, `initialDelay`, `pauseDuration`, `deletingSpeed`, `loop`, `className`, `showCursor`, `hideCursorWhileTyping`, `cursorCharacter`, `cursorBlinkDuration`, `cursorClassName`, `textColors`, `variableSpeed`, `onSentenceComplete`, `startOnVisible`, `reverseMode`                              | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [TrueFocus](https://reactbits.dev/text-animations/true-focus) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/TrueFocus))                         | Applies dynamic blur / clarity based over a series of words in order.           | `motion@^12.23.12`                | `sentence`, `separator`, `manualMode`, `blurAmount`, `borderColor`, `glowColor`, `animationDuration`, `pauseBetweenAnimations`                                                                                                                                                                                            | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [VariableProximity](https://reactbits.dev/text-animations/variable-proximity) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/VariableProximity)) | Letter styling changes continuously with pointer distance mapping.              | `motion@^12.23.12`                | `label`, `fromFontVariationSettings`, `toFontVariationSettings`, `containerRef`, `radius`, `falloff`                                                                                                                                                                                                                      | JS-CSS, JS-TW, TS-CSS, TS-TW |
+
+## Comandos por componente
+
+Substituir `<Component>` pelo nome exato da primeira coluna:
+
+```bash
+npx shadcn@latest add @react-bits/<Component>-TS-TW
+npx shadcn@latest add https://reactbits.dev/r/<Component>-TS-TW
+npx jsrepo@latest add https://reactbits.dev/r/<Component>-TS-TW
+```

package/docs/framework/software-engineering-applicability.md

@@ -0,0 +1,31 @@
+# Software Engineering Applicability
+
+SINAPSE does not execute all 275 documented engineering workflows for every
+change. It selects an applicable subset from project type, affected surfaces,
+change kind, data classes, deployment target, reversibility and risk.
+
+The Phase 0/1 contract is implemented in
+`packages/engineering-applicability/index.js`. It is deterministic,
+provider-neutral and advisory. Claude Code and Codex receive the exact same
+canonical decision; their adapters may change presentation only.
+
+## Mandatory baseline
+
+Until the protected workflow templates are evolved through framework
+governance, agents must apply these minimum obligations even where a legacy YAML
+marks a review optional:
+
+- every implementation requires a Ready story/spec, traceability and QA;
+- brownfield changes require characterization tests and an incremental change
+  strategy before implementation;
+- frontend work requires design-system grounding and visual validation at
+  desktop and mobile sizes;
+- exposed frontend/API work requires application-security review;
+- database changes require schema, migration, rollback and access-control review;
+- high security, privacy or availability risk adds the respective specialist
+  review;
+- irreversible actions require an explicit human checkpoint;
+- push, PR, release and deploy remain exclusive to DevOps authority.
+
+The advisory engine does not itself block, execute, verify evidence or waive a
+gate. Those capabilities require later stories in the applicability epic.

package/docs/getting-started.md

@@ -11,7 +11,7 @@
 ## Instalação em 1 comando
 
 ```bash
-npx sinapse-ai install
+npx sinapse-ai@latest install
 ```
 
 O wizard detecta seu ambiente, escolhe IDE (Claude Code ou Codex), instala os 17 squads e configura os hooks essenciais automaticamente.
@@ -48,8 +48,12 @@ No prompt do Claude Code ou Codex:
 
 ## Reinstalar / atualizar
 
+Use sempre `@latest` para evitar uma versao antiga mantida no cache do `npx`.
+Em instalacoes globais, execute `npm install -g sinapse-ai@latest` antes de
+`sinapse-ai update`.
+
 ```bash
-npx sinapse-ai install --reconfigure   # reconfigura tudo
+npx sinapse-ai@latest install --reconfigure   # reconfigura tudo
 npx sinapse-ai update                  # atualiza versão sem perder customizações
 npx sinapse-ai uninstall               # remove tudo
 ```

package/docs/guides/codex-config.md

@@ -48,7 +48,7 @@ npm test
 - Validar command/task registry do Codex: `npm run validate:codex-commands`
 - Validar matriz de delegacao do Codex: `npm run validate:codex-delegation`
 - Gerar skills locais do Codex: `npm run sync:skills:codex`
-- Este repositorio usa **local-first**: prefira `.codex/skills` versionado no projeto
+- Este repositorio usa **local-first**: `.agents/skills` e a unica raiz de skills SINAPSE versionada no projeto
 - Use `sync:skills:codex:global` apenas para testes fora deste repo
 
 ## Command Resolution (Codex)
@@ -77,7 +77,7 @@ No Codex, nao trate handoffs exploratorios como se fossem caminhos garantidos pe
 ## Agent Shortcuts (Codex)
 
 Preferencia de ativacao no Codex CLI:
-1. Use `/skills` e selecione `sinapse-<agent-id>` vindo de `.codex/skills` (ex.: `sinapse-architect`)
+1. Use `/skills` e selecione `sinapse-<agent-id>` vindo de `.agents/skills` (ex.: `sinapse-architect`)
 2. Se preferir, use os atalhos abaixo (`@architect`, `/architect`, etc.)
 
 Quando a mensagem do usuario for um atalho de agente, carregue o arquivo correspondente em `.sinapse-ai/development/agents/` (fallback: `.codex/agents/`), renderize o greeting via `generate-greeting.js` e assuma a persona ate receber `*exit`.

package/docs/guides/development-setup.md

@@ -225,7 +225,7 @@ sinapse-ai/
 │       └── checklists/            # Product checklists
 │
 ├── .claude/                       # Claude Code configuration
-│   ├── commands/SINAPSE/agents/      # Agent skill commands
+│   ├── agents/                       # Native Claude agents
 │   ├── hooks/                     # Governance hooks
 │   └── rules/                     # AI behavior rules
 │
@@ -1112,4 +1112,3 @@ node --inspect node_modules/.bin/jest
 
 _SINAPSE Development Setup Guide v1.0.0_
 _Last Updated: 2026-01-29_
-

package/docs/guides/ide-integration.md

@@ -64,7 +64,7 @@ If your goal is to get started as fast as possible:
 
 ```yaml
 config_file: .claude/CLAUDE.md
-agent_folder: .claude/commands/SINAPSE/agents
+agent_folder: .claude/agents
 activation: /agent-name (slash commands)
 format: full-markdown-yaml
 mcp_support: native
@@ -89,7 +89,7 @@ special_features:
 npm run sync:ide
 
 # Verify setup
-ls -la .claude/commands/SINAPSE/agents/
+ls -la .claude/agents/
 ```
 
 ---
@@ -102,7 +102,7 @@ ls -la .claude/commands/SINAPSE/agents/
 config_file: AGENTS.md
 agent_folder: .codex/agents
 activation: terminal instructions
-skills_folder: .codex/skills (source), ~/.codex/skills (Codex menu)
+skills_folder: .agents/skills (single native source)
 format: markdown
 mcp_support: native via Codex tooling
 special_features:
@@ -117,7 +117,7 @@ special_features:
 
 1. Keep `AGENTS.md` at repository root
 2. Run `npm run sync:ide:codex` to sync auxiliary agent files
-3. Run `npm run sync:skills:codex` to generate project-local skills in `.codex/skills`
+3. Run `npm run sync:skills:codex` to generate project-local skills in `.agents/skills`
 4. Use `/skills` and choose `sinapse-architect`, `sinapse-dev`, etc.
 5. Use `npm run sync:skills:codex:global` only when you explicitly want global installation
 
@@ -132,7 +132,7 @@ npm run validate:codex-integration
 npm run validate:codex-skills
 
 # Verify setup
-ls -la AGENTS.md .codex/agents/ .codex/skills/
+ls -la AGENTS.md .codex/agents/ .agents/skills/
 ```
 
 ---
@@ -194,7 +194,7 @@ npm run sync:ide
 npm run sync:ide:check
 
 # Check platform-specific directory
-ls .claude/commands/SINAPSE/agents/       # Claude Code
+ls .claude/agents/       # Claude Code
 ```
 
 ### Sync Conflicts

package/docs/guides/quality-gates.md

@@ -162,7 +162,7 @@ layer2:
   quinn:
     enabled: true
     autoReview: true
-    agentPath: '.claude/commands/SINAPSE/agents/quality-gate.md'
+    agentPath: '.claude/agents/quality-gate.md'
     severity:
       block: ['CRITICAL']
       warn: ['HIGH', 'MEDIUM']
@@ -528,7 +528,7 @@ layer2:
   quinn:
     enabled: true
     autoReview: true
-    agentPath: '.claude/commands/SINAPSE/agents/quality-gate.md'
+    agentPath: '.claude/agents/quality-gate.md'
     severity:
       block: [CRITICAL]
       warn: [HIGH, MEDIUM]

package/docs/ide-integration.md

@@ -5,7 +5,7 @@
 | IDE | Status | Instructions File | Delegation | Skills |
 |-----|--------|------------------|------------|--------|
 | Claude Code | Works | `.claude/CLAUDE.md` | `.claude/rules/mandatory-delegation.md` | `.claude/commands/` |
-| Codex CLI | Limited | `.codex/instructions.md` | `.codex/delegation-matrix.json` | `.codex/skills/` |
+| Codex CLI | Native | `AGENTS.md` | `.codex/delegation-matrix.json` | `.agents/skills/` |
 
 ## Parity Requirements
 
@@ -19,7 +19,7 @@
 - instructions.md with agent activation rules
 - Delegation matrix in `.codex/delegation-matrix.json`
 - Delegation parity in `.codex/delegation-parity.json`
-- Skills in `.codex/skills/`
+- Skills in `.agents/skills/`
 - Agents in `.codex/agents/`
 
 ## Cross-IDE Contracts

package/docs/installation/README.md

@@ -38,13 +38,13 @@ This directory contains comprehensive installation and setup documentation for S
 ### New Installation
 
 ```bash
-npx sinapse-ai install
+npx sinapse-ai@latest install
 ```
 
 ### Upgrading
 
 ```bash
-npx sinapse-ai install --force-upgrade
+npx sinapse-ai@latest update
 ```
 
 ### Having Issues?

package/docs/installation/faq.md

@@ -117,7 +117,7 @@ your-project/
 │   └── core-config.yaml        # Framework configuration
 │
 ├── .claude/                    # Claude Code (if selected)
-│   └── commands/SINAPSE/agents/   # Agent slash commands
+│   └── agents/                    # Native Claude agents
 │
 ├── docs/                       # Documentation structure
 │   ├── stories/                # Development stories

package/docs/installation/troubleshooting.md

@@ -548,7 +548,7 @@ nvm use 16
 
    ```bash
    # Claude Code
-   ls .claude/commands/SINAPSE/agents/
+   ls .claude/agents/
    ```
 
 3. Check IDE settings allow custom commands
@@ -566,7 +566,7 @@ nvm use 16
 **Solution:**
 
 1. Check IDE version is compatible
-2. For Claude Code: Files should be in `.claude/commands/`
+2. For Claude Code: Native agent files should be in `.claude/agents/`; `.claude/commands/` is only for slash commands
 3. Restart IDE after installation
 
 ---

package/docs/installation/v4-quick-start.md

@@ -198,7 +198,7 @@ your-project/
 │       ├── integrations/          # PM tool adapters
 │       └── templates/             # Config templates
 ├── .claude/                       # Claude Code configuration
-│   ├── commands/SINAPSE/agents/      # Agent skills
+│   ├── agents/                       # Native Claude agents
 │   └── rules/                     # Agent rules
 ├── docs/                          # Documentation
 │   └── stories/                   # Development stories

package/docs/pt/contributing.md

@@ -149,7 +149,7 @@ Agents sao personas de IA com expertise e comandos especificos.
 > **Cross-IDE parity (Story 10.18)**
 >
 > O diretorio `.sinapse-ai/development/agents/` e a fonte unica de verdade.
-> Ele se espelha automaticamente para `.claude/commands/SINAPSE/agents/` e
+> Ele se espelha automaticamente para `.claude/agents/` e
 > `.codex/agents/` via `npm run sync:ide`. O hook `lint-staged` ja roda o
 > sync quando voce comita um arquivo de agent, mas se voce editar um agent
 > e empurrar sem deixar o lint-staged rodar, o hook `pre-push` BLOQUEIA o

package/docs/pt/guides/development-setup.md

@@ -225,7 +225,7 @@ sinapse-ai/
 │       └── checklists/            # Checklists de produto
 │
 ├── .claude/                       # Configuração do Claude Code
-│   ├── commands/SINAPSE/agents/      # Comandos de skill dos agentes
+│   ├── agents/                       # Agentes nativos do Claude
 │   ├── hooks/                     # Hooks de governança
 │   └── rules/                     # Regras de comportamento da IA
 │
@@ -1112,4 +1112,3 @@ node --inspect node_modules/.bin/jest
 
 _SINAPSE Development Setup Guide v1.0.0_
 _Última Atualização: 2026-01-29_
-

package/docs/pt/guides/quality-gates.md

@@ -168,7 +168,7 @@ layer2:
   quinn:
     enabled: true
     autoReview: true
-    agentPath: '.claude/commands/SINAPSE/agents/quality-gate.md'
+    agentPath: '.claude/agents/quality-gate.md'
     severity:
       block: ['CRITICAL']
       warn: ['HIGH', 'MEDIUM']
@@ -534,7 +534,7 @@ layer2:
   quinn:
     enabled: true
     autoReview: true
-    agentPath: '.claude/commands/SINAPSE/agents/quality-gate.md'
+    agentPath: '.claude/agents/quality-gate.md'
     severity:
       block: [CRITICAL]
       warn: [HIGH, MEDIUM]

package/docs/pt/ide-integration.md

@@ -61,7 +61,7 @@ O SINAPSE suporta 5 plataformas de desenvolvimento com IA. Escolha a que melhor
 
 ```yaml
 config_file: .claude/CLAUDE.md
-agent_folder: .claude/commands/SINAPSE/agents
+agent_folder: .claude/agents
 activation: /agent-name (slash commands)
 format: full-markdown-yaml
 mcp_support: native
@@ -86,7 +86,7 @@ special_features:
 npm run sync:ide
 
 # Verificar configuração
-ls -la .claude/commands/SINAPSE/agents/
+ls -la .claude/agents/
 ```
 
 ---
@@ -99,7 +99,7 @@ ls -la .claude/commands/SINAPSE/agents/
 config_file: AGENTS.md
 agent_folder: .codex/agents
 activation: /skills + atalhos AGENTS.md
-skills_folder: .codex/skills (local), ~/.codex/skills (global)
+skills_folder: .agents/skills (fonte nativa unica)
 format: markdown
 mcp_support: nativo via Codex
 special_features:
@@ -120,7 +120,7 @@ special_features:
 ```bash
 npm run sync:ide:codex
 npm run sync:skills:codex
-ls -la AGENTS.md .codex/agents/ .codex/skills/
+ls -la AGENTS.md .codex/agents/ .agents/skills/
 ```
 
 ---
@@ -298,7 +298,7 @@ npm run sync:ide:check
 
 # Verificar diretório específico da plataforma
 ls .cursor/rules/  # Para Cursor
-ls .claude/commands/SINAPSE/agents/  # Para Claude Code
+ls .claude/agents/  # Para Claude Code
 ```
 
 ### Conflitos de Sincronização
@@ -367,7 +367,7 @@ cp -r .cursor/rules/ ./rules-backup/
 npm run sync:ide
 
 # Verificar migração
-diff -r ./rules-backup/ .claude/commands/SINAPSE/agents/
+diff -r ./rules-backup/ .claude/agents/
 ```
 
 ### De Claude Code para Cursor

package/docs/pt/installation/faq.md

@@ -125,7 +125,7 @@ your-project/
 │   └── core-config.yaml        # Configuração do framework
 │
 ├── .claude/                    # Claude Code (se selecionado)
-│   └── commands/SINAPSE/agents/   # Comandos slash de agentes
+│   └── agents/                    # Agentes nativos do Claude
 │
 ├── .cursor/                    # Cursor (se selecionado)
 │   └── rules/                  # Regras de agentes

package/docs/pt/installation/troubleshooting.md

@@ -554,7 +554,7 @@ nvm use 16
 
    ```bash
    # Claude Code
-   ls .claude/commands/SINAPSE/agents/
+   ls .claude/agents/
 
    # Cursor
    ls .cursor/rules/
@@ -576,7 +576,7 @@ nvm use 16
 
 1. Verifique se a versão da IDE é compatível
 2. Para Cursor: Certifique-se que os arquivos têm extensão `.mdc`
-3. Para Claude Code: Arquivos devem estar em `.claude/commands/`
+3. Para Claude Code: Agentes nativos devem estar em `.claude/agents/`; `.claude/commands/` serve apenas para slash commands
 4. Reinicie a IDE após a instalação
 
 ---
@@ -733,4 +733,3 @@ ls -la .sinapse-ai/
 ## Documentação Relacionada
 
 - [FAQ](./faq.md)
-

package/docs/pt/installation/v4-quick-start.md

@@ -200,7 +200,7 @@ seu-projeto/
 │       ├── integrations/          # Adaptadores de PM tools
 │       └── templates/             # Templates de configuração
 ├── .claude/                       # Configuração Claude Code
-│   ├── commands/SINAPSE/agents/      # Skills de agentes
+│   ├── agents/                       # Agentes nativos do Claude
 │   └── rules/                     # Regras de agentes
 ├── docs/                          # Documentação
 │   └── stories/                   # Stories de desenvolvimento
@@ -267,4 +267,3 @@ git clone https://github.com/caioimori/sinapse-ai.git
 ---
 
 **Bem-vindo ao SINAPSE! Bom coding!**
-

package/docs/pt/platforms/claude-code.md

@@ -403,7 +403,7 @@ O Claude Code mostra status em tempo real:
 flowchart LR
     Source["SINAPSE Core<br/>.sinapse-ai/development/agents"] --> Parser["Parser de Agente"]
     Parser --> Transform["Transformador Claude"]
-    Transform --> Output[".claude/commands/SINAPSE/agents"]
+    Transform --> Output[".claude/agents"]
 ```
 
 ### Comandos de Sincronização
@@ -450,7 +450,7 @@ activation: /dev
 
 Quando conflitos ocorrem:
 
-1. Alterações locais são salvas em `.claude/commands/SINAPSE/agents/.backup/`
+1. Alterações locais são salvas em `.claude/agents/.backup/`
 2. Sync solicita resolução
 3. Escolha: manter local, usar remoto ou mesclar
 
@@ -524,7 +524,7 @@ Error: Unknown command '/xyz'
 npm run sync:ide
 
 # Verificar se o agente existe
-ls .claude/commands/SINAPSE/agents/
+ls .claude/agents/
 ```
 
 #### Permissão de Ferramenta Negada
@@ -588,7 +588,7 @@ R: Simplesmente use o comando slash para o agente desejado: `/dev`, `/qa`, etc.
 R: Sim, através do Task tool que pode criar subagentes.
 
 **P: Onde as definições de agentes são armazenadas?**
-R: Em `.claude/commands/SINAPSE/agents/` após a sincronização.
+R: Em `.claude/agents/` após a sincronização.
 
 **P: Com que frequência devo sincronizar agentes?**
 R: Após atualizar o SINAPSE ou quando agentes são modificados no core.

package/docs/sinapse-agent-flows/analyst-system.md

@@ -56,7 +56,7 @@ O agente Analyst e projetado para:
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/analyst.md` | Definição core do agente Analyst |
-| `.claude/commands/SINAPSE/agents/analyst.md` | Comando Claude Code para ativar @analyst |
+| `.claude/agents/analyst.md` | Comando Claude Code para ativar @analyst |
 
 ### Tasks do Analyst
 

package/docs/sinapse-agent-flows/architect-system.md

@@ -56,7 +56,7 @@ O agente **@architect** (Aria) e o **Holistic System Architect & Full-Stack Tech
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/architect.md` | Definição core do agente Architect |
-| `.claude/commands/SINAPSE/agents/architect.md` | Comando Claude Code para ativar @architect |
+| `.claude/agents/architect.md` | Comando Claude Code para ativar @architect |
 
 ### Arquivos de Templates do @architect
 

package/docs/sinapse-agent-flows/data-engineer-system.md

@@ -89,7 +89,7 @@ O agente **@data-engineer (Dara)** e o Database Architect & Operations Engineer
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/data-engineer.md` | Definição core do agente @data-engineer (persona, comandos, workflows) |
-| `.claude/commands/SINAPSE/agents/data-engineer.md` | Comando Claude Code para ativar @data-engineer |
+| `.claude/agents/data-engineer.md` | Comando Claude Code para ativar @data-engineer |
 
 ### Arquivos de Templates SQL
 

package/docs/sinapse-agent-flows/dev-system.md

@@ -55,7 +55,7 @@ O agente **@developer (Dex)** e o Full Stack Developer do SINAPSE, responsavel p
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/developer.md` | Definição core do agente @developer (persona, comandos, workflows) |
-| `.claude/commands/SINAPSE/agents/developer.md` | Comando Claude Code para ativar @developer |
+| `.claude/agents/developer.md` | Comando Claude Code para ativar @developer |
 
 ### Arquivos de Checklists Usados pelo @dev
 

package/docs/sinapse-agent-flows/pm-system.md

@@ -41,7 +41,7 @@ O agente PM e projetado para:
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/project-lead.md` | Definição core do agente PM |
-| `.claude/commands/SINAPSE/agents/project-lead.md` | Comando Claude Code para ativar @project-lead |
+| `.claude/agents/project-lead.md` | Comando Claude Code para ativar @project-lead |
 
 ### Tasks do @pm
 

package/docs/sinapse-agent-flows/qa-system.md

@@ -64,7 +64,7 @@ O agente **@quality-gate (Quinn)** e o Test Architect & Quality Advisor do SINAP
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/quality-gate.md` | Definição completa do agente QA |
-| `.claude/commands/SINAPSE/agents/quality-gate.md` | Comando Claude Code para ativar @quality-gate |
+| `.claude/agents/quality-gate.md` | Comando Claude Code para ativar @quality-gate |
 
 ### Arquivos de Workflow
 

package/docs/sinapse-agent-flows/sm-system.md

@@ -43,7 +43,7 @@ O agente **@sprint-lead (River)** e o Scrum Master tecnico do SINAPSE, especiali
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/sprint-lead.md` | Definição core do agente SM |
-| `.claude/commands/SINAPSE/agents/sprint-lead.md` | Comando Claude Code para ativar @sprint-lead |
+| `.claude/agents/sprint-lead.md` | Comando Claude Code para ativar @sprint-lead |
 | `.cursor/rules/sm.md` | Regras para Cursor IDE |
 | `.cursor/rules/sm.mdc` | Regras compiladas para Cursor |
 

package/docs/sinapse-agent-flows/snps-orqx-system.md

@@ -60,7 +60,7 @@ O **@sinapse-orqx** (Orion - The Orchestrator) e o meta-agente principal do fram
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/sinapse-orqx.md` | Definição completa do agente (persona, comandos, dependencias) |
-| `.claude/commands/SINAPSE/agents/sinapse-orqx.md` | Comando Claude Code para ativar @sinapse-orqx |
+| `.claude/agents/sinapse-orqx.md` | Comando Claude Code para ativar @sinapse-orqx |
 
 ### Arquivos de Templates do @sinapse-orqx
 

package/docs/sinapse-agent-flows/squad-creator-system.md

@@ -39,7 +39,7 @@ Este sistema implementa a **arquitetura task-first** do SINAPSE, onde tasks sao
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/squad-creator.md` | Definição core do agente Squad Creator |
-| `.claude/commands/SINAPSE/agents/squad-creator.md` | Comando Claude Code para ativar @squad-creator |
+| `.claude/agents/squad-creator.md` | Comando Claude Code para ativar @squad-creator |
 
 ### Arquivos de Tasks do @squad-creator
 
@@ -668,7 +668,7 @@ flowchart LR
 - [Script: squad-validator.js](../../.sinapse-ai/development/scripts/squad/squad-validator.js)
 - [Schema: squad-schema.json](../../.sinapse-ai/schemas/squad-schema.json)
 - [Agent: squad-creator.md](../../.sinapse-ai/development/agents/squad-creator.md)
-- [Command: squad-creator.md](../../.claude/commands/SINAPSE/agents/squad-creator.md)
+- [Command: squad-creator.md](../../.claude/agents/squad-creator.md)
 
 ---
 

package/docs/sinapse-agent-flows/ux-design-expert-system.md

@@ -88,7 +88,7 @@ flowchart TB
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/ux-design-expert.md` | Definição completa do agente (persona, comandos, workflows) |
-| `.claude/commands/SINAPSE/agents/ux-design-expert.md` | Comando Claude Code para ativar @ux-design-expert |
+| `.claude/agents/ux-design-expert.md` | Comando Claude Code para ativar @ux-design-expert |
 
 ### Tasks por Fase