sinapse-ai 1.20.1 → 1.22.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/rules/coderabbit-integration.md +6 -0
- package/.claude/rules/documentation-first-reference.md +146 -0
- package/.claude/rules/documentation-first.md +27 -119
- package/.claude/rules/mandatory-delegation-reference.md +93 -0
- package/.claude/rules/mandatory-delegation.md +29 -93
- package/.claude/rules/project-intelligence-reference.md +159 -0
- package/.claude/rules/project-intelligence.md +37 -155
- package/.claude/rules/safe-collaboration-reference.md +163 -0
- package/.claude/rules/safe-collaboration.md +32 -173
- package/.sinapse-ai/core/doctor/checks/index.js +1 -1
- package/.sinapse-ai/core/execution/build-orchestrator.js +4 -3
- package/.sinapse-ai/core/execution/subagent-dispatcher.js +2 -2
- package/.sinapse-ai/core/ideation/ideation-engine.js +2 -1
- package/.sinapse-ai/core/orchestration/brownfield-progress.js +219 -0
- package/.sinapse-ai/core/orchestration/cli-commands.js +13 -0
- package/.sinapse-ai/core/orchestration/doc-first-resolver.js +96 -2
- package/.sinapse-ai/core/orchestration/executors/epic-3-executor.js +15 -2
- package/.sinapse-ai/core/orchestration/executors/epic-4-executor.js +3 -1
- package/.sinapse-ai/core/orchestration/greenfield-handler.js +97 -0
- package/.sinapse-ai/core/orchestration/index.js +5 -0
- package/.sinapse-ai/core/orchestration/spec-complexity.js +141 -0
- package/.sinapse-ai/core/orchestration/workflow-executor.js +17 -1
- package/.sinapse-ai/core-config.yaml +30 -0
- package/.sinapse-ai/data/entity-registry.yaml +81 -35
- package/.sinapse-ai/development/agents/architect.md +3 -15
- package/.sinapse-ai/development/agents/data-engineer.md +3 -15
- package/.sinapse-ai/development/agents/developer.md +3 -24
- package/.sinapse-ai/development/agents/devops.md +4 -25
- package/.sinapse-ai/development/agents/quality-gate.md +3 -25
- package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +1 -1
- package/.sinapse-ai/development/tasks/execute-epic-plan.md +3 -0
- package/.sinapse-ai/development/tasks/resolve-github-issue.md +1 -1
- package/.sinapse-ai/development/workflows/brownfield-discovery.yaml +16 -0
- package/.sinapse-ai/development/workflows/epic-orchestration.yaml +11 -0
- package/.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO-V2.1-COMPLETE.md +6 -2
- package/.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO-V2.2-SUMMARY.md +4 -1
- package/.sinapse-ai/install-manifest.yaml +58 -50
- package/.sinapse-ai/product/templates/story-tmpl.yaml +11 -6
- package/.sinapse-ai/quality/judge-calibration/README.md +75 -0
- package/.sinapse-ai/quality/judge-calibration/calibration-log.md +70 -0
- package/.sinapse-ai/quality/judge-calibration/golden-set.json +105 -0
- package/.sinapse-ai/quality/judge-calibration/scenarios.json +90 -0
- package/CHANGELOG.md +55 -10
- package/README.en.md +1 -1
- package/README.md +6 -6
- package/bin/sinapse-minimal.js +5 -4
- package/docs/community/README-community-snippet-core.md +1 -1
- package/docs/community/README-community-snippet-mcp.md +2 -2
- package/docs/framework/README.md +2 -2
- package/docs/framework/architecture-overview.md +2 -2
- package/docs/framework/core-architecture.md +1 -1
- package/docs/framework/feature-process.md +5 -5
- package/docs/framework/guiding-principles.md +1 -1
- package/docs/framework/roadmap.md +4 -4
- package/docs/framework/source-tree.md +1 -1
- package/docs/framework/versioning-and-releases.md +1 -1
- package/docs/getting-started.md +1 -1
- package/docs/guides/agent-selection-guide.md +1 -1
- package/docs/guides/agents/traces/README.md +1 -1
- package/docs/guides/config-migration-guide.md +1 -1
- package/docs/guides/development-setup.md +1 -1
- package/docs/guides/docker-mcp-setup.md +5 -5
- package/docs/guides/getting-started.md +1 -1
- package/docs/guides/git-workflow-guide.md +3 -3
- package/docs/guides/ide-integration.md +3 -3
- package/docs/guides/ide-sync-guide.md +1 -1
- package/docs/guides/mcp/desktop-commander.md +2 -2
- package/docs/guides/mcp/docker-gateway-tutorial.md +1 -1
- package/docs/guides/mcp-global-setup.md +3 -3
- package/docs/guides/memory-intelligence-system.md +10 -10
- package/docs/guides/meta-agent-commands.md +1 -1
- package/docs/guides/quality-gates.md +1 -1
- package/docs/guides/security-hardening.md +1 -1
- package/docs/guides/service-discovery.md +1 -1
- package/docs/guides/squad-examples/README.md +1 -1
- package/docs/guides/squads-guide.md +1 -1
- package/docs/guides/testing-guide.md +2 -2
- package/docs/guides/user-guide.md +22 -22
- package/docs/guides/workflows/BROWNFIELD-DISCOVERY-WORKFLOW.md +3 -3
- package/docs/guides/workflows/BROWNFIELD-SERVICE-WORKFLOW.md +1 -1
- package/docs/guides/workflows/GREENFIELD-UI-WORKFLOW.md +2 -2
- package/docs/guides/workflows/SPEC-PIPELINE-WORKFLOW.md +3 -3
- package/docs/guides/workflows/STORY-DEVELOPMENT-CYCLE-WORKFLOW.md +3 -3
- package/docs/guides/workflows/pro-developer-workflow.md +2 -2
- package/docs/guides/workflows-guide.md +1 -1
- package/docs/guides/workflows-overview.md +1 -1
- package/docs/installation/npx-install.md +1 -1
- package/docs/installation/uninstallation.md +1 -1
- package/docs/installation/v4-quick-start.md +1 -1
- package/docs/pt/guides/user-guide.md +18 -18
- package/docs/pt/security.md +2 -2
- package/docs/security/overview.md +2 -2
- package/docs/security/security-best-practices.md +1 -1
- package/docs/sinapse-agent-flows/architect-system.md +1 -1
- package/docs/sinapse-agent-flows/data-engineer-system.md +1 -1
- package/docs/sinapse-agent-flows/dev-system.md +1 -1
- package/docs/sinapse-agent-flows/devops-system.md +2 -2
- package/docs/sinapse-agent-flows/qa-system.md +1 -1
- package/docs/sinapse-agent-flows/sm-system.md +2 -2
- package/docs/sinapse-agent-flows/snps-orqx-system.md +4 -4
- package/docs/sinapse-agent-flows/squad-creator-system.md +1 -1
- package/docs/sinapse-workflows/README.md +2 -2
- package/docs/sinapse-workflows/brownfield-discovery-workflow.md +3 -3
- package/docs/sinapse-workflows/brownfield-service-workflow.md +3 -3
- package/docs/sinapse-workflows/greenfield-ui-workflow.md +2 -2
- package/docs/sinapse-workflows/spec-pipeline-workflow.md +3 -3
- package/docs/sinapse-workflows/story-development-cycle-workflow.md +3 -3
- package/docs/troubleshooting.md +1 -1
- package/package.json +7 -1
- package/scripts/calibrate-judge.js +134 -0
- package/scripts/eval-e2e.js +149 -0
- package/scripts/validate-all.js +8 -0
- package/scripts/validate-article-iv.js +289 -0
- package/scripts/validate-constitution.js +58 -0
- package/scripts/validate-evals.js +9 -2
- package/scripts/validate-story-acs.js +174 -0
- package/scripts/validate-tool-descriptions.js +128 -0
- package/scripts/wave-gate.js +207 -0
- package/squads/claude-code-mastery/agents/project-integrator.md +3 -10
- package/squads/claude-code-mastery/knowledge-base/context-window-optimization.md +2 -2
- package/squads/claude-code-mastery/knowledge-base/memory-systems-reference.md +1 -1
- package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +1 -1
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
**Versao:** 2.1 (Target State — Core/Pro Split)
|
|
4
4
|
**Ultima Atualizacao:** 2026-02-09
|
|
5
5
|
**Autor:** @architect (Aria)
|
|
6
|
-
**Epic:**
|
|
7
|
-
**Baseado Em:**
|
|
6
|
+
**Epic:** MIS — Memory Intelligence System
|
|
7
|
+
**Baseado Em:** MIS-1 Investigation
|
|
8
8
|
**Documento Atual:** [memory-system.md](memory-system.md) (estado atual v1.0)
|
|
9
9
|
**Tags:** memory, intelligence, session-digest, progressive-retrieval, self-learning, attention-routing, core-pro-split
|
|
10
10
|
|
|
@@ -1059,14 +1059,14 @@ gantt
|
|
|
1059
1059
|
| Recurso | Caminho |
|
|
1060
1060
|
|---------|---------|
|
|
1061
1061
|
| Estado Atual (v1.0) | [memory-system.md](memory-system.md) |
|
|
1062
|
-
| Epic MIS Index |
|
|
1063
|
-
| MIS-1 Investigation |
|
|
1064
|
-
| MIS-2 Dead Code Cleanup |
|
|
1065
|
-
| Epic PRO Architecture |
|
|
1066
|
-
| ADR-PRO-001 Repository Strategy |
|
|
1067
|
-
| ADR-PRO-003 Feature Gating |
|
|
1068
|
-
| Pro Detector |
|
|
1069
|
-
| Feature Registry |
|
|
1062
|
+
| Epic MIS Index | EPIC-MIS-INDEX.md |
|
|
1063
|
+
| MIS-1 Investigation | story-mis-1-investigation.md |
|
|
1064
|
+
| MIS-2 Dead Code Cleanup | story-mis-2-dead-code-cleanup.md |
|
|
1065
|
+
| Epic PRO Architecture | EPIC-PRO-INDEX.md |
|
|
1066
|
+
| ADR-PRO-001 Repository Strategy | adr-pro-001-repository-strategy.md |
|
|
1067
|
+
| ADR-PRO-003 Feature Gating | adr-pro-003-feature-gating-licensing.md |
|
|
1068
|
+
| Pro Detector | bin/utils/pro-detector.js |
|
|
1069
|
+
| Feature Registry | pro/feature-registry.yaml |
|
|
1070
1070
|
|
|
1071
1071
|
---
|
|
1072
1072
|
|
|
@@ -1349,7 +1349,7 @@ Currently, SINAPSE does not have a formal bug bounty program. However, significa
|
|
|
1349
1349
|
|
|
1350
1350
|
## Related Documentation
|
|
1351
1351
|
|
|
1352
|
-
- [Security Best Practices](../security-best-practices.md) - General security guidelines
|
|
1352
|
+
- [Security Best Practices](../security/security-best-practices.md) - General security guidelines
|
|
1353
1353
|
- [Permission Modes Guide](./permission-modes.md) - Agent autonomy control
|
|
1354
1354
|
- [MCP Global Setup](./mcp-global-setup.md) - Secure MCP configuration
|
|
1355
1355
|
- [Quality Gates](./quality-gates.md) - Security checks in CI/CD
|
|
@@ -507,7 +507,7 @@ await registry.load(true);
|
|
|
507
507
|
|
|
508
508
|
## Related Documentation
|
|
509
509
|
|
|
510
|
-
- [Module System Architecture](../architecture/module-system.md)
|
|
510
|
+
- [Module System Architecture](../pt/architecture/module-system.md)
|
|
511
511
|
- [Quality Gates Guide](./quality-gates.md)
|
|
512
512
|
|
|
513
513
|
---
|
|
@@ -45,7 +45,7 @@ Each example includes comments explaining:
|
|
|
45
45
|
|
|
46
46
|
## Creating Your Own
|
|
47
47
|
|
|
48
|
-
1. Start with the [Squad Template](
|
|
48
|
+
1. Start with the [Squad Template](../../../.sinapse-ai/development/templates/squad-template/)
|
|
49
49
|
2. Reference these examples for patterns
|
|
50
50
|
3. Follow the [Squads Guide](../squads-guide.md)
|
|
51
51
|
|
|
@@ -809,7 +809,7 @@ npm test -- tests/squads/my-squad/
|
|
|
809
809
|
- [TASK-FORMAT-SPECIFICATION-V1](../../.sinapse-ai/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md)
|
|
810
810
|
- [Contributing Squads Guide](./contributing-squads.md)
|
|
811
811
|
- [Squad Migration Guide](./squad-migration.md)
|
|
812
|
-
-
|
|
812
|
+
- Squads API Reference
|
|
813
813
|
- [@squad-creator Agent](../../.sinapse-ai/development/agents/squad-creator.md)
|
|
814
814
|
- [sinapse-squads Repository](https://github.com/caioimori/sinapse-squads)
|
|
815
815
|
|
|
@@ -1207,8 +1207,8 @@ module.exports = {
|
|
|
1207
1207
|
## Related Documentation
|
|
1208
1208
|
|
|
1209
1209
|
- [Quality Gates Guide](./quality-gates.md) - Automated quality checks
|
|
1210
|
-
-
|
|
1211
|
-
- [Contributing Guide](
|
|
1210
|
+
- CI/CD Architecture - Pipeline configuration
|
|
1211
|
+
- [Contributing Guide](../../CONTRIBUTING.md) - Development workflow
|
|
1212
1212
|
|
|
1213
1213
|
---
|
|
1214
1214
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
Complete guide for using SINAPSE - the AI-Orchestrated System for Full Stack Development.
|
|
8
8
|
|
|
9
|
-
**Version:** 1.
|
|
9
|
+
**Version:** 1.21.0
|
|
10
10
|
**Last Updated:** 2026-07-02
|
|
11
11
|
|
|
12
12
|
---
|
|
@@ -79,26 +79,26 @@ SINAPSE includes 11 specialized agents, each with a distinct role and personalit
|
|
|
79
79
|
|
|
80
80
|
| Agent | ID | Archetype | Responsibility |
|
|
81
81
|
| --------- | ---------------- | ------------ | ----------------------- |
|
|
82
|
-
| **
|
|
83
|
-
| **
|
|
84
|
-
| **
|
|
85
|
-
| **
|
|
86
|
-
| **
|
|
87
|
-
| **
|
|
88
|
-
| **
|
|
89
|
-
| **
|
|
90
|
-
| **
|
|
91
|
-
| **
|
|
92
|
-
| **
|
|
82
|
+
| **Pixel** | `@developer` | Builder | Code implementation |
|
|
83
|
+
| **Litmus** | `@quality-gate` | Guardian | Quality assurance |
|
|
84
|
+
| **Stratum** | `@architect` | Architect | Technical architecture |
|
|
85
|
+
| **Axis** | `@product-lead` | Visionary | Product backlog |
|
|
86
|
+
| **Beacon** | `@project-lead` | Balancer | Product strategy |
|
|
87
|
+
| **Sync** | `@sprint-lead` | Facilitator | Process facilitation |
|
|
88
|
+
| **Scope** | `@analyst` | Explorer | Business analysis |
|
|
89
|
+
| **Tensor** | `@data-engineer` | Architect | Data engineering |
|
|
90
|
+
| **Pipeline** | `@devops` | Optimizer | CI/CD and operations |
|
|
91
|
+
| **Mosaic** | `@ux-design-expert` | Creator | User experience |
|
|
92
|
+
| **Imperator** | `@snps-orqx` | Orchestrator | Framework orchestration |
|
|
93
93
|
|
|
94
94
|
### Agent Activation
|
|
95
95
|
|
|
96
96
|
```bash
|
|
97
97
|
# Activate an agent using @ syntax
|
|
98
|
-
@developer # Activate
|
|
99
|
-
@quality-gate # Activate
|
|
100
|
-
@architect # Activate
|
|
101
|
-
@
|
|
98
|
+
@developer # Activate Pixel (Developer)
|
|
99
|
+
@quality-gate # Activate Litmus (QA)
|
|
100
|
+
@architect # Activate Stratum (Architect)
|
|
101
|
+
@snps-orqx # Activate Imperator (Orchestrator)
|
|
102
102
|
|
|
103
103
|
# Agent commands use * prefix
|
|
104
104
|
*help # Show available commands
|
|
@@ -153,7 +153,7 @@ Each command has exactly one authoritative agent owner. When multiple agents mig
|
|
|
153
153
|
| `*develop` | @developer | Use @developer for implementation |
|
|
154
154
|
| `*review` | @quality-gate | Use @quality-gate for code review |
|
|
155
155
|
|
|
156
|
-
See the
|
|
156
|
+
See the Command Authority Matrix for the complete mapping.
|
|
157
157
|
|
|
158
158
|
---
|
|
159
159
|
|
|
@@ -436,13 +436,13 @@ sinapse rebuild
|
|
|
436
436
|
|
|
437
437
|
1. **Quick Start** - Follow this guide to get up and running
|
|
438
438
|
2. **Agent Reference** - Learn about each agent's capabilities: [Agent Reference Guide](../agent-reference-guide.md)
|
|
439
|
-
3. **Architecture** - Understand the system: [Architecture Overview](../architecture/ARCHITECTURE-INDEX.md)
|
|
439
|
+
3. **Architecture** - Understand the system: [Architecture Overview](../pt/architecture/ARCHITECTURE-INDEX.md)
|
|
440
440
|
4. **Squads** - Extend functionality: [Squads Guide](./squads-guide.md)
|
|
441
441
|
|
|
442
442
|
### Advanced Topics
|
|
443
443
|
|
|
444
444
|
- [Quality Gates Guide](./quality-gates.md)
|
|
445
|
-
- [Multi-Repo Strategy](../architecture/multi-repo-strategy.md)
|
|
445
|
+
- [Multi-Repo Strategy](../pt/architecture/multi-repo-strategy.md)
|
|
446
446
|
- [MCP Integration](./mcp-global-setup.md)
|
|
447
447
|
- [IDE Integration](../ide-integration.md)
|
|
448
448
|
|
|
@@ -455,7 +455,7 @@ sinapse rebuild
|
|
|
455
455
|
Always create a story before implementing features:
|
|
456
456
|
|
|
457
457
|
```bash
|
|
458
|
-
@
|
|
458
|
+
@snps-orqx
|
|
459
459
|
*create-story
|
|
460
460
|
```
|
|
461
461
|
|
|
@@ -498,10 +498,10 @@ before building a new agent from scratch.
|
|
|
498
498
|
- [Getting Started](../getting-started.md)
|
|
499
499
|
- [Installation Guide](../installation/README.md)
|
|
500
500
|
- [Agent Reference Guide](../agent-reference-guide.md)
|
|
501
|
-
- [Architecture Overview](../architecture/ARCHITECTURE-INDEX.md)
|
|
501
|
+
- [Architecture Overview](../pt/architecture/ARCHITECTURE-INDEX.md)
|
|
502
502
|
- [Squads Guide](./squads-guide.md)
|
|
503
503
|
- [Troubleshooting](../troubleshooting.md)
|
|
504
504
|
|
|
505
505
|
---
|
|
506
506
|
|
|
507
|
-
_SINAPSE User Guide v1.
|
|
507
|
+
_SINAPSE User Guide v1.21.0_
|
|
@@ -883,9 +883,9 @@ flowchart TD
|
|
|
883
883
|
|
|
884
884
|
### Documentacao Relacionada
|
|
885
885
|
|
|
886
|
-
-
|
|
887
|
-
-
|
|
888
|
-
-
|
|
886
|
+
- ADR-025: Estrutura de Documentacao
|
|
887
|
+
- Guia de Workflows SINAPSE
|
|
888
|
+
- Padrao de Stories
|
|
889
889
|
|
|
890
890
|
---
|
|
891
891
|
|
|
@@ -796,7 +796,7 @@ Os handoff prompts facilitam a transicao entre agentes:
|
|
|
796
796
|
### Documentacao Relacionada
|
|
797
797
|
|
|
798
798
|
- [SINAPSE Knowledge Base](../../../.sinapse-ai/data/sinapse-kb.md) - Base de conhecimento do framework
|
|
799
|
-
- [Technical Preferences](../../../.sinapse-ai/
|
|
799
|
+
- [Technical Preferences](../../../.sinapse-ai/data/technical-preferences.md) - Preferencias tecnicas do projeto
|
|
800
800
|
- [IDE Development Workflow](../../../.sinapse-ai/data/sinapse-kb.md#IDE-Development-Workflow) - Fluxo de desenvolvimento no IDE
|
|
801
801
|
|
|
802
802
|
---
|
|
@@ -906,8 +906,8 @@ flowchart TD
|
|
|
906
906
|
|
|
907
907
|
### Documentacao Relacionada
|
|
908
908
|
|
|
909
|
-
- [SINAPSE Knowledge Base](
|
|
910
|
-
- [Brownfield Workflow](./BROWNFIELD-WORKFLOW.md) - Workflow para projetos existentes (se disponivel)
|
|
909
|
+
- [SINAPSE Knowledge Base](../../../.sinapse-ai/data/sinapse-kb.md) - Base de conhecimento central
|
|
910
|
+
- [Brownfield Workflow](./BROWNFIELD-UI-WORKFLOW.md) - Workflow para projetos existentes (se disponivel)
|
|
911
911
|
|
|
912
912
|
---
|
|
913
913
|
|
|
@@ -965,9 +965,9 @@ flowchart TB
|
|
|
965
965
|
|
|
966
966
|
### 10.3 Documentacao Relacionada
|
|
967
967
|
|
|
968
|
-
-
|
|
969
|
-
-
|
|
970
|
-
-
|
|
968
|
+
- Workflows YAML Guide
|
|
969
|
+
- SINAPSE Documentation Index
|
|
970
|
+
- Backlog Management System
|
|
971
971
|
|
|
972
972
|
### 10.4 Commands Rapidos
|
|
973
973
|
|
|
@@ -826,9 +826,9 @@ cat docs/stories/{story-file}.md | grep "status:"
|
|
|
826
826
|
|
|
827
827
|
### Documentacao Adicional
|
|
828
828
|
|
|
829
|
-
-
|
|
830
|
-
- [Guia de Squads](../squads-
|
|
831
|
-
-
|
|
829
|
+
- Guia de Workflows YAML
|
|
830
|
+
- [Guia de Squads](../squads-guide.md)
|
|
831
|
+
- Framework de Priorizacao
|
|
832
832
|
|
|
833
833
|
---
|
|
834
834
|
|
|
@@ -232,5 +232,5 @@ git submodule update pro
|
|
|
232
232
|
|
|
233
233
|
## Reference
|
|
234
234
|
|
|
235
|
-
-
|
|
236
|
-
-
|
|
235
|
+
- ADR-PRO-001: Repository Strategy
|
|
236
|
+
- Story PRO-5: Repository Bootstrap
|
|
@@ -399,7 +399,7 @@ For complete documentation for each workflow, including detailed step-by-step gu
|
|
|
399
399
|
|
|
400
400
|
## Related Documentation
|
|
401
401
|
|
|
402
|
-
-
|
|
402
|
+
- HybridOps Workflow Diagram - Human-agent collaboration patterns
|
|
403
403
|
- [Agent Reference Guide](../agent-reference-guide.md) - Available agents and their capabilities
|
|
404
404
|
- [Documentation-First Development](./user-guide.md#documentation-first-development) - The documentation pipeline
|
|
405
405
|
|
|
@@ -279,4 +279,4 @@ O SDC Phase 3 suporta 3 modos. Escolha baseado na situacao:
|
|
|
279
279
|
|
|
280
280
|
---
|
|
281
281
|
|
|
282
|
-
_Veja tambem: [Agent Reference](agent-reference.md) | [Architecture Overview](../architecture-overview.md) | [Story Lifecycle](
|
|
282
|
+
_Veja tambem: [Agent Reference](agent-reference.md) | [Architecture Overview](../framework/architecture-overview.md) | [Story Lifecycle](../../CONTRIBUTING.md)_
|
|
@@ -210,7 +210,7 @@ your-project/
|
|
|
210
210
|
## Next Steps
|
|
211
211
|
|
|
212
212
|
1. **Read the full guide:** [Getting Started](../getting-started.md)
|
|
213
|
-
2. **Understand the architecture:** [Core Architecture](../core-architecture.md)
|
|
213
|
+
2. **Understand the architecture:** [Core Architecture](../framework/core-architecture.md)
|
|
214
214
|
3. **Learn about agents:** [Agent Definitions](../../.sinapse-ai/development/agents/)
|
|
215
215
|
4. **Join the community:** [Discord](https://discord.gg/gk8jAdXWmj)
|
|
216
216
|
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
|
|
13
13
|
Guia completo para usar o SINAPSE - o Sistema Orquestrado por IA para Desenvolvimento Full Stack.
|
|
14
14
|
|
|
15
|
-
**Versão:** 1.
|
|
15
|
+
**Versão:** 1.21.0
|
|
16
16
|
**Última Atualização:** 2026-07-02
|
|
17
17
|
|
|
18
18
|
---
|
|
@@ -85,26 +85,26 @@ O SINAPSE inclui 11 agentes especializados, cada um com papel e personalidade di
|
|
|
85
85
|
|
|
86
86
|
| Agente | ID | Arquétipo | Responsabilidade |
|
|
87
87
|
| --------- | ---------------- | ------------ | ------------------------- |
|
|
88
|
-
| **
|
|
89
|
-
| **
|
|
90
|
-
| **
|
|
91
|
-
| **
|
|
92
|
-
| **
|
|
93
|
-
| **
|
|
94
|
-
| **
|
|
95
|
-
| **
|
|
96
|
-
| **
|
|
97
|
-
| **
|
|
98
|
-
| **
|
|
88
|
+
| **Pixel** | `@developer` | Construtor | Implementação de código |
|
|
89
|
+
| **Litmus** | `@quality-gate` | Guardião | Garantia de qualidade |
|
|
90
|
+
| **Stratum** | `@architect` | Arquiteto | Arquitetura técnica |
|
|
91
|
+
| **Axis** | `@product-lead` | Visionário | Backlog do produto |
|
|
92
|
+
| **Beacon** | `@project-lead` | Equilibrador | Estratégia do produto |
|
|
93
|
+
| **Sync** | `@sprint-lead` | Facilitador | Facilitação de processos |
|
|
94
|
+
| **Scope** | `@analyst` | Explorador | Análise de negócios |
|
|
95
|
+
| **Tensor** | `@data-engineer` | Arquiteto | Engenharia de dados |
|
|
96
|
+
| **Pipeline** | `@devops` | Otimizador | CI/CD e operações |
|
|
97
|
+
| **Mosaic** | `@ux-design-expert` | Criador | Experiência do usuário |
|
|
98
|
+
| **Imperator** | `@snps-orqx` | Orquestrador | Orquestração do framework |
|
|
99
99
|
|
|
100
100
|
### Ativação de Agentes
|
|
101
101
|
|
|
102
102
|
```bash
|
|
103
103
|
# Ative um agente usando sintaxe @
|
|
104
|
-
@developer # Ativar
|
|
105
|
-
@quality-gate # Ativar
|
|
106
|
-
@architect # Ativar
|
|
107
|
-
@
|
|
104
|
+
@developer # Ativar Pixel (Desenvolvedor)
|
|
105
|
+
@quality-gate # Ativar Litmus (QA)
|
|
106
|
+
@architect # Ativar Stratum (Arquiteto)
|
|
107
|
+
@snps-orqx # Ativar Imperator (Orquestrador)
|
|
108
108
|
|
|
109
109
|
# Comandos de agente usam prefixo *
|
|
110
110
|
*help # Mostrar comandos disponíveis
|
|
@@ -418,7 +418,7 @@ sinapse rebuild
|
|
|
418
418
|
Sempre crie uma story antes de implementar funcionalidades:
|
|
419
419
|
|
|
420
420
|
```bash
|
|
421
|
-
@
|
|
421
|
+
@snps-orqx
|
|
422
422
|
*create-story
|
|
423
423
|
```
|
|
424
424
|
|
|
@@ -467,5 +467,5 @@ construir um agente novo do zero.
|
|
|
467
467
|
|
|
468
468
|
---
|
|
469
469
|
|
|
470
|
-
_Guia do Usuário SINAPSE v1.
|
|
470
|
+
_Guia do Usuário SINAPSE v1.21.0_
|
|
471
471
|
|
package/docs/pt/security.md
CHANGED
|
@@ -28,7 +28,7 @@ Constitution (Artigo X)
|
|
|
28
28
|
| +-- Tier 2: Bloqueadores de Compliance (LGPD)
|
|
29
29
|
| +-- Tier 3: Bloqueadores Operacionais
|
|
30
30
|
|
|
|
31
|
-
+--
|
|
31
|
+
+-- 20 Hooks Claude Code (aplicacao em tempo real)
|
|
32
32
|
| +-- Varredura de secrets
|
|
33
33
|
| +-- Governanca SQL
|
|
34
34
|
| +-- Gates de arquitetura primeiro
|
|
@@ -148,7 +148,7 @@ Apenas `@devops` (Pipeline) pode executar `git push`. O hook `enforce-git-push-a
|
|
|
148
148
|
|
|
149
149
|
## Arquitetura de Hooks
|
|
150
150
|
|
|
151
|
-
O SINAPSE-AI usa
|
|
151
|
+
O SINAPSE-AI usa 20 hooks Claude Code organizados por evento de trigger:
|
|
152
152
|
|
|
153
153
|
### Mapa de Eventos dos Hooks
|
|
154
154
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# SINAPSE-AI Security Guide
|
|
2
2
|
|
|
3
|
-
> For vulnerability reporting, see [SECURITY.md](
|
|
3
|
+
> For vulnerability reporting, see [SECURITY.md](../../SECURITY.md)
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -204,7 +204,7 @@ SINAPSE-AI uses 17 Claude Code hooks organized by trigger event:
|
|
|
204
204
|
|
|
205
205
|
### For Production Deployments
|
|
206
206
|
|
|
207
|
-
1. **Enable RLS on all tables** with user data (see [RLS Patterns](
|
|
207
|
+
1. **Enable RLS on all tables** with user data (see [RLS Patterns](../../.sinapse-ai/data/rls-security-patterns.md))
|
|
208
208
|
2. **Never expose `service_role`** keys in frontend code
|
|
209
209
|
3. **Configure CORS** with explicit origins (never use `origin: '*'` in production)
|
|
210
210
|
4. **Add rate limiting** to all public API endpoints
|
|
@@ -699,7 +699,7 @@ Ative @github-devops para operacoes de push:
|
|
|
699
699
|
|
|
700
700
|
### Agentes Colaboradores
|
|
701
701
|
|
|
702
|
-
- [@db-sage](
|
|
702
|
+
- [@db-sage](../../squads/claude-code-mastery/_deprecated/db-sage.md) - Arquitetura de dados
|
|
703
703
|
- [@ux-design-expert](../../.sinapse-ai/development/agents/ux-design-expert.md) - Arquitetura frontend
|
|
704
704
|
- [@pm](../../.sinapse-ai/development/agents/project-lead.md) - Requisitos e PRD
|
|
705
705
|
- [@devops](../../.sinapse-ai/development/agents/devops.md) - Git push e infraestrutura
|
|
@@ -548,7 +548,7 @@ O @developer deve **HALT** e perguntar ao usuario quando:
|
|
|
548
548
|
- [greenfield-fullstack.yaml](../../.sinapse-ai/development/workflows/greenfield-fullstack.yaml)
|
|
549
549
|
|
|
550
550
|
### Relacionados
|
|
551
|
-
-
|
|
551
|
+
- BACKLOG-MANAGEMENT-SYSTEM.md
|
|
552
552
|
|
|
553
553
|
---
|
|
554
554
|
|
|
@@ -577,8 +577,8 @@ npm audit --ignore-advisories=ADVISORY_ID
|
|
|
577
577
|
### Documentacao SINAPSE
|
|
578
578
|
|
|
579
579
|
- [Regras de Uso MCP](../../.claude/rules/mcp-usage.md)
|
|
580
|
-
-
|
|
581
|
-
-
|
|
580
|
+
- Operacoes N8N
|
|
581
|
+
- Estrutura de Documentacao
|
|
582
582
|
|
|
583
583
|
### Documentacao Externa
|
|
584
584
|
|
|
@@ -460,10 +460,10 @@ dependencies:
|
|
|
460
460
|
- [Workflow: brownfield-fullstack.yaml](../../.sinapse-ai/development/workflows/brownfield-fullstack.yaml)
|
|
461
461
|
|
|
462
462
|
### Configuracao
|
|
463
|
-
- [Core Config](
|
|
463
|
+
- [Core Config](../../.sinapse-ai/core-config.yaml)
|
|
464
464
|
|
|
465
465
|
### Documentação Relacionada
|
|
466
|
-
-
|
|
466
|
+
- Backlog Management System
|
|
467
467
|
|
|
468
468
|
---
|
|
469
469
|
|
|
@@ -525,14 +525,14 @@ agent:
|
|
|
525
525
|
|
|
526
526
|
### Arquivos Core
|
|
527
527
|
|
|
528
|
-
- [Agente sinapse-orqx](../../.sinapse-ai/development/agents/
|
|
529
|
-
- [Knowledge Base](../../.sinapse-ai/
|
|
528
|
+
- [Agente sinapse-orqx](../../.sinapse-ai/development/agents/snps-orqx.md)
|
|
529
|
+
- [Knowledge Base](../../.sinapse-ai/data/sinapse-kb.md)
|
|
530
530
|
- [Guia do Usuario](../../.sinapse-ai/user-guide.md)
|
|
531
531
|
|
|
532
532
|
### Standards e Documentação
|
|
533
533
|
|
|
534
|
-
-
|
|
535
|
-
- [SINAPSE Livro de Ouro](../../.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO.md)
|
|
534
|
+
- SINAPSE Framework Master
|
|
535
|
+
- [SINAPSE Livro de Ouro](../../.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO-V2.2-SUMMARY.md)
|
|
536
536
|
- [Agent Personalization Standard](../../.sinapse-ai/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md)
|
|
537
537
|
|
|
538
538
|
### Diretorio de Tasks
|
|
@@ -668,7 +668,7 @@ flowchart LR
|
|
|
668
668
|
- [Script: squad-validator.js](../../.sinapse-ai/development/scripts/squad/squad-validator.js)
|
|
669
669
|
- [Schema: squad-schema.json](../../.sinapse-ai/schemas/squad-schema.json)
|
|
670
670
|
- [Agent: squad-creator.md](../../.sinapse-ai/development/agents/squad-creator.md)
|
|
671
|
-
- [Command: squad-creator.md](
|
|
671
|
+
- [Command: squad-creator.md](../../.claude/commands/SINAPSE/agents/squad-creator.md)
|
|
672
672
|
|
|
673
673
|
---
|
|
674
674
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# SINAPSE Workflows - Documentação Detalhada dos Workflows
|
|
2
2
|
|
|
3
|
-
> 🌐 **PT** |
|
|
3
|
+
> 🌐 **PT** | EN | ZH
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -228,7 +228,7 @@ flowchart TD
|
|
|
228
228
|
|--------------|-------------|-----------|
|
|
229
229
|
| Workflows Guide | [docs/guides/workflows-guide.md](../guides/workflows-guide.md) | Guia geral |
|
|
230
230
|
| Agent Flows | [docs/sinapse-agent-flows/](../sinapse-agent-flows/) | Detalhes de agentes |
|
|
231
|
-
| Meta-Agent Commands | [docs/meta-agent-commands.md](../meta-agent-commands.md) | Referência rápida |
|
|
231
|
+
| Meta-Agent Commands | [docs/pt/meta-agent-commands.md](../pt/meta-agent-commands.md) | Referência rápida |
|
|
232
232
|
|
|
233
233
|
---
|
|
234
234
|
|
|
@@ -883,9 +883,9 @@ flowchart TD
|
|
|
883
883
|
|
|
884
884
|
### Documentacao Relacionada
|
|
885
885
|
|
|
886
|
-
-
|
|
887
|
-
-
|
|
888
|
-
-
|
|
886
|
+
- ADR-025: Estrutura de Documentacao
|
|
887
|
+
- Guia de Workflows SINAPSE
|
|
888
|
+
- Padrao de Stories
|
|
889
889
|
|
|
890
890
|
---
|
|
891
891
|
|
|
@@ -795,9 +795,9 @@ Os handoff prompts facilitam a transição entre agentes:
|
|
|
795
795
|
|
|
796
796
|
### Documentação Relacionada
|
|
797
797
|
|
|
798
|
-
- [SINAPSE Knowledge Base](
|
|
799
|
-
- [Technical Preferences](
|
|
800
|
-
- [IDE Development Workflow](
|
|
798
|
+
- [SINAPSE Knowledge Base](../../.sinapse-ai/data/sinapse-kb.md) - Base de conhecimento do framework
|
|
799
|
+
- [Technical Preferences](../../.sinapse-ai/data/technical-preferences.md) - Preferências técnicas do projeto
|
|
800
|
+
- [IDE Development Workflow](../../.sinapse-ai/data/sinapse-kb.md#IDE-Development-Workflow) - Fluxo de desenvolvimento no IDE
|
|
801
801
|
|
|
802
802
|
---
|
|
803
803
|
|
|
@@ -906,8 +906,8 @@ flowchart TD
|
|
|
906
906
|
|
|
907
907
|
### Documentação Relacionada
|
|
908
908
|
|
|
909
|
-
- [SINAPSE Knowledge Base](
|
|
910
|
-
-
|
|
909
|
+
- [SINAPSE Knowledge Base](../../.sinapse-ai/data/sinapse-kb.md) - Base de conhecimento central
|
|
910
|
+
- Brownfield Workflow - Workflow para projetos existentes (se disponível)
|
|
911
911
|
|
|
912
912
|
---
|
|
913
913
|
|
|
@@ -965,9 +965,9 @@ flowchart TB
|
|
|
965
965
|
|
|
966
966
|
### 10.3 Documentação Relacionada
|
|
967
967
|
|
|
968
|
-
-
|
|
969
|
-
-
|
|
970
|
-
-
|
|
968
|
+
- Workflows YAML Guide
|
|
969
|
+
- SINAPSE Documentation Index
|
|
970
|
+
- Backlog Management System
|
|
971
971
|
|
|
972
972
|
### 10.4 Commands Rapidos
|
|
973
973
|
|
|
@@ -826,9 +826,9 @@ cat docs/stories/{story-file}.md | grep "status:"
|
|
|
826
826
|
|
|
827
827
|
### Documentação Adicional
|
|
828
828
|
|
|
829
|
-
-
|
|
830
|
-
-
|
|
831
|
-
-
|
|
829
|
+
- Guia de Workflows YAML
|
|
830
|
+
- Guia de Squads
|
|
831
|
+
- Framework de Priorizacao
|
|
832
832
|
|
|
833
833
|
---
|
|
834
834
|
|