sinapse-ai 1.2.1 → 1.4.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/hooks/README.md +16 -10
- package/.claude/hooks/mind-clone-governance.py +212 -212
- package/.claude/hooks/read-protection.py +152 -152
- package/.claude/hooks/slug-validation.py +175 -175
- package/.claude/hooks/sql-governance.py +183 -183
- package/.claude/rules/documentation-first.md +69 -0
- package/.claude/rules/project-intelligence.md +121 -16
- package/.claude/rules/safe-collaboration.md +2 -2
- package/.codex/agents/developer.md +1 -0
- package/.codex/agents/product-lead.md +1 -0
- package/.codex/agents/project-lead.md +1 -0
- package/.codex/agents/quality-gate.md +1 -0
- package/.codex/agents/snps-orqx.md +72 -10
- package/.codex/agents/sprint-lead.md +1 -0
- package/.sinapse-ai/constitution.md +5 -5
- package/.sinapse-ai/core/grounding/vault.cjs +1 -1
- package/.sinapse-ai/core/orchestration/bob-orchestrator.js +341 -21
- package/.sinapse-ai/core/orchestration/brownfield-handler.js +27 -5
- package/.sinapse-ai/core/orchestration/greenfield-handler.js +61 -2
- package/.sinapse-ai/core-config.yaml +0 -3
- package/.sinapse-ai/data/entity-registry.yaml +13540 -13688
- package/.sinapse-ai/development/agents/developer.md +1 -0
- package/.sinapse-ai/development/agents/product-lead.md +1 -0
- package/.sinapse-ai/development/agents/project-lead.md +1 -0
- package/.sinapse-ai/development/agents/quality-gate.md +1 -0
- package/.sinapse-ai/development/agents/snps-orqx.md +72 -10
- package/.sinapse-ai/development/agents/sprint-lead.md +1 -0
- package/.sinapse-ai/development/scripts/unified-activation-pipeline.js +4 -9
- package/.sinapse-ai/development/tasks/brownfield-create-story.md +13 -0
- package/.sinapse-ai/development/tasks/create-brownfield-story.md +14 -0
- package/.sinapse-ai/development/tasks/push-and-pr.md +89 -0
- package/.sinapse-ai/development/tasks/self-heal.md +84 -0
- package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
- package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
- package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
- package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
- package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
- package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
- package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
- package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
- package/.sinapse-ai/development/workflows/development-cycle.yaml +6 -6
- package/.sinapse-ai/hooks/unified/runners/precompact-runner.js +15 -61
- package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
- package/.sinapse-ai/infrastructure/templates/config/env.example +16 -16
- package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -59
- package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -12
- package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
- package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
- package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
- package/.sinapse-ai/infrastructure/templates/safe-collab/CODEOWNERS.template +16 -16
- package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
- package/.sinapse-ai/install-manifest.yaml +98 -90
- package/.sinapse-ai/local-config.yaml.template +65 -65
- package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
- package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
- package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
- package/.sinapse-ai/monitor/hooks/notification.py +30 -30
- package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
- package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
- package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
- package/.sinapse-ai/monitor/hooks/stop.py +30 -30
- package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
- package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
- package/.sinapse-ai/product/templates/adr.hbs +126 -126
- package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
- package/.sinapse-ai/product/templates/epic.hbs +213 -213
- package/.sinapse-ai/product/templates/ide-rules/codex-rules.md +1 -1
- package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
- package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
- package/.sinapse-ai/product/templates/prd.hbs +202 -202
- package/.sinapse-ai/product/templates/story.hbs +264 -264
- package/.sinapse-ai/product/templates/task.hbs +171 -171
- package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
- package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
- package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
- package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
- package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
- package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
- package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
- package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
- package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
- package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
- package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
- package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
- package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
- package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
- package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
- package/.sinapse-ai/project-config.yaml +0 -3
- package/LICENSE +63 -63
- package/README.en.md +6 -6
- package/README.md +14 -14
- package/bin/commands/install.js +34 -2
- package/bin/lib/register-grounding-hooks.js +1 -1
- package/docs/README.md +24 -58
- package/docs/agent-reference-guide.md +108 -0
- package/docs/constitution-compliance.md +87 -0
- package/docs/framework/orqx-plan.md +1 -1
- package/docs/framework/source-tree.md +1 -1
- package/docs/getting-started.md +68 -0
- package/docs/guides/development-setup.md +2 -2
- package/docs/guides/grounding-setup.md +3 -3
- package/docs/guides/parallel-collaboration-source-of-truth.md +1 -1
- package/docs/guides/squad-commands-reference.md +1 -1
- package/docs/guides/template-engine-v2.md +1 -1
- package/docs/installation/v4-quick-start.md +1 -1
- package/docs/pt/DOCUMENTATION-ROADMAP.md +6 -5
- package/docs/pt/architecture/dual-register-pattern.md +7 -7
- package/docs/pt/architecture/source-tree.md +1 -1
- package/docs/pt/architecture/sub-orqx-pattern.md +5 -5
- package/docs/pt/framework/source-tree.md +1 -1
- package/docs/pt/guides/development-setup.md +2 -2
- package/docs/pt/guides/template-engine-v2.md +1 -1
- package/docs/pt/installation/v4-quick-start.md +1 -1
- package/docs/troubleshooting.md +114 -0
- package/package.json +11 -18
- package/packages/installer/src/wizard/feedback.js +1 -1
- package/packages/installer/src/wizard/questions.js +1 -1
- package/packages/installer/src/wizard/wizard.js +113 -13
- package/packages/installer/templates/vault-routing.example.json +1 -1
- package/packages/sinapse-install/bin/edmcp.js +0 -0
- package/packages/sinapse-install/bin/sinapse-install.js +0 -0
- package/scripts/check-markdown-links.py +352 -353
- package/scripts/perf-baseline.sh +98 -0
- package/scripts/sync-squad-yaml-components.js +137 -0
- package/scripts/validate-all.js +153 -0
- package/scripts/validate-cross-refs.js +225 -0
- package/scripts/validate-no-personal-leaks.js +204 -0
- package/scripts/validate-orqx-discipline.js +160 -0
- package/sinapse/agents/snps-orqx.md +18 -9
- package/sinapse/knowledge-base/routing-catalog.md +2 -2
- package/sinapse/squad.yaml +2 -2
- package/squads/{squad-claude → claude-code-mastery}/agents/claude-orqx.md +50 -1
- package/squads/{squad-claude → claude-code-mastery}/knowledge-base/context-window-optimization.md +1 -1
- package/squads/{squad-claude → claude-code-mastery}/knowledge-base/knowledge-architecture-reference.md +3 -25
- package/squads/{squad-claude → claude-code-mastery}/knowledge-base/skill-creation-patterns.md +3 -3
- package/squads/{squad-claude → claude-code-mastery}/knowledge-base/swarm-orchestration-patterns.md +12 -15
- package/squads/claude-code-mastery/squad.yaml +14 -0
- package/squads/{squad-claude → claude-code-mastery}/workflows/optimization-cycle.yaml +1 -1
- package/squads/{squad-claude → claude-code-mastery}/workflows/project-setup-cycle.yaml +1 -1
- package/squads/squad-animations/agents/animations-orqx.md +53 -0
- package/squads/squad-animations/squad.yaml +15 -0
- package/squads/squad-artdir/agents/artdir-orqx.md +69 -0
- package/squads/squad-artdir/squad.yaml +20 -0
- package/squads/squad-cloning/squad.yaml +15 -0
- package/squads/squad-commercial/squad.yaml +17 -0
- package/squads/squad-copy/squad.yaml +20 -0
- package/squads/squad-council/squad.yaml +17 -0
- package/squads/squad-courses/squad.yaml +14 -0
- package/squads/squad-design/agents/design-orqx.md +49 -0
- package/squads/squad-design/squad.yaml +17 -0
- package/squads/squad-finance/squad.yaml +11 -0
- package/squads/squad-growth/agents/growth-orqx.md +59 -0
- package/squads/squad-growth/squad.yaml +13 -0
- package/squads/squad-paidmedia/squad.yaml +16 -0
- package/squads/squad-product/agents/product-orqx.md +58 -0
- package/squads/squad-product/squad.yaml +13 -0
- package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +2 -48
- package/squads/squad-research/squad.yaml +14 -0
- package/.claude/hooks/enforce-architecture-first.py +0 -197
- package/.claude/hooks/write-path-validation.py +0 -195
- package/.sinapse-ai/lib/build.json +0 -1
- package/bin/utils/pro-detector.js +0 -114
- package/docs/guides/agents/ANALYST-SYSTEM.md +0 -674
- package/docs/guides/agents/ARCHITECT-SYSTEM.md +0 -736
- package/docs/guides/agents/DATA-ENGINEER-SYSTEM.md +0 -802
- package/docs/guides/agents/DEV-SYSTEM.md +0 -580
- package/docs/guides/agents/DEVOPS-SYSTEM.md +0 -638
- package/docs/guides/agents/PM-SYSTEM.md +0 -728
- package/docs/guides/agents/QA-SYSTEM.md +0 -655
- package/docs/guides/agents/SINAPSE-AGENT-FLOWS.zip +0 -0
- package/docs/guides/agents/SINAPSE-MASTER-SYSTEM.md +0 -576
- package/docs/guides/agents/SM-SYSTEM.md +0 -496
- package/docs/guides/agents/SQUAD-CREATOR-SYSTEM.md +0 -699
- package/docs/guides/agents/UX-DESIGN-EXPERT-SYSTEM.md +0 -835
- package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -233
- package/packages/sinapse-pro-cli/package.json +0 -36
- package/packages/sinapse-pro-cli/src/recover.js +0 -101
- package/packages/sinapse-pro-cli/tests/sinapse-pro-bin.smoke.test.js +0 -70
- package/squads/squad-claude/README.md +0 -84
- package/squads/squad-claude/agents/config-engineer.md +0 -73
- package/squads/squad-claude/agents/hooks-architect.md +0 -68
- package/squads/squad-claude/agents/mcp-integrator.md +0 -67
- package/squads/squad-claude/agents/project-integrator.md +0 -73
- package/squads/squad-claude/agents/roadmap-sentinel.md +0 -69
- package/squads/squad-claude/agents/skill-craftsman.md +0 -73
- package/squads/squad-claude/agents/swarm-orqx.md +0 -106
- package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +0 -423
- package/squads/squad-claude/preferences/README.md +0 -15
- package/squads/squad-claude/squad.yaml +0 -32
- package/squads/squad-claude/tasks/audit-settings.md +0 -72
- package/squads/squad-claude/tasks/audit-setup.md +0 -85
- package/squads/squad-claude/tasks/brownfield-setup.md +0 -77
- package/squads/squad-claude/tasks/ci-cd-setup.md +0 -56
- package/squads/squad-claude/tasks/claude-md-engineer.md +0 -58
- package/squads/squad-claude/tasks/context-rot-audit.md +0 -83
- package/squads/squad-claude/tasks/create-agent-definition.md +0 -59
- package/squads/squad-claude/tasks/create-rules.md +0 -55
- package/squads/squad-claude/tasks/create-team-topology.md +0 -72
- package/squads/squad-claude/tasks/diagnose.md +0 -76
- package/squads/squad-claude/tasks/enterprise-config.md +0 -74
- package/squads/squad-claude/tasks/hook-designer.md +0 -72
- package/squads/squad-claude/tasks/integrate-project.md +0 -73
- package/squads/squad-claude/tasks/mcp-integration-plan.md +0 -75
- package/squads/squad-claude/tasks/mcp-workflow.md +0 -75
- package/squads/squad-claude/tasks/multi-project-setup.md +0 -72
- package/squads/squad-claude/tasks/optimize-context.md +0 -75
- package/squads/squad-claude/tasks/optimize-workflow.md +0 -75
- package/squads/squad-claude/tasks/parallel-decomposition.md +0 -77
- package/squads/squad-claude/tasks/permission-strategy.md +0 -74
- package/squads/squad-claude/tasks/sandbox-setup.md +0 -75
- package/squads/squad-claude/tasks/setup-repository.md +0 -58
- package/squads/squad-claude/tasks/setup-wizard.md +0 -78
- package/squads/squad-claude/tasks/worktree-strategy.md +0 -77
- package/squads/squad-design/agents/brad-frost.md +0 -56
- package/squads/squad-design/agents/dan-mall.md +0 -53
- package/squads/squad-design/agents/dave-malouf.md +0 -53
- package/squads/squad-design/agents/nano-banana-generator.md +0 -42
- /package/squads/{squad-claude → claude-code-mastery}/agents/db-sage.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/agents/tools-orqx.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/knowledge-base/agent-team-patterns.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/knowledge-base/claude-code-configuration-reference.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/knowledge-base/claude-code-hooks-reference.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/knowledge-base/claude-code-internals-deep.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/knowledge-base/claude-code-tools-reference.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/knowledge-base/context-engineering-guide.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/knowledge-base/mcp-integration-patterns.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/knowledge-base/memory-systems-reference.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/knowledge-base/retrieval-augmented-generation.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/agent-persona-creation.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/ai-testing-automation.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/audit-hooks.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/automated-code-review-pipeline.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/batch-processing-workflow.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/chain-of-thought-optimization.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/claude-code-hooks-setup.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/claude-code-project-setup.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/configure-settings.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/content-curation-pipeline.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/context-window-audit.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/end-to-end-ai-workflow.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/few-shot-example-library.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/human-in-the-loop-design.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/knowledge-base-architecture.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/knowledge-retrieval-optimization.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/mcp-integration-audit.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/mcp-server-design.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/memory-system-design.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/multi-agent-orchestration.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/multi-turn-conversation-design.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/prompt-testing-framework.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/slash-command-library-design.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/system-prompt-design.md +0 -0
- /package/squads/{squad-claude → claude-code-mastery}/tasks/tool-orchestration-pattern.md +0 -0
|
@@ -1,576 +0,0 @@
|
|
|
1
|
-
# Sistema do Agente @sinapse-orqx
|
|
2
|
-
|
|
3
|
-
> **Versao:** 1.0.0
|
|
4
|
-
> **Criado:** 2026-02-04
|
|
5
|
-
> **Owner:** @sinapse-orqx (Orion)
|
|
6
|
-
> **Status:** Documentacao Oficial
|
|
7
|
-
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
## Visao Geral
|
|
11
|
-
|
|
12
|
-
O **@sinapse-orqx** (Orion - The Orchestrator) e o meta-agente principal do framework SINAPSE-FULLSTACK. Ele atua como orquestrador universal, desenvolvedor de framework e especialista no metodo SINAPSE. Suas principais responsabilidades incluem:
|
|
13
|
-
|
|
14
|
-
- **Orquestracao Universal**: Executa qualquer task de qualquer agente diretamente
|
|
15
|
-
- **Desenvolvimento de Framework**: Cria e modifica agentes, tasks, workflows e templates
|
|
16
|
-
- **Gestao de Componentes**: Valida, deprecia e analisa componentes do sistema
|
|
17
|
-
- **Coordenacao Multi-Agente**: Gerencia workflows complexos entre multiplos agentes
|
|
18
|
-
- **Knowledge Base**: Acesso ao conhecimento completo do SINAPSE Method
|
|
19
|
-
|
|
20
|
-
### Quando Usar
|
|
21
|
-
|
|
22
|
-
- Criar ou modificar componentes do framework (agentes, tasks, workflows)
|
|
23
|
-
- Orquestrar workflows multi-agente complexos
|
|
24
|
-
- Executar qualquer task diretamente sem transformacao de persona
|
|
25
|
-
- Operacoes de meta-framework e coordenacao cross-agente
|
|
26
|
-
- Acessar o Knowledge Base do SINAPSE (*kb)
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
## Lista Completa de Arquivos
|
|
31
|
-
|
|
32
|
-
### Arquivos Core de Tasks do @sinapse-orqx
|
|
33
|
-
|
|
34
|
-
| Arquivo | Comando | Proposito |
|
|
35
|
-
|---------|---------|-----------|
|
|
36
|
-
| `.sinapse-ai/development/tasks/create-agent.md` | `*create agent` | Cria nova definicao de agente usando sistema de templates |
|
|
37
|
-
| `.sinapse-ai/development/tasks/create-task.md` | `*create task` | Cria novo arquivo de task com estrutura padronizada |
|
|
38
|
-
| `.sinapse-ai/development/tasks/create-workflow.md` | `*create workflow` | Cria nova definicao de workflow multi-agente |
|
|
39
|
-
| `.sinapse-ai/development/tasks/modify-agent.md` | `*modify agent` | Modifica agente existente com backup e rollback |
|
|
40
|
-
| `.sinapse-ai/development/tasks/modify-task.md` | `*modify task` | Modifica task existente preservando compatibilidade |
|
|
41
|
-
| `.sinapse-ai/development/tasks/modify-workflow.md` | `*modify workflow` | Modifica workflow existente mantendo integridade |
|
|
42
|
-
| `.sinapse-ai/development/tasks/analyze-framework.md` | `*analyze-framework` | Analisa estrutura do framework, redundancias e performance |
|
|
43
|
-
| `.sinapse-ai/development/tasks/deprecate-component.md` | `*deprecate-component` | Deprecia componente com timeline e migracao |
|
|
44
|
-
| `.sinapse-ai/development/tasks/propose-modification.md` | `*propose-modification` | Cria proposta de modificacao para revisao colaborativa |
|
|
45
|
-
| `.sinapse-ai/development/tasks/execute-checklist.md` | `*execute-checklist` | Executa checklist de validacao |
|
|
46
|
-
| `.sinapse-ai/development/tasks/create-doc.md` | `*create-doc` | Cria documento a partir de template YAML |
|
|
47
|
-
| `.sinapse-ai/development/tasks/advanced-elicitation.md` | `*advanced-elicitation` | Executa elicitacao avancada com multiplos metodos |
|
|
48
|
-
| `.sinapse-ai/development/tasks/kb-mode-interaction.md` | `*kb` | Habilita modo Knowledge Base interativo |
|
|
49
|
-
| `.sinapse-ai/development/tasks/correct-course.md` | `*correct-course` | Analisa e corrige desvios de processo/qualidade |
|
|
50
|
-
| `.sinapse-ai/development/tasks/update-manifest.md` | `*update-manifest` | Atualiza manifesto de equipe com novos agentes |
|
|
51
|
-
| `.sinapse-ai/development/tasks/create-next-story.md` | `*create-next-story` | Cria proxima user story |
|
|
52
|
-
| `.sinapse-ai/development/tasks/create-deep-research-prompt.md` | - | Gera prompts de pesquisa profunda |
|
|
53
|
-
| `.sinapse-ai/development/tasks/improve-self.md` | - | Auto-melhoria do agente |
|
|
54
|
-
| `.sinapse-ai/development/tasks/shard-doc.md` | `*shard-doc` | Quebra documento em partes menores |
|
|
55
|
-
| `.sinapse-ai/development/tasks/document-project.md` | `*document-project` | Gera documentacao do projeto |
|
|
56
|
-
| `.sinapse-ai/development/tasks/index-docs.md` | `*index-docs` | Indexa documentacao para busca |
|
|
57
|
-
|
|
58
|
-
### Arquivos de Definicao do Agente
|
|
59
|
-
|
|
60
|
-
| Arquivo | Proposito |
|
|
61
|
-
|---------|-----------|
|
|
62
|
-
| `.sinapse-ai/development/agents/sinapse-orqx.md` | Definicao completa do agente (persona, comandos, dependencias) |
|
|
63
|
-
| `.claude/commands/SINAPSE/agents/sinapse-orqx.md` | Comando Claude Code para ativar @sinapse-orqx |
|
|
64
|
-
|
|
65
|
-
### Arquivos de Templates do @sinapse-orqx
|
|
66
|
-
|
|
67
|
-
| Arquivo | Proposito |
|
|
68
|
-
|---------|-----------|
|
|
69
|
-
| `.sinapse-ai/development/templates/agent-template.yaml` | Template para criacao de novos agentes |
|
|
70
|
-
| `.sinapse-ai/development/templates/task-template.md` | Template para criacao de novas tasks |
|
|
71
|
-
| `.sinapse-ai/development/templates/workflow-template.yaml` | Template para criacao de novos workflows |
|
|
72
|
-
| `.sinapse-ai/development/templates/prd-tmpl.yaml` | Template para PRD |
|
|
73
|
-
| `.sinapse-ai/development/templates/story-tmpl.yaml` | Template para stories |
|
|
74
|
-
| `.sinapse-ai/development/templates/architecture-tmpl.yaml` | Template para arquitetura |
|
|
75
|
-
| `.sinapse-ai/development/templates/brownfield-prd-tmpl.yaml` | Template PRD brownfield |
|
|
76
|
-
| `.sinapse-ai/development/templates/brownfield-architecture-tmpl.yaml` | Template arquitetura brownfield |
|
|
77
|
-
| `.sinapse-ai/development/templates/competitor-analysis-tmpl.yaml` | Template analise de concorrentes |
|
|
78
|
-
| `.sinapse-ai/development/templates/market-research-tmpl.yaml` | Template pesquisa de mercado |
|
|
79
|
-
| `.sinapse-ai/development/templates/project-brief-tmpl.yaml` | Template brief de projeto |
|
|
80
|
-
| `.sinapse-ai/development/templates/front-end-architecture-tmpl.yaml` | Template arquitetura frontend |
|
|
81
|
-
| `.sinapse-ai/development/templates/front-end-spec-tmpl.yaml` | Template spec frontend |
|
|
82
|
-
| `.sinapse-ai/development/templates/fullstack-architecture-tmpl.yaml` | Template arquitetura fullstack |
|
|
83
|
-
|
|
84
|
-
### Arquivos de Dados e Utilidades
|
|
85
|
-
|
|
86
|
-
| Arquivo | Proposito |
|
|
87
|
-
|---------|-----------|
|
|
88
|
-
| `.sinapse-ai/development/data/sinapse-kb.md` | Knowledge Base do SINAPSE Method |
|
|
89
|
-
| `.sinapse-ai/development/data/brainstorming-techniques.md` | Tecnicas de brainstorming |
|
|
90
|
-
| `.sinapse-ai/development/data/elicitation-methods.md` | Metodos de elicitacao |
|
|
91
|
-
| `.sinapse-ai/development/data/technical-preferences.md` | Preferencias tecnicas |
|
|
92
|
-
| `.sinapse-ai/development/utils/security-checker.js` | Validador de seguranca |
|
|
93
|
-
| `.sinapse-ai/development/utils/yaml-validator.js` | Validador de YAML |
|
|
94
|
-
| `.sinapse-ai/development/utils/workflow-management.md` | Gestao de workflows |
|
|
95
|
-
|
|
96
|
-
### Arquivos de Workflows do @sinapse-orqx
|
|
97
|
-
|
|
98
|
-
| Arquivo | Proposito |
|
|
99
|
-
|---------|-----------|
|
|
100
|
-
| `.sinapse-ai/development/workflows/brownfield-fullstack.md` | Workflow fullstack brownfield |
|
|
101
|
-
| `.sinapse-ai/development/workflows/brownfield-service.md` | Workflow servico brownfield |
|
|
102
|
-
| `.sinapse-ai/development/workflows/brownfield-ui.md` | Workflow UI brownfield |
|
|
103
|
-
| `.sinapse-ai/development/workflows/greenfield-fullstack.md` | Workflow fullstack greenfield |
|
|
104
|
-
| `.sinapse-ai/development/workflows/greenfield-service.md` | Workflow servico greenfield |
|
|
105
|
-
| `.sinapse-ai/development/workflows/greenfield-ui.md` | Workflow UI greenfield |
|
|
106
|
-
|
|
107
|
-
### Arquivos de Checklists do @sinapse-orqx
|
|
108
|
-
|
|
109
|
-
| Arquivo | Proposito |
|
|
110
|
-
|---------|-----------|
|
|
111
|
-
| `.sinapse-ai/development/checklists/architect-checklist.md` | Checklist de arquitetura |
|
|
112
|
-
| `.sinapse-ai/development/checklists/change-checklist.md` | Checklist de mudancas |
|
|
113
|
-
| `.sinapse-ai/development/checklists/pm-checklist.md` | Checklist de PM |
|
|
114
|
-
| `.sinapse-ai/development/checklists/po-master-checklist.md` | Checklist de PO |
|
|
115
|
-
| `.sinapse-ai/development/checklists/story-dod-checklist.md` | Checklist DoD de stories |
|
|
116
|
-
| `.sinapse-ai/development/checklists/story-draft-checklist.md` | Checklist draft de stories |
|
|
117
|
-
|
|
118
|
-
### Arquivos Relacionados de Outros Agentes
|
|
119
|
-
|
|
120
|
-
| Arquivo | Agente | Proposito |
|
|
121
|
-
|---------|--------|-----------|
|
|
122
|
-
| `.sinapse-ai/development/tasks/brownfield-create-epic.md` | @project-lead | Criacao de epics (delegada) |
|
|
123
|
-
| `.sinapse-ai/development/tasks/brownfield-create-story.md` | @project-lead | Criacao de stories (delegada) |
|
|
124
|
-
| `.sinapse-ai/development/tasks/analyst-facilitate-brainstorming.md` | @analyst | Brainstorming (delegado) |
|
|
125
|
-
| `.sinapse-ai/development/tasks/generate-ai-frontend-prompt.md` | @architect | Geracao de prompts AI (delegada) |
|
|
126
|
-
| `.sinapse-ai/development/tasks/create-suite.md` | @quality-gate | Criacao de suites de teste (delegada) |
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
## Flowchart: Sistema Completo
|
|
131
|
-
|
|
132
|
-
```mermaid
|
|
133
|
-
flowchart TB
|
|
134
|
-
subgraph ACTIVATION["🚀 ATIVACAO"]
|
|
135
|
-
USER["👤 Usuario"]
|
|
136
|
-
ACTIVATE["@sinapse-orqx"]
|
|
137
|
-
GREETING["greeting-builder.js<br/>Saudacao Inteligente"]
|
|
138
|
-
end
|
|
139
|
-
|
|
140
|
-
USER -->|"@sinapse-orqx"| ACTIVATE
|
|
141
|
-
ACTIVATE --> GREETING
|
|
142
|
-
|
|
143
|
-
subgraph COMMANDS["👑 COMANDOS PRINCIPAIS"]
|
|
144
|
-
direction TB
|
|
145
|
-
|
|
146
|
-
subgraph CREATE["📝 CRIACAO"]
|
|
147
|
-
CREATE_AGENT["*create agent"]
|
|
148
|
-
CREATE_TASK["*create task"]
|
|
149
|
-
CREATE_WORKFLOW["*create workflow"]
|
|
150
|
-
CREATE_DOC["*create-doc"]
|
|
151
|
-
end
|
|
152
|
-
|
|
153
|
-
subgraph MODIFY["🔧 MODIFICACAO"]
|
|
154
|
-
MOD_AGENT["*modify agent"]
|
|
155
|
-
MOD_TASK["*modify task"]
|
|
156
|
-
MOD_WORKFLOW["*modify workflow"]
|
|
157
|
-
UPDATE_MANIFEST["*update-manifest"]
|
|
158
|
-
end
|
|
159
|
-
|
|
160
|
-
subgraph ANALYZE["🔍 ANALISE"]
|
|
161
|
-
ANALYZE_FW["*analyze-framework"]
|
|
162
|
-
DEPRECATE["*deprecate-component"]
|
|
163
|
-
PROPOSE["*propose-modification"]
|
|
164
|
-
CORRECT["*correct-course"]
|
|
165
|
-
end
|
|
166
|
-
|
|
167
|
-
subgraph EXECUTE["⚡ EXECUCAO"]
|
|
168
|
-
TASK_CMD["*task {name}"]
|
|
169
|
-
WORKFLOW_CMD["*workflow {name}"]
|
|
170
|
-
CHECKLIST["*execute-checklist"]
|
|
171
|
-
end
|
|
172
|
-
|
|
173
|
-
subgraph KB["📚 KNOWLEDGE"]
|
|
174
|
-
KB_MODE["*kb"]
|
|
175
|
-
HELP["*help"]
|
|
176
|
-
GUIDE["*guide"]
|
|
177
|
-
STATUS["*status"]
|
|
178
|
-
end
|
|
179
|
-
end
|
|
180
|
-
|
|
181
|
-
GREETING --> COMMANDS
|
|
182
|
-
|
|
183
|
-
subgraph TEMPLATES["📄 TEMPLATES"]
|
|
184
|
-
AGENT_TMPL["agent-template.yaml"]
|
|
185
|
-
TASK_TMPL["task-template.md"]
|
|
186
|
-
WORKFLOW_TMPL["workflow-template.yaml"]
|
|
187
|
-
DOC_TMPLS["prd-tmpl, story-tmpl, etc."]
|
|
188
|
-
end
|
|
189
|
-
|
|
190
|
-
CREATE_AGENT --> AGENT_TMPL
|
|
191
|
-
CREATE_TASK --> TASK_TMPL
|
|
192
|
-
CREATE_WORKFLOW --> WORKFLOW_TMPL
|
|
193
|
-
CREATE_DOC --> DOC_TMPLS
|
|
194
|
-
|
|
195
|
-
subgraph OUTPUTS["📁 OUTPUTS"]
|
|
196
|
-
AGENTS_DIR[".sinapse-ai/agents/"]
|
|
197
|
-
TASKS_DIR[".sinapse-ai/tasks/"]
|
|
198
|
-
WORKFLOWS_DIR[".sinapse-ai/workflows/"]
|
|
199
|
-
DOCS_DIR["docs/"]
|
|
200
|
-
end
|
|
201
|
-
|
|
202
|
-
AGENT_TMPL --> AGENTS_DIR
|
|
203
|
-
TASK_TMPL --> TASKS_DIR
|
|
204
|
-
WORKFLOW_TMPL --> WORKFLOWS_DIR
|
|
205
|
-
DOC_TMPLS --> DOCS_DIR
|
|
206
|
-
|
|
207
|
-
subgraph DELEGATION["🤝 DELEGACAO"]
|
|
208
|
-
PM["@pm<br/>Epics/Stories"]
|
|
209
|
-
ANALYST["@analyst<br/>Brainstorming"]
|
|
210
|
-
ARCHITECT["@architect<br/>AI Prompts"]
|
|
211
|
-
QA["@qa<br/>Test Suites"]
|
|
212
|
-
end
|
|
213
|
-
|
|
214
|
-
COMMANDS -->|"create-epic"| PM
|
|
215
|
-
COMMANDS -->|"brainstorm"| ANALYST
|
|
216
|
-
COMMANDS -->|"generate-ai-prompt"| ARCHITECT
|
|
217
|
-
COMMANDS -->|"create-suite"| QA
|
|
218
|
-
|
|
219
|
-
style ACTIVATION fill:#e3f2fd
|
|
220
|
-
style COMMANDS fill:#fff8e1
|
|
221
|
-
style TEMPLATES fill:#e8f5e9
|
|
222
|
-
style OUTPUTS fill:#fce4ec
|
|
223
|
-
style DELEGATION fill:#f3e5f5
|
|
224
|
-
```
|
|
225
|
-
|
|
226
|
-
### Diagrama de Ciclo de Vida de Componentes
|
|
227
|
-
|
|
228
|
-
```mermaid
|
|
229
|
-
stateDiagram-v2
|
|
230
|
-
[*] --> IDEA: *propose-modification
|
|
231
|
-
|
|
232
|
-
IDEA --> DRAFT: Usuario aprova
|
|
233
|
-
IDEA --> REJECTED: Usuario rejeita
|
|
234
|
-
|
|
235
|
-
DRAFT --> CREATED: *create {type}
|
|
236
|
-
DRAFT --> MODIFIED: *modify {type}
|
|
237
|
-
|
|
238
|
-
CREATED --> ACTIVE: Validacao OK
|
|
239
|
-
MODIFIED --> ACTIVE: Validacao OK
|
|
240
|
-
|
|
241
|
-
ACTIVE --> ANALYZED: *analyze-framework
|
|
242
|
-
ACTIVE --> DEPRECATED: *deprecate-component
|
|
243
|
-
|
|
244
|
-
ANALYZED --> MODIFIED: Melhorias identificadas
|
|
245
|
-
ANALYZED --> ACTIVE: Sem mudancas
|
|
246
|
-
|
|
247
|
-
DEPRECATED --> REMOVED: Apos timeline
|
|
248
|
-
|
|
249
|
-
REMOVED --> [*]
|
|
250
|
-
REJECTED --> [*]
|
|
251
|
-
|
|
252
|
-
note right of IDEA: 💡 Proposta de modificacao
|
|
253
|
-
note right of DRAFT: 📝 Rascunho em progresso
|
|
254
|
-
note right of CREATED: ✨ Componente criado
|
|
255
|
-
note right of ACTIVE: ✅ Em uso no sistema
|
|
256
|
-
note right of DEPRECATED: ⚠️ Marcado para remocao
|
|
257
|
-
note right of REMOVED: 🗑️ Removido do sistema
|
|
258
|
-
```
|
|
259
|
-
|
|
260
|
-
---
|
|
261
|
-
|
|
262
|
-
## Mapeamento de Comandos para Tasks
|
|
263
|
-
|
|
264
|
-
### Comandos de Criacao
|
|
265
|
-
|
|
266
|
-
| Comando | Task File | Operacao |
|
|
267
|
-
|---------|-----------|----------|
|
|
268
|
-
| `*create agent {name}` | `create-agent.md` | Cria novo agente via elicitacao progressiva |
|
|
269
|
-
| `*create task {name}` | `create-task.md` | Cria nova task com estrutura padronizada |
|
|
270
|
-
| `*create workflow {name}` | `create-workflow.md` | Cria novo workflow multi-agente |
|
|
271
|
-
| `*create-doc {template}` | `create-doc.md` | Cria documento a partir de template YAML |
|
|
272
|
-
| `*create-next-story` | `create-next-story.md` | Cria proxima user story |
|
|
273
|
-
|
|
274
|
-
### Comandos de Modificacao
|
|
275
|
-
|
|
276
|
-
| Comando | Task File | Operacao |
|
|
277
|
-
|---------|-----------|----------|
|
|
278
|
-
| `*modify agent {name}` | `modify-agent.md` | Modifica agente com backup/rollback |
|
|
279
|
-
| `*modify task {name}` | `modify-task.md` | Modifica task preservando compatibilidade |
|
|
280
|
-
| `*modify workflow {name}` | `modify-workflow.md` | Modifica workflow mantendo integridade |
|
|
281
|
-
| `*update-manifest` | `update-manifest.md` | Atualiza manifesto de equipe |
|
|
282
|
-
| `*propose-modification` | `propose-modification.md` | Cria proposta de modificacao |
|
|
283
|
-
|
|
284
|
-
### Comandos de Analise e Validacao
|
|
285
|
-
|
|
286
|
-
| Comando | Task File | Operacao |
|
|
287
|
-
|---------|-----------|----------|
|
|
288
|
-
| `*analyze-framework` | `analyze-framework.md` | Analise completa do framework |
|
|
289
|
-
| `*deprecate-component` | `deprecate-component.md` | Deprecia componente com timeline |
|
|
290
|
-
| `*execute-checklist {name}` | `execute-checklist.md` | Executa checklist de validacao |
|
|
291
|
-
| `*validate-component` | - | Valida seguranca e padroes |
|
|
292
|
-
| `*correct-course` | `correct-course.md` | Corrige desvios de processo |
|
|
293
|
-
|
|
294
|
-
### Comandos de Execucao
|
|
295
|
-
|
|
296
|
-
| Comando | Task File | Operacao |
|
|
297
|
-
|---------|-----------|----------|
|
|
298
|
-
| `*task {name}` | (dinamico) | Executa task especifica |
|
|
299
|
-
| `*workflow {name}` | (dinamico) | Inicia workflow multi-agente |
|
|
300
|
-
| `*plan [create\|status\|update]` | - | Planejamento de workflow |
|
|
301
|
-
|
|
302
|
-
### Comandos de Utilidade
|
|
303
|
-
|
|
304
|
-
| Comando | Task File | Operacao |
|
|
305
|
-
|---------|-----------|----------|
|
|
306
|
-
| `*help` | - | Mostra comandos disponiveis |
|
|
307
|
-
| `*kb` | `kb-mode-interaction.md` | Toggle modo Knowledge Base |
|
|
308
|
-
| `*status` | - | Mostra contexto e progresso atual |
|
|
309
|
-
| `*guide` | - | Mostra guia de uso do agente |
|
|
310
|
-
| `*yolo` | - | Toggle skip de confirmacoes |
|
|
311
|
-
| `*exit` | - | Sai do modo agente |
|
|
312
|
-
| `*advanced-elicitation` | `advanced-elicitation.md` | Elicitacao avancada |
|
|
313
|
-
| `*shard-doc` | `shard-doc.md` | Quebra documento em partes |
|
|
314
|
-
| `*doc-out` | - | Output documento completo |
|
|
315
|
-
| `*index-docs` | `index-docs.md` | Indexa documentacao |
|
|
316
|
-
|
|
317
|
-
---
|
|
318
|
-
|
|
319
|
-
## Integracoes entre Agentes
|
|
320
|
-
|
|
321
|
-
### Diagrama de Delegacao
|
|
322
|
-
|
|
323
|
-
```mermaid
|
|
324
|
-
flowchart LR
|
|
325
|
-
subgraph MASTER["👑 @sinapse-orqx (Orion)"]
|
|
326
|
-
MASTER_DESC["Orquestra todos os agentes<br/>Cria/modifica componentes<br/>Executa qualquer task"]
|
|
327
|
-
end
|
|
328
|
-
|
|
329
|
-
subgraph DELEGATED["🔀 RESPONSABILIDADES DELEGADAS"]
|
|
330
|
-
direction TB
|
|
331
|
-
|
|
332
|
-
subgraph PM_BOX["📋 @pm"]
|
|
333
|
-
PM_DESC["*create-epic<br/>*create-story"]
|
|
334
|
-
end
|
|
335
|
-
|
|
336
|
-
subgraph ANALYST_BOX["🔬 @analyst"]
|
|
337
|
-
ANALYST_DESC["*brainstorm"]
|
|
338
|
-
end
|
|
339
|
-
|
|
340
|
-
subgraph ARCHITECT_BOX["🏛️ @architect"]
|
|
341
|
-
ARCHITECT_DESC["*generate-ai-prompt"]
|
|
342
|
-
end
|
|
343
|
-
|
|
344
|
-
subgraph QA_BOX["🔍 @qa"]
|
|
345
|
-
QA_DESC["*create-suite"]
|
|
346
|
-
end
|
|
347
|
-
end
|
|
348
|
-
|
|
349
|
-
MASTER -->|"Epic/Story creation"| PM_BOX
|
|
350
|
-
MASTER -->|"Brainstorming"| ANALYST_BOX
|
|
351
|
-
MASTER -->|"AI prompt generation"| ARCHITECT_BOX
|
|
352
|
-
MASTER -->|"Test suite creation"| QA_BOX
|
|
353
|
-
|
|
354
|
-
subgraph SPECIALIZED["🎯 AGENTES ESPECIALIZADOS"]
|
|
355
|
-
DEV["@developer - Implementacao"]
|
|
356
|
-
SM["@sprint-lead - Story Management"]
|
|
357
|
-
PO["@product-lead - Product Ownership"]
|
|
358
|
-
DATA["@data-engineer - Database"]
|
|
359
|
-
UX["@ux-design-expert - UX/UI"]
|
|
360
|
-
DEVOPS["@devops - Infrastructure"]
|
|
361
|
-
end
|
|
362
|
-
|
|
363
|
-
MASTER -.->|"Pode executar tasks de"| SPECIALIZED
|
|
364
|
-
|
|
365
|
-
style MASTER fill:#fff3e0
|
|
366
|
-
style DELEGATED fill:#e3f2fd
|
|
367
|
-
style SPECIALIZED fill:#e8f5e9
|
|
368
|
-
```
|
|
369
|
-
|
|
370
|
-
### Quando Usar Agentes Especializados
|
|
371
|
-
|
|
372
|
-
| Cenario | Agente Recomendado | Razao |
|
|
373
|
-
|---------|-------------------|-------|
|
|
374
|
-
| Implementacao de story | @developer | Expertise em codigo |
|
|
375
|
-
| Code review | @quality-gate | Foco em qualidade |
|
|
376
|
-
| Criacao de PRD | @project-lead | Expertise em produto |
|
|
377
|
-
| Criacao de stories | @sprint-lead ou @project-lead | Especializacao Agile |
|
|
378
|
-
| Decisoes de arquitetura | @architect | Expertise tecnica |
|
|
379
|
-
| Operacoes de database | @data-engineer | Expertise em dados |
|
|
380
|
-
| Design de UX/UI | @ux-design-expert | Expertise em design |
|
|
381
|
-
| Operacoes Git | @github-devops | Expertise em DevOps |
|
|
382
|
-
| Pesquisa e analise | @analyst | Expertise analitica |
|
|
383
|
-
|
|
384
|
-
---
|
|
385
|
-
|
|
386
|
-
## Configuracao
|
|
387
|
-
|
|
388
|
-
### Arquivos de Configuracao Relevantes
|
|
389
|
-
|
|
390
|
-
| Arquivo | Proposito |
|
|
391
|
-
|---------|-----------|
|
|
392
|
-
| `.sinapse-ai/core-config.yaml` | Configuracao central do framework |
|
|
393
|
-
| `.sinapse-ai/install-manifest.yaml` | Manifesto de instalacao |
|
|
394
|
-
| `.sinapse-ai/config/agent-config-requirements.yaml` | Requisitos de configuracao de agentes |
|
|
395
|
-
| `.sinapse/project-registry.yaml` | Registry central de projetos |
|
|
396
|
-
|
|
397
|
-
### Configuracao de Seguranca
|
|
398
|
-
|
|
399
|
-
```yaml
|
|
400
|
-
security:
|
|
401
|
-
authorization:
|
|
402
|
-
- Check user permissions before component creation
|
|
403
|
-
- Require confirmation for manifest modifications
|
|
404
|
-
- Log all operations with user identification
|
|
405
|
-
validation:
|
|
406
|
-
- No eval() or dynamic code execution in templates
|
|
407
|
-
- Sanitize all user inputs
|
|
408
|
-
- Validate YAML syntax before saving
|
|
409
|
-
- Check for path traversal attempts
|
|
410
|
-
memory-access:
|
|
411
|
-
- Scoped queries only for framework components
|
|
412
|
-
- No access to sensitive project data
|
|
413
|
-
- Rate limit memory operations
|
|
414
|
-
```
|
|
415
|
-
|
|
416
|
-
### Customizacao do Agente
|
|
417
|
-
|
|
418
|
-
```yaml
|
|
419
|
-
agent:
|
|
420
|
-
customization: |
|
|
421
|
-
- AUTHORIZATION: Check user role/permissions before sensitive operations
|
|
422
|
-
- SECURITY: Validate all generated code for security vulnerabilities
|
|
423
|
-
- MEMORY: Use memory layer to track created components and modifications
|
|
424
|
-
- AUDIT: Log all meta-agent operations with timestamp and user info
|
|
425
|
-
```
|
|
426
|
-
|
|
427
|
-
---
|
|
428
|
-
|
|
429
|
-
## Best Practices
|
|
430
|
-
|
|
431
|
-
### 1. Criacao de Componentes
|
|
432
|
-
|
|
433
|
-
- **Sempre use templates**: Use `*create {type}` ao inves de criar manualmente
|
|
434
|
-
- **Siga a elicitacao**: Nao pule etapas do processo interativo
|
|
435
|
-
- **Valide antes de usar**: Execute `*validate-component` apos criacao
|
|
436
|
-
- **Documente dependencias**: Liste todas as dependencias no componente
|
|
437
|
-
|
|
438
|
-
### 2. Modificacao de Componentes
|
|
439
|
-
|
|
440
|
-
- **Backup primeiro**: O sistema cria backup automaticamente, mas verifique
|
|
441
|
-
- **Use propose-modify**: Para mudancas significativas, use `*propose-modification`
|
|
442
|
-
- **Teste apos modificar**: Sempre teste o componente modificado
|
|
443
|
-
- **Atualize manifestos**: Lembre de executar `*update-manifest` se necessario
|
|
444
|
-
|
|
445
|
-
### 3. Orquestracao de Workflows
|
|
446
|
-
|
|
447
|
-
- **Use agentes especializados**: Delegue para o agente mais apropriado
|
|
448
|
-
- **Planeje antes de executar**: Use `*plan` para workflows complexos
|
|
449
|
-
- **Monitore progresso**: Use `*status` para acompanhar
|
|
450
|
-
|
|
451
|
-
### 4. Gestao de Knowledge Base
|
|
452
|
-
|
|
453
|
-
- **Ative KB quando necessario**: Use `*kb` para consultas sobre o framework
|
|
454
|
-
- **Nao carregue automaticamente**: KB so e carregado sob demanda
|
|
455
|
-
- **Explore topicos especificos**: Use navegacao guiada do KB mode
|
|
456
|
-
|
|
457
|
-
### 5. Seguranca
|
|
458
|
-
|
|
459
|
-
- **Valide inputs**: Sempre sanitize inputs do usuario
|
|
460
|
-
- **Verifique permissoes**: Cheque autorizacao antes de operacoes sensiveis
|
|
461
|
-
- **Audite operacoes**: Todas as acoes sao logadas automaticamente
|
|
462
|
-
|
|
463
|
-
---
|
|
464
|
-
|
|
465
|
-
## Troubleshooting
|
|
466
|
-
|
|
467
|
-
### Problema: Componente nao encontrado
|
|
468
|
-
|
|
469
|
-
**Sintoma:** Erro "Component not found" ao tentar modificar/depreciar
|
|
470
|
-
|
|
471
|
-
**Solucao:**
|
|
472
|
-
1. Verifique o nome exato do componente
|
|
473
|
-
2. Use `*list-components` para ver componentes disponiveis
|
|
474
|
-
3. Cheque o tipo correto (agent, task, workflow, util)
|
|
475
|
-
|
|
476
|
-
### Problema: Template nao encontrado
|
|
477
|
-
|
|
478
|
-
**Sintoma:** Erro ao executar `*create-doc`
|
|
479
|
-
|
|
480
|
-
**Solucao:**
|
|
481
|
-
1. Liste templates disponiveis: verifique `.sinapse-ai/development/templates/`
|
|
482
|
-
2. Use nome correto do template sem extensao
|
|
483
|
-
3. Verifique se template existe e e valido YAML
|
|
484
|
-
|
|
485
|
-
### Problema: Workflow falha
|
|
486
|
-
|
|
487
|
-
**Sintoma:** Workflow interrompe com erro
|
|
488
|
-
|
|
489
|
-
**Solucao:**
|
|
490
|
-
1. Verifique logs com `*status`
|
|
491
|
-
2. Cheque dependencias do workflow
|
|
492
|
-
3. Valide agentes participantes
|
|
493
|
-
4. Use `*correct-course` para analise
|
|
494
|
-
|
|
495
|
-
### Problema: KB mode nao carrega
|
|
496
|
-
|
|
497
|
-
**Sintoma:** Conhecimento nao disponivel apos `*kb`
|
|
498
|
-
|
|
499
|
-
**Solucao:**
|
|
500
|
-
1. Verifique existencia de `.sinapse-ai/development/data/sinapse-kb.md`
|
|
501
|
-
2. Certifique-se de que arquivo nao esta corrompido
|
|
502
|
-
3. Reinicie o agente se necessario
|
|
503
|
-
|
|
504
|
-
### Problema: Backup/rollback falha
|
|
505
|
-
|
|
506
|
-
**Sintoma:** Erro ao criar backup ou reverter
|
|
507
|
-
|
|
508
|
-
**Solucao:**
|
|
509
|
-
1. Verifique permissoes de escrita no diretorio
|
|
510
|
-
2. Cheque espaco em disco
|
|
511
|
-
3. Tente rollback manual do arquivo `.backups/`
|
|
512
|
-
|
|
513
|
-
### Problema: Elicitacao interrompida
|
|
514
|
-
|
|
515
|
-
**Sintoma:** Processo de elicitacao para no meio
|
|
516
|
-
|
|
517
|
-
**Solucao:**
|
|
518
|
-
1. Sessions sao salvas automaticamente
|
|
519
|
-
2. Use `*status` para ver progresso
|
|
520
|
-
3. Continue de onde parou ou reinicie
|
|
521
|
-
|
|
522
|
-
---
|
|
523
|
-
|
|
524
|
-
## Referencias
|
|
525
|
-
|
|
526
|
-
### Arquivos Core
|
|
527
|
-
|
|
528
|
-
- [Agente sinapse-orqx](.sinapse-ai/development/agents/sinapse-orqx.md)
|
|
529
|
-
- [Knowledge Base](.sinapse-ai/development/data/sinapse-kb.md)
|
|
530
|
-
- [Guia do Usuario](.sinapse-ai/user-guide.md)
|
|
531
|
-
|
|
532
|
-
### Standards e Documentacao
|
|
533
|
-
|
|
534
|
-
- [SINAPSE Framework Master](.sinapse-ai/docs/standards/SINAPSE-FRAMEWORK-MASTER.md)
|
|
535
|
-
- [SINAPSE Livro de Ouro](.sinapse-ai/docs/standards/SINAPSE-LIVRO-DE-OURO.md)
|
|
536
|
-
- [Agent Personalization Standard](.sinapse-ai/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md)
|
|
537
|
-
|
|
538
|
-
### Diretorio de Tasks
|
|
539
|
-
|
|
540
|
-
- [Tasks Directory](.sinapse-ai/development/tasks/)
|
|
541
|
-
- [Templates Directory](.sinapse-ai/development/templates/)
|
|
542
|
-
- [Workflows Directory](.sinapse-ai/development/workflows/)
|
|
543
|
-
|
|
544
|
-
---
|
|
545
|
-
|
|
546
|
-
## Resumo
|
|
547
|
-
|
|
548
|
-
| Aspecto | Detalhes |
|
|
549
|
-
|---------|----------|
|
|
550
|
-
| **Nome do Agente** | Orion (sinapse-orqx) |
|
|
551
|
-
| **Arquetipo** | Orchestrator |
|
|
552
|
-
| **Icone** | 👑 |
|
|
553
|
-
| **Total de Tasks Diretas** | 21 tasks |
|
|
554
|
-
| **Total de Templates** | 14 templates |
|
|
555
|
-
| **Total de Workflows** | 6 workflows |
|
|
556
|
-
| **Total de Checklists** | 6 checklists |
|
|
557
|
-
| **Agentes que Delega** | 4 (@project-lead, @analyst, @architect, @quality-gate) |
|
|
558
|
-
| **Comandos de Criacao** | 5 (`*create *`) |
|
|
559
|
-
| **Comandos de Modificacao** | 5 (`*modify *`, `*update-*`, `*propose-*`) |
|
|
560
|
-
| **Comandos de Analise** | 4 (`*analyze-*`, `*deprecate-*`, `*validate-*`, `*correct-*`) |
|
|
561
|
-
| **Comandos de Execucao** | 3 (`*task`, `*workflow`, `*execute-checklist`) |
|
|
562
|
-
| **Comandos de Utilidade** | 10 (`*help`, `*kb`, `*status`, etc.) |
|
|
563
|
-
| **Modos de Execucao** | 3 (YOLO, Interactive, Pre-Flight) |
|
|
564
|
-
|
|
565
|
-
---
|
|
566
|
-
|
|
567
|
-
## Changelog
|
|
568
|
-
|
|
569
|
-
| Data | Autor | Descricao |
|
|
570
|
-
|------|-------|-----------|
|
|
571
|
-
| 2026-02-04 | @sinapse-orqx | Documento inicial criado com mapeamento completo |
|
|
572
|
-
|
|
573
|
-
---
|
|
574
|
-
|
|
575
|
-
*-- Orion, orquestrando o sistema*
|
|
576
|
-
|