sinapse-ai 1.16.0 → 1.19.0

package/docs/framework/coding-standards.md

@@ -1,6 +1,6 @@
 # SINAPSE Coding Standards
 
-> 🌐 **EN** | [PT](../pt/framework/coding-standards.md) | [ES](../es/framework/coding-standards.md)
+> 🌐 **EN** | [PT](../pt/framework/coding-standards.md)
 
 **Version:** 1.1
 **Last Updated:** 2025-12-14

package/docs/framework/core-architecture.md

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

package/docs/framework/guiding-principles.md

@@ -68,7 +68,7 @@ A razao e separacao de responsabilidades em escala. Um orquestrador que "faz tud
 
 **Por que 172 agentes em 17 dominios?**
 
-O SINAPSE nao e um agente generalista. E um ecossistema de 160 especialistas organizados em 17 squads tematicos. Cada agente tem persona, expertise e comandos especificos para seu dominio.
+O SINAPSE nao e um agente generalista. E um ecossistema de 172 agentes especializados — 12 core mais 160 distribuidos em 17 squads tematicos. Cada agente tem persona, expertise e comandos especificos para seu dominio.
 
 Essa arquitetura permite:
 

package/docs/framework/source-tree.md

@@ -1,6 +1,6 @@
 # SINAPSE Source Tree Structure
 
-> 🌐 **EN** | [PT](../pt/framework/source-tree.md) | [ES](../es/framework/source-tree.md)
+> 🌐 **EN** | [PT](../pt/framework/source-tree.md)
 
 **Version:** 4.0.0
 **Last Updated:** 2026-02-11

package/docs/framework/tech-stack.md

@@ -1,6 +1,6 @@
 # SINAPSE Technology Stack
 
-> 🌐 **EN** | [PT](../pt/framework/tech-stack.md) | [ES](../es/framework/tech-stack.md)
+> 🌐 **EN** | [PT](../pt/framework/tech-stack.md)
 
 **Version:** 1.1
 **Last Updated:** 2025-12-14

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

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

package/docs/getting-started.md

@@ -14,7 +14,7 @@
 npx sinapse-ai install
 ```
 
-O wizard detecta seu ambiente, escolhe IDE (Claude Code ou Codex), instala 19 squads e configura 13 hooks ativos automaticamente.
+O wizard detecta seu ambiente, escolhe IDE (Claude Code ou Codex), instala os 17 squads e configura os hooks essenciais automaticamente.
 
 ## Validar setup
 

package/docs/guides/agent-reference.md

@@ -27,7 +27,7 @@ spawn-eligible via the `Task` tool.
 
 ## Squad orqx (21)
 
-Each of the 19 squads ships a master orchestrator (`*-orqx`) plus
+Each of the 17 squads ships a master orchestrator (`*-orqx`) plus
 inner specialists. The orqx is the entry point — invoke it first
 and it routes intra-squad. Examples:
 

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

@@ -1,6 +1,6 @@
 # Agent Selection Guide
 
-> **EN** | [PT](../pt/guides/agent-selection-guide.md) | [ES](../es/guides/agent-selection-guide.md)
+> **EN** | [PT](../pt/guides/agent-selection-guide.md)
 
 ---
 

package/docs/guides/api-reference.md

@@ -1,6 +1,6 @@
 # SINAPSE API Reference
 
-> **EN** | [PT](../pt/guides/api-reference.md) | [ES](../es/guides/api-reference.md)
+> **EN** | [PT](../pt/guides/api-reference.md)
 
 ---
 

package/docs/guides/contextual-greeting-system-guide.md

@@ -1,6 +1,6 @@
 # Guia do Sistema de Greeting Contextual
 
-> **EN** | [PT](../pt/guides/contextual-greeting-system-guide.md) | [ES](../es/guides/contextual-greeting-system-guide.md)
+> **EN** | [PT](../pt/guides/contextual-greeting-system-guide.md)
 
 ---
 

package/docs/guides/contributing-squads.md

@@ -1,6 +1,6 @@
 # Contributing Squads Guide
 
-> **EN** | [PT](../pt/guides/contributing-squads.md) | [ES](../es/guides/contributing-squads.md)
+> **EN** | [PT](../pt/guides/contributing-squads.md)
 
 ---
 

package/docs/guides/development-setup.md

@@ -1,6 +1,6 @@
 # Development Setup Guide
 
-> **EN** | [PT](../pt/guides/development-setup.md) | [ES](../es/guides/development-setup.md)
+> **EN** | [PT](../pt/guides/development-setup.md)
 
 ---
 

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

@@ -1,6 +1,6 @@
 # SINAPSE Git Workflow Guide
 
-> 🌐 **EN** | [PT](./pt/git-workflow-guide.md) | [ES](./es/git-workflow-guide.md)
+> 🌐 **EN** | [PT](./pt/git-workflow-guide.md)
 
 ---
 

package/docs/guides/installation-troubleshooting.md

@@ -1,6 +1,6 @@
 # SINAPSE Installation & Troubleshooting Guide
 
-> **EN** | [PT](../pt/guides/installation-troubleshooting.md) | [ES](../es/guides/installation-troubleshooting.md)
+> **EN** | [PT](../pt/guides/installation-troubleshooting.md)
 
 ---
 

package/docs/guides/llm-routing.md

@@ -1,6 +1,6 @@
 # LLM Routing Guide
 
-> **EN** | [PT](../pt/guides/llm-routing.md) | [ES](../es/guides/llm-routing.md)
+> **EN** | [PT](../pt/guides/llm-routing.md)
 
 ---
 

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

@@ -1,6 +1,6 @@
 # SINAPSE MCP Global Setup Guide
 
-> **EN** | [PT](../pt/guides/mcp-global-setup.md) | [ES](../es/guides/mcp-global-setup.md)
+> **EN** | [PT](../pt/guides/mcp-global-setup.md)
 
 ---
 

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

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

package/docs/guides/project-status-feature.md

@@ -1,6 +1,6 @@
 # Project Status Feature - User Guide
 
-> **EN** | [PT](../pt/guides/project-status-feature.md) | [ES](../es/guides/project-status-feature.md)
+> **EN** | [PT](../pt/guides/project-status-feature.md)
 
 ---
 

package/docs/guides/quality-dashboard.md

@@ -1,6 +1,6 @@
 # Quality Gates Dashboard Guide
 
-> **EN** | [PT](../pt/guides/quality-dashboard.md) | [ES](../es/guides/quality-dashboard.md)
+> **EN** | [PT](../pt/guides/quality-dashboard.md)
 
 ---
 

package/docs/guides/quality-gates.md

@@ -1,6 +1,6 @@
 # SINAPSE Quality Gate System Guide
 
-> **EN** | [PT](../pt/guides/quality-gates.md) | [ES](../es/guides/quality-gates.md)
+> **EN** | [PT](../pt/guides/quality-gates.md)
 
 ---
 

package/docs/guides/security-hardening.md

@@ -1,6 +1,6 @@
 # SINAPSE Security Hardening Guide
 
-> **EN** | [PT](../pt/guides/security-hardening.md) | [ES](../es/guides/security-hardening.md)
+> **EN** | [PT](../pt/guides/security-hardening.md)
 
 ---
 

package/docs/guides/service-discovery.md

@@ -1,6 +1,6 @@
 # SINAPSE Service Discovery Guide
 
-> **EN** | [PT](../pt/guides/service-discovery.md) | [ES](../es/guides/service-discovery.md)
+> **EN** | [PT](../pt/guides/service-discovery.md)
 
 ---
 
@@ -131,25 +131,25 @@ const count = await registry.count();
 
 ## CLI Commands
 
-### `sinapse discover`
+### `sinapse workers search`
 
 Search for workers in the registry.
 
 ```bash
 # Search by text
-sinapse discover "create story"
+sinapse workers search "create story"
 
-# Search by category
-sinapse discover --category task
+# Filter by category
+sinapse workers search "story" --category=task
 
-# Search by tag
-sinapse discover --tag testing
+# Filter by tags (comma-separated)
+sinapse workers search "validation" --tags=schema,json
 
-# Search for agent
-sinapse discover --agent dev
+# Limit results
+sinapse workers search "story" --limit=5
 
-# Combine filters
-sinapse discover --category task --tag development --agent dev
+# JSON output
+sinapse workers search "api" --format=json
 ```
 
 **Output:**
@@ -215,22 +215,19 @@ Performance:
   Parallelizable: No
 ```
 
-### `sinapse list`
+### Listing workers by category
 
-List workers by category or agent.
+Use `sinapse workers search` with the `--category` filter to narrow results to a worker type.
 
 ```bash
-# List all tasks
-sinapse list tasks
+# Find tasks
+sinapse workers search "story" --category=task
 
-# List all templates
-sinapse list templates
+# Find templates
+sinapse workers search "template" --category=template
 
-# List workers for agent
-sinapse list --agent dev
-
-# List with pagination
-sinapse list tasks --page 1 --limit 20
+# Limit the number of results
+sinapse workers search "story" --category=task --limit=20
 ```
 
 ---

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

@@ -1,6 +1,6 @@
 # Squad Examples
 
-> **EN** | [PT](../../pt/guides/squad-examples/README.md) | [ES](../../es/guides/squad-examples/README.md)
+> **EN** | [PT](../../pt/guides/squad-examples/README.md)
 
 ---
 

package/docs/guides/squad-migration.md

@@ -1,6 +1,6 @@
 # Squad Migration Guide
 
-> **EN** | [PT](../pt/guides/squad-migration.md) | [ES](../es/guides/squad-migration.md)
+> **EN** | [PT](../pt/guides/squad-migration.md)
 
 ---
 

package/docs/guides/squads-guide.md

@@ -1,6 +1,6 @@
 # Squad Development Guide
 
-> **EN** | [PT](../pt/guides/squads-guide.md) | [ES](../es/guides/squads-guide.md)
+> **EN** | [PT](../pt/guides/squads-guide.md)
 
 ---
 

package/docs/guides/squads-overview.md

@@ -183,19 +183,16 @@ tags:
 
 ### Installing Squads
 
-```bash
-# List available squads
-sinapse squads list
-
-# Download from official repository
-*download-squad etl-squad
+Squads live in the project's `squads/` directory. Each squad is a self-contained
+folder with its own agents, tasks, and configuration, and is picked up
+automatically by the framework — no install step is required.
 
-# Download specific version
-*download-squad etl-squad@2.0.0
+- **Add a squad** — place its folder under `squads/`.
+- **Create a squad** — use the `squad-creator` agent to scaffold a new one.
 
-# List local squads
-*list-squads
-```
+> **Roadmap:** remote squad distribution — browsing, downloading, and publishing
+> squads through a shared registry (Levels 2–3 above) — is planned but not yet
+> available. For now, squads are managed locally in `squads/`.
 
 ---
 
@@ -259,11 +256,11 @@ Use semantic versioning:
 | `*create-squad {name} --from-design`     | Create from design blueprint    |
 | `*validate-squad {name}`                 | Validate squad structure        |
 | `*list-squads`                           | List all local squads           |
-| `*download-squad {name}`                 | Download from repository        |
+| `*download-squad {name}`                 | Download from repository (roadmap) |
 | `*design-squad`                          | Design squad from documentation |
 | `*analyze-squad {name}`                  | Analyze squad structure         |
 | `*extend-squad {name}`                   | Add components to squad         |
-| `*publish-squad {path}`                  | Publish to repository           |
+| `*publish-squad {path}`                  | Publish to repository (roadmap) |
 
 ---
 

package/docs/guides/template-engine-v2.md

@@ -1,6 +1,6 @@
 # Template Engine v2.0
 
-> **EN** | [PT](../pt/guides/template-engine-v2.md) | [ES](../es/guides/template-engine-v2.md)
+> **EN** | [PT](../pt/guides/template-engine-v2.md)
 
 ---
 

package/docs/guides/testing-guide.md

@@ -1,6 +1,6 @@
 # SINAPSE Testing Guide
 
-> **EN** | [PT](../pt/guides/testing-guide.md) | [ES](../es/guides/testing-guide.md)
+> **EN** | [PT](../pt/guides/testing-guide.md)
 
 ---
 

package/docs/guides/user-guide.md

@@ -199,22 +199,29 @@ Workflows orchestrate multiple tasks and agents for complex operations.
 
 ### Available Workflows
 
-| Workflow                 | Use Case                | Agents Involved   |
-| ------------------------ | ----------------------- | ----------------- |
-| `greenfield-fullstack`   | New full-stack project  | All agents        |
-| `brownfield-integration` | Add SINAPSE to existing    | dev, architect    |
-| `fork-join`              | Parallel task execution | Multiple          |
-| `organizer-worker`       | Delegated execution     | po, dev           |
-| `data-pipeline`          | ETL workflows           | data-engineer, qa |
+| Workflow                  | Use Case                            |
+| ------------------------- | ----------------------------------- |
+| `greenfield-ui`           | New site / landing page / app       |
+| `greenfield-fullstack`    | New platform / SaaS                 |
+| `greenfield-service`      | New API / backend service           |
+| `brownfield-fullstack`    | Add SINAPSE to an existing project  |
+| `spec-pipeline`           | Complex briefing (spec first)       |
+| `story-development-cycle` | Implement a single story            |
 
-### Executing Workflows
+### Running a Workflow
+
+You don't invoke workflows by name — describe what you want and SINAPSE picks
+the right one (greenfield vs brownfield, UI vs fullstack vs service).
 
 ```bash
-# Start a workflow
-sinapse workflow greenfield-fullstack
+# Describe the project — SINAPSE classifies it and runs the right workflow
+sinapse build "new SaaS platform for gym management"
+
+# Preview which workflow a briefing would trigger (without running it)
+sinapse route "add dark mode to the platform"
 
-# With parameters
-sinapse workflow brownfield-integration --target=./existing-project
+# Run the development cycle for an existing story
+sinapse orchestrate <story-id>
 ```
 
 ---
@@ -239,25 +246,25 @@ A squad is a self-contained package containing:
 ### Distribution Levels
 
 ```
-Level 1: LOCAL        --> ./squads/           (Private)
-Level 2: SINAPSE-SQUADS  --> github.com/SinapseAI (Public/Free)
-Level 3: SINAPSE API   --> api.sinapse.ai      (Marketplace)
+Level 1: LOCAL        --> ./squads/      (today — managed in your project)
+Level 2: REGISTRY     --> remote sharing (roadmap)
+Level 3: MARKETPLACE  --> paid squads    (roadmap)
 ```
 
 ### Using Squads
 
-```bash
-# List available squads
-sinapse squads list
-
-# Download a squad
-sinapse squads download etl-squad
+Squads live in the `squads/` directory of your project. To add one, drop its
+folder there; to build a new one, scaffold it with the squad-creator agent:
 
+```bash
 # Create your own squad
 @squad-creator
 *create-squad my-custom-squad
 ```
 
+> Remote squad distribution (browse / download from a registry) is on the
+> roadmap — today squads are managed directly under `squads/`.
+
 ### Official Squads
 
 | Squad           | Description                        |
@@ -467,11 +474,8 @@ Maintain context through sessions by:
 
 ### 5. Leverage Squads
 
-Don't reinvent the wheel - check for existing squads:
-
-```bash
-sinapse squads search {keyword}
-```
+Don't reinvent the wheel — browse the squads already shipped under `squads/`
+before building a new agent from scratch.
 
 ---
 

package/docs/installation/README.md

@@ -1,6 +1,6 @@
 # SINAPSE Installation Documentation
 
-> 🌐 **EN** | [PT](../pt/installation/README.md) | [ES](../es/installation/README.md)
+> 🌐 **EN** | [PT](../pt/installation/README.md)
 
 **Version:** 2.1.0
 **Last Updated:** 2025-01-24
@@ -87,8 +87,8 @@ npx sinapse-ai install --force-upgrade
 
 - [Coding Standards](../framework/coding-standards.md)
 - [Tech Stack](../framework/tech-stack.md)
-- [Architecture](../architecture/)
-- [Changelog](../CHANGELOG.md)
+- [Architecture](../framework/core-architecture.md)
+- [Changelog](../../CHANGELOG.md)
 
 ---
 

package/docs/installation/faq.md

@@ -1,6 +1,6 @@
 # SINAPSE FAQ
 
-> 🌐 **EN** | [PT](../pt/installation/faq.md) | [ES](../es/installation/faq.md)
+> 🌐 **EN** | [PT](../pt/installation/faq.md)
 
 **Version:** 2.1.0
 **Last Updated:** 2025-01-24

package/docs/installation/linux.md

@@ -1,6 +1,6 @@
 # Linux Installation Guide for SINAPSE
 
-> 🌐 [EN](linux.md) | [PT](../pt/installation/linux.md) | [ES](../es/installation/linux.md)
+> 🌐 [EN](linux.md) | [PT](../pt/installation/linux.md)
 
 ---
 
@@ -355,7 +355,7 @@ The updater will:
 
 ## Uninstallation
 
-See the complete [Uninstallation Guide](../uninstallation.md) for detailed steps.
+See the complete [Uninstallation Guide](./uninstallation.md) for detailed steps.
 
 Quick uninstall:
 

package/docs/installation/macos.md

@@ -1,6 +1,6 @@
 # macOS Installation Guide for SINAPSE
 
-> 🌐 **EN** | [PT](../pt/installation/macos.md) | [ES](../es/installation/macos.md)
+> 🌐 **EN** | [PT](../pt/installation/macos.md)
 
 ## Prerequisites
 

package/docs/installation/npx-install.md

@@ -1,6 +1,6 @@
 # NPX Installation Guide
 
-> 🌐 **EN** | [PT](./pt/npx-install.md) | [ES](./es/npx-install.md)
+> 🌐 **EN** | [PT](./pt/npx-install.md)
 
 ---
 

package/docs/installation/troubleshooting.md

@@ -1,6 +1,6 @@
 # SINAPSE Troubleshooting Guide
 
-> 🌐 **EN** | [PT](../pt/installation/troubleshooting.md) | [ES](../es/installation/troubleshooting.md)
+> 🌐 **EN** | [PT](../pt/installation/troubleshooting.md)
 
 **Version:** 2.1.0
 **Last Updated:** 2025-01-24

package/docs/installation/uninstallation.md

@@ -1,6 +1,6 @@
 # Uninstallation Guide
 
-> 🌐 **EN** | [PT](./pt/uninstallation.md) | [ES](./es/uninstallation.md)
+> 🌐 **EN** | [PT](./pt/uninstallation.md)
 
 ---
 

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

@@ -1,6 +1,6 @@
 # SINAPSE v4 Quick Start Guide
 
-> 🌐 **EN** | [PT](../pt/installation/v4-quick-start.md) | [ES](../es/installation/v4-quick-start.md)
+> 🌐 **EN** | [PT](../pt/installation/v4-quick-start.md)
 
 **Version:** 2.1
 **Last Updated:** 2026-01-26

package/docs/installation/windows.md

@@ -1,6 +1,6 @@
 # Windows Installation Guide for SINAPSE
 
-> 🌐 [EN](windows.md) | [PT](../pt/installation/windows.md) | [ES](../es/installation/windows.md)
+> 🌐 [EN](windows.md) | [PT](../pt/installation/windows.md)
 
 ---
 
@@ -398,7 +398,7 @@ npx github:caioimori/sinapse-ai install
 
 ## Uninstallation
 
-See the complete [Uninstallation Guide](../uninstallation.md) for detailed steps.
+See the complete [Uninstallation Guide](./uninstallation.md) for detailed steps.
 
 Quick uninstall via PowerShell:
 

package/docs/pt/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 # Registro de Alteracoes
 
-> 🌐 [EN](../CHANGELOG.md) | **PT** | [ES](../es/CHANGELOG.md)
+> 🌐 [EN](../../CHANGELOG.md) | **PT**
 
 ---
 

package/docs/pt/DOCUMENTATION-ROADMAP.md

@@ -6,7 +6,7 @@
 
 # Roadmap de Documentação SINAPSE
 
-> 🌐 [EN](../DOCUMENTATION-ROADMAP.md) | **PT**
+> 🌐 **PT**
 
 ---
 

package/docs/pt/ENVIRONMENT.md

@@ -6,7 +6,7 @@
 
 # Variáveis de Ambiente
 
-> 🌐 [EN](../ENVIRONMENT.md) | **PT** | [ES](../es/ENVIRONMENT.md)
+> 🌐 **PT**
 
 ---
 

package/docs/pt/FEATURE_PROCESS.md

@@ -6,7 +6,7 @@
 
 # Processo de Solicitação de Funcionalidades
 
-> 🌐 [EN](../feature-process.md) | **PT** | [ES](../es/feature-process.md)
+> 🌐 [EN](../framework/feature-process.md) | **PT**
 
 ---
 
@@ -96,4 +96,4 @@ Pergunte no GitHub Discussions ou Discord.
 
 ---
 
-_Veja também: [Community Handbook](../../COMMUNITY.md) | [Contributing Guide](../../CONTRIBUTING.md)_
+_Veja também: Community Handbook | [Contributing Guide](../../CONTRIBUTING.md)_

package/docs/pt/GUIDING-PRINCIPLES.md

@@ -6,7 +6,7 @@
 
 # Princípios Orientadores do Método SINAPSE
 
-> 🌐 [EN](../guiding-principles.md) | **PT** | [ES](../es/guiding-principles.md)
+> 🌐 [EN](../framework/guiding-principles.md) | **PT**
 
 ---
 
@@ -75,7 +75,7 @@ Veja o [Visão Geral de Squads](../guides/squads-overview.md) para exemplos deta
 
 ### Regras de Templates
 
-Templates seguem a especificação do [SINAPSE Document Template](../../common/utils/sinapse-doc-template.md) usando formato YAML:
+Templates seguem a especificação do [SINAPSE Document Template](../../.sinapse-ai/development/templates/sinapse-doc-template.md) usando formato YAML:
 
 1. **Estrutura**: Templates são definidos em YAML com metadados claros, configuração de workflow e hierarquia de seções
 2. **Separação de Responsabilidades**: Instruções para LLMs estão em campos `instruction`, separadas do conteúdo