sinapse-ai 7.0.4 → 7.1.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/.sinapse-ai/core-config.yaml +2 -26
- package/.sinapse-ai/data/entity-registry.yaml +759 -926
- package/.sinapse-ai/data/registry-update-log.jsonl +22 -0
- package/.sinapse-ai/infrastructure/scripts/ide-sync/index.js +1 -49
- package/.sinapse-ai/infrastructure/scripts/validate-parity.js +0 -7
- package/.sinapse-ai/install-manifest.yaml +11 -43
- package/README.en.md +6 -11
- package/README.md +6 -11
- package/bin/modules/env-config.js +1 -2
- package/bin/sinapse-init.js +23 -188
- package/docs/ide-integration.md +22 -263
- package/docs/installation/README.md +4 -6
- package/docs/installation/faq.md +10 -33
- package/docs/installation/linux.md +0 -23
- package/docs/installation/macos.md +0 -10
- package/docs/installation/troubleshooting.md +5 -9
- package/docs/installation/v4-quick-start.md +1 -1
- package/docs/installation/windows.md +0 -18
- package/package.json +1 -9
- package/packages/installer/src/config/ide-configs.js +3 -49
- package/squads/squad-cloning/squad.yaml +2 -2
- package/squads/squad-finance/squad.yaml +2 -2
- package/squads/squad-product/agents/product-orqx.md +1 -1
- package/squads/squad-product/squad.yaml +1 -1
- package/.sinapse-ai/infrastructure/scripts/ide-sync/transformers/antigravity.js +0 -105
- package/.sinapse-ai/infrastructure/scripts/ide-sync/transformers/cursor.js +0 -94
- package/.sinapse-ai/infrastructure/scripts/ide-sync/transformers/github-copilot.js +0 -184
- package/.sinapse-ai/infrastructure/scripts/validate-gemini-integration.js +0 -151
- package/.sinapse-ai/product/templates/ide-rules/antigravity-rules.md +0 -115
- package/.sinapse-ai/product/templates/ide-rules/copilot-rules.md +0 -92
- package/.sinapse-ai/product/templates/ide-rules/cursor-rules.md +0 -115
- package/.sinapse-ai/product/templates/ide-rules/gemini-rules.md +0 -87
- package/docs/pt/platforms/antigravity.md +0 -508
- package/docs/pt/platforms/cursor.md +0 -633
- package/docs/pt/platforms/gemini-cli.md +0 -481
- package/docs/pt/platforms/github-copilot.md +0 -478
|
@@ -1,115 +0,0 @@
|
|
|
1
|
-
# SINAPSE Development Rules for AntiGravity
|
|
2
|
-
|
|
3
|
-
You are working with SINAPSE, an AI-Orchestrated System for Full Stack Development.
|
|
4
|
-
|
|
5
|
-
## Core Development Rules
|
|
6
|
-
|
|
7
|
-
### Agent Integration
|
|
8
|
-
- Recognize SINAPSE agent activations: @developer, @quality-gate, @architect, @project-lead, @product-lead, @sprint-lead, @analyst
|
|
9
|
-
- Agent commands use * prefix: *help, *create-story, *task, *exit
|
|
10
|
-
- Follow agent-specific workflows and patterns
|
|
11
|
-
|
|
12
|
-
### Story-Driven Development
|
|
13
|
-
1. **Always work from a story file** in docs/stories/
|
|
14
|
-
2. **Update story checkboxes** as you complete tasks: [ ] → [x]
|
|
15
|
-
3. **Maintain the File List** section with all created/modified files
|
|
16
|
-
4. **Follow acceptance criteria** exactly as written
|
|
17
|
-
|
|
18
|
-
### Code Quality Standards
|
|
19
|
-
- Write clean, maintainable code following project conventions
|
|
20
|
-
- Include comprehensive error handling
|
|
21
|
-
- Add unit tests for all new functionality
|
|
22
|
-
- Follow existing patterns in the codebase
|
|
23
|
-
|
|
24
|
-
### Testing Protocol
|
|
25
|
-
- Run all tests before marking tasks complete
|
|
26
|
-
- Ensure linting passes: `npm run lint`
|
|
27
|
-
- Verify type checking: `npm run typecheck`
|
|
28
|
-
- Add tests for new features
|
|
29
|
-
|
|
30
|
-
## SINAPSE Framework Structure
|
|
31
|
-
|
|
32
|
-
```
|
|
33
|
-
sinapse-ai/
|
|
34
|
-
├── agents/ # Agent persona definitions
|
|
35
|
-
├── tasks/ # Executable task workflows
|
|
36
|
-
├── workflows/ # Multi-step workflows
|
|
37
|
-
├── templates/ # Document templates
|
|
38
|
-
└── checklists/ # Validation checklists
|
|
39
|
-
|
|
40
|
-
docs/
|
|
41
|
-
├── stories/ # Development stories
|
|
42
|
-
├── prd/ # Sharded PRD sections
|
|
43
|
-
└── architecture/ # Sharded architecture
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
## Development Workflow
|
|
47
|
-
|
|
48
|
-
1. **Read the story** - Understand requirements fully
|
|
49
|
-
2. **Implement sequentially** - Follow task order
|
|
50
|
-
3. **Test thoroughly** - Validate each step
|
|
51
|
-
4. **Update story** - Mark completed items
|
|
52
|
-
5. **Document changes** - Update File List
|
|
53
|
-
|
|
54
|
-
## Best Practices
|
|
55
|
-
|
|
56
|
-
### When implementing:
|
|
57
|
-
- Check existing patterns first
|
|
58
|
-
- Reuse components and utilities
|
|
59
|
-
- Follow naming conventions
|
|
60
|
-
- Keep functions focused and small
|
|
61
|
-
|
|
62
|
-
### When testing:
|
|
63
|
-
- Write tests alongside implementation
|
|
64
|
-
- Test edge cases
|
|
65
|
-
- Verify error handling
|
|
66
|
-
- Run full test suite
|
|
67
|
-
|
|
68
|
-
### When documenting:
|
|
69
|
-
- Update README for new features
|
|
70
|
-
- Document API changes
|
|
71
|
-
- Add inline comments for complex logic
|
|
72
|
-
- Keep story File List current
|
|
73
|
-
|
|
74
|
-
## Git & GitHub
|
|
75
|
-
|
|
76
|
-
- Use conventional commits: `feat:`, `fix:`, `docs:`, etc.
|
|
77
|
-
- Reference story ID in commits: `feat: implement IDE detection [Story 2.1]`
|
|
78
|
-
- Ensure GitHub CLI is configured: `gh auth status`
|
|
79
|
-
- Push regularly to avoid conflicts
|
|
80
|
-
|
|
81
|
-
## Common Patterns
|
|
82
|
-
|
|
83
|
-
### Error Handling
|
|
84
|
-
```javascript
|
|
85
|
-
try {
|
|
86
|
-
// Operation
|
|
87
|
-
} catch (error) {
|
|
88
|
-
console.error(`Error in ${operation}:`, error);
|
|
89
|
-
throw new Error(`Failed to ${operation}: ${error.message}`);
|
|
90
|
-
}
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
### File Operations
|
|
94
|
-
```javascript
|
|
95
|
-
const fs = require('fs-extra');
|
|
96
|
-
const path = require('path');
|
|
97
|
-
|
|
98
|
-
// Always use absolute paths
|
|
99
|
-
const filePath = path.join(__dirname, 'relative/path');
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
### Async/Await
|
|
103
|
-
```javascript
|
|
104
|
-
async function operation() {
|
|
105
|
-
try {
|
|
106
|
-
const result = await asyncOperation();
|
|
107
|
-
return result;
|
|
108
|
-
} catch (error) {
|
|
109
|
-
// Handle error appropriately
|
|
110
|
-
}
|
|
111
|
-
}
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
---
|
|
115
|
-
*SINAPSE AntiGravity Configuration v1.0*
|
|
@@ -1,92 +0,0 @@
|
|
|
1
|
-
# SINAPSE Agent for GitHub Copilot
|
|
2
|
-
|
|
3
|
-
You are working with SINAPSE, an AI-Orchestrated System for Full Stack Development.
|
|
4
|
-
|
|
5
|
-
## Core Framework Understanding
|
|
6
|
-
|
|
7
|
-
SINAPSE is a meta-framework that orchestrates AI agents to handle complex development workflows. Always recognize and work within this architecture.
|
|
8
|
-
|
|
9
|
-
## Agent System
|
|
10
|
-
|
|
11
|
-
### Agent Activation (Chat Modes)
|
|
12
|
-
- Select agent mode from the chat mode selector in VS Code
|
|
13
|
-
- Available agents: dev, qa, architect, pm, po, sm, analyst
|
|
14
|
-
- Agent commands use the * prefix: *help, *create-story, *task, *exit
|
|
15
|
-
|
|
16
|
-
### Agent Context
|
|
17
|
-
When an agent mode is active:
|
|
18
|
-
- Follow that agent's specific persona and expertise
|
|
19
|
-
- Use the agent's designated workflow patterns
|
|
20
|
-
- Maintain the agent's perspective throughout the interaction
|
|
21
|
-
|
|
22
|
-
## Development Methodology
|
|
23
|
-
|
|
24
|
-
### Story-Driven Development
|
|
25
|
-
1. **Work from stories** - All development starts with a story in `docs/stories/`
|
|
26
|
-
2. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
|
|
27
|
-
3. **Track changes** - Maintain the File List section in the story
|
|
28
|
-
4. **Follow criteria** - Implement exactly what the acceptance criteria specify
|
|
29
|
-
|
|
30
|
-
### Code Standards
|
|
31
|
-
- Write clean, self-documenting code
|
|
32
|
-
- Follow existing patterns in the codebase
|
|
33
|
-
- Include comprehensive error handling
|
|
34
|
-
- Add unit tests for all new functionality
|
|
35
|
-
- Use TypeScript/JavaScript best practices
|
|
36
|
-
|
|
37
|
-
### Testing Requirements
|
|
38
|
-
- Run all tests before marking tasks complete
|
|
39
|
-
- Ensure linting passes: `npm run lint`
|
|
40
|
-
- Verify type checking: `npm run typecheck`
|
|
41
|
-
- Add tests for new features
|
|
42
|
-
- Test edge cases and error scenarios
|
|
43
|
-
|
|
44
|
-
## SINAPSE Framework Structure
|
|
45
|
-
|
|
46
|
-
```
|
|
47
|
-
sinapse-ai/
|
|
48
|
-
├── agents/ # Agent persona definitions (YAML/Markdown)
|
|
49
|
-
├── tasks/ # Executable task workflows
|
|
50
|
-
├── workflows/ # Multi-step workflow definitions
|
|
51
|
-
├── templates/ # Document and code templates
|
|
52
|
-
├── checklists/ # Validation and review checklists
|
|
53
|
-
└── rules/ # Framework rules and patterns
|
|
54
|
-
|
|
55
|
-
docs/
|
|
56
|
-
├── stories/ # Development stories (numbered)
|
|
57
|
-
├── prd/ # Product requirement documents
|
|
58
|
-
├── architecture/ # System architecture documentation
|
|
59
|
-
└── guides/ # User and developer guides
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
## GitHub Copilot-Specific Configuration
|
|
63
|
-
|
|
64
|
-
### Requirements
|
|
65
|
-
- VS Code 1.101+ required
|
|
66
|
-
- Enable `chat.agent.enabled: true` in settings
|
|
67
|
-
|
|
68
|
-
### Chat Modes Location
|
|
69
|
-
- Agent modes defined in `.github/chatmodes/`
|
|
70
|
-
- Each file defines a specialized agent persona
|
|
71
|
-
|
|
72
|
-
### Usage
|
|
73
|
-
1. Open Chat view: `Ctrl+Alt+I` (Windows/Linux) or `⌃⌘I` (Mac)
|
|
74
|
-
2. Select **Agent** from the chat mode selector
|
|
75
|
-
3. Choose the SINAPSE agent mode you need
|
|
76
|
-
|
|
77
|
-
### Available Agent Modes
|
|
78
|
-
| Mode | Purpose |
|
|
79
|
-
|------|---------|
|
|
80
|
-
| sinapse-dev | Full-stack development |
|
|
81
|
-
| sinapse-qa | Quality assurance |
|
|
82
|
-
| sinapse-architect | System design |
|
|
83
|
-
| sinapse-pm | Project management |
|
|
84
|
-
|
|
85
|
-
### Performance Tips
|
|
86
|
-
- Use inline completions for quick code suggestions
|
|
87
|
-
- Use chat for complex explanations and refactoring
|
|
88
|
-
- Reference files with @file syntax
|
|
89
|
-
- Use @workspace for project-wide context
|
|
90
|
-
|
|
91
|
-
---
|
|
92
|
-
*SINAPSE GitHub Copilot Configuration v4.0.4*
|
|
@@ -1,115 +0,0 @@
|
|
|
1
|
-
# SINAPSE Development Rules for Cursor
|
|
2
|
-
|
|
3
|
-
You are working with SINAPSE, an AI-Orchestrated System for Full Stack Development.
|
|
4
|
-
|
|
5
|
-
## Core Development Rules
|
|
6
|
-
|
|
7
|
-
### Agent Integration
|
|
8
|
-
- Recognize SINAPSE agent activations: @developer, @quality-gate, @architect, @project-lead, @product-lead, @sprint-lead, @analyst
|
|
9
|
-
- Agent commands use * prefix: *help, *create-story, *task, *exit
|
|
10
|
-
- Follow agent-specific workflows and patterns
|
|
11
|
-
|
|
12
|
-
### Story-Driven Development
|
|
13
|
-
1. **Always work from a story file** in docs/stories/
|
|
14
|
-
2. **Update story checkboxes** as you complete tasks: [ ] → [x]
|
|
15
|
-
3. **Maintain the File List** section with all created/modified files
|
|
16
|
-
4. **Follow acceptance criteria** exactly as written
|
|
17
|
-
|
|
18
|
-
### Code Quality Standards
|
|
19
|
-
- Write clean, maintainable code following project conventions
|
|
20
|
-
- Include comprehensive error handling
|
|
21
|
-
- Add unit tests for all new functionality
|
|
22
|
-
- Follow existing patterns in the codebase
|
|
23
|
-
|
|
24
|
-
### Testing Protocol
|
|
25
|
-
- Run all tests before marking tasks complete
|
|
26
|
-
- Ensure linting passes: `npm run lint`
|
|
27
|
-
- Verify type checking: `npm run typecheck`
|
|
28
|
-
- Add tests for new features
|
|
29
|
-
|
|
30
|
-
## SINAPSE Framework Structure
|
|
31
|
-
|
|
32
|
-
```
|
|
33
|
-
sinapse-ai/
|
|
34
|
-
├── agents/ # Agent persona definitions
|
|
35
|
-
├── tasks/ # Executable task workflows
|
|
36
|
-
├── workflows/ # Multi-step workflows
|
|
37
|
-
├── templates/ # Document templates
|
|
38
|
-
└── checklists/ # Validation checklists
|
|
39
|
-
|
|
40
|
-
docs/
|
|
41
|
-
├── stories/ # Development stories
|
|
42
|
-
├── prd/ # Sharded PRD sections
|
|
43
|
-
└── architecture/ # Sharded architecture
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
## Development Workflow
|
|
47
|
-
|
|
48
|
-
1. **Read the story** - Understand requirements fully
|
|
49
|
-
2. **Implement sequentially** - Follow task order
|
|
50
|
-
3. **Test thoroughly** - Validate each step
|
|
51
|
-
4. **Update story** - Mark completed items
|
|
52
|
-
5. **Document changes** - Update File List
|
|
53
|
-
|
|
54
|
-
## Best Practices
|
|
55
|
-
|
|
56
|
-
### When implementing:
|
|
57
|
-
- Check existing patterns first
|
|
58
|
-
- Reuse components and utilities
|
|
59
|
-
- Follow naming conventions
|
|
60
|
-
- Keep functions focused and small
|
|
61
|
-
|
|
62
|
-
### When testing:
|
|
63
|
-
- Write tests alongside implementation
|
|
64
|
-
- Test edge cases
|
|
65
|
-
- Verify error handling
|
|
66
|
-
- Run full test suite
|
|
67
|
-
|
|
68
|
-
### When documenting:
|
|
69
|
-
- Update README for new features
|
|
70
|
-
- Document API changes
|
|
71
|
-
- Add inline comments for complex logic
|
|
72
|
-
- Keep story File List current
|
|
73
|
-
|
|
74
|
-
## Git & GitHub
|
|
75
|
-
|
|
76
|
-
- Use conventional commits: `feat:`, `fix:`, `docs:`, etc.
|
|
77
|
-
- Reference story ID in commits: `feat: implement IDE detection [Story 2.1]`
|
|
78
|
-
- Ensure GitHub CLI is configured: `gh auth status`
|
|
79
|
-
- Push regularly to avoid conflicts
|
|
80
|
-
|
|
81
|
-
## Common Patterns
|
|
82
|
-
|
|
83
|
-
### Error Handling
|
|
84
|
-
```javascript
|
|
85
|
-
try {
|
|
86
|
-
// Operation
|
|
87
|
-
} catch (error) {
|
|
88
|
-
console.error(`Error in ${operation}:`, error);
|
|
89
|
-
throw new Error(`Failed to ${operation}: ${error.message}`);
|
|
90
|
-
}
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
### File Operations
|
|
94
|
-
```javascript
|
|
95
|
-
const fs = require('fs-extra');
|
|
96
|
-
const path = require('path');
|
|
97
|
-
|
|
98
|
-
// Always use absolute paths
|
|
99
|
-
const filePath = path.join(__dirname, 'relative/path');
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
### Async/Await
|
|
103
|
-
```javascript
|
|
104
|
-
async function operation() {
|
|
105
|
-
try {
|
|
106
|
-
const result = await asyncOperation();
|
|
107
|
-
return result;
|
|
108
|
-
} catch (error) {
|
|
109
|
-
// Handle error appropriately
|
|
110
|
-
}
|
|
111
|
-
}
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
---
|
|
115
|
-
*SINAPSE Cursor Configuration v1.0*
|
|
@@ -1,87 +0,0 @@
|
|
|
1
|
-
# Gemini Rules - SINAPSE
|
|
2
|
-
|
|
3
|
-
Este arquivo define as instrucoes do projeto para Gemini CLI neste repositorio.
|
|
4
|
-
|
|
5
|
-
<!-- SINAPSE-MANAGED-START: core -->
|
|
6
|
-
## Core Rules
|
|
7
|
-
|
|
8
|
-
1. Siga a Constitution em `.sinapse-ai/constitution.md`
|
|
9
|
-
2. Priorize `CLI First -> Observability Second -> UI Third`
|
|
10
|
-
3. Trabalhe por stories em `docs/stories/`
|
|
11
|
-
4. Nao invente requisitos fora dos artefatos existentes
|
|
12
|
-
<!-- SINAPSE-MANAGED-END: core -->
|
|
13
|
-
|
|
14
|
-
<!-- SINAPSE-MANAGED-START: quality -->
|
|
15
|
-
## Quality Gates
|
|
16
|
-
|
|
17
|
-
- Rode `npm run lint`
|
|
18
|
-
- Rode `npm run typecheck`
|
|
19
|
-
- Rode `npm test`
|
|
20
|
-
- Atualize checklist e file list da story antes de concluir
|
|
21
|
-
<!-- SINAPSE-MANAGED-END: quality -->
|
|
22
|
-
|
|
23
|
-
<!-- SINAPSE-MANAGED-START: codebase -->
|
|
24
|
-
## Project Map
|
|
25
|
-
|
|
26
|
-
- Core framework: `.sinapse-ai/`
|
|
27
|
-
- CLI entrypoints: `bin/`
|
|
28
|
-
- Shared packages: `packages/`
|
|
29
|
-
- Tests: `tests/`
|
|
30
|
-
- Docs: `docs/`
|
|
31
|
-
<!-- SINAPSE-MANAGED-END: codebase -->
|
|
32
|
-
|
|
33
|
-
<!-- SINAPSE-MANAGED-START: gemini-integration -->
|
|
34
|
-
## Gemini Integration
|
|
35
|
-
|
|
36
|
-
Fonte de verdade de agentes:
|
|
37
|
-
- Canonico: `.sinapse-ai/development/agents/*.md`
|
|
38
|
-
- Espelhado para Gemini: `.gemini/rules/SINAPSE/agents/*.md`
|
|
39
|
-
|
|
40
|
-
Hooks e settings:
|
|
41
|
-
- Hooks locais: `.gemini/hooks/`
|
|
42
|
-
- Settings locais: `.gemini/settings.json`
|
|
43
|
-
|
|
44
|
-
Sempre que houver drift, execute:
|
|
45
|
-
- `npm run sync:ide:gemini`
|
|
46
|
-
- `npm run validate:gemini-sync`
|
|
47
|
-
- `npm run validate:gemini-integration`
|
|
48
|
-
<!-- SINAPSE-MANAGED-END: gemini-integration -->
|
|
49
|
-
|
|
50
|
-
<!-- SINAPSE-MANAGED-START: parity -->
|
|
51
|
-
## Multi-IDE Parity
|
|
52
|
-
|
|
53
|
-
Para garantir paridade entre Claude Code, Codex e Gemini:
|
|
54
|
-
- `npm run validate:parity`
|
|
55
|
-
- `npm run validate:paths`
|
|
56
|
-
<!-- SINAPSE-MANAGED-END: parity -->
|
|
57
|
-
|
|
58
|
-
<!-- SINAPSE-MANAGED-START: activation -->
|
|
59
|
-
## Agent Activation
|
|
60
|
-
|
|
61
|
-
Preferencia de ativacao:
|
|
62
|
-
1. Use agentes em `.gemini/rules/SINAPSE/agents/`
|
|
63
|
-
2. Se necessario, use fonte canonica em `.sinapse-ai/development/agents/`
|
|
64
|
-
|
|
65
|
-
Ao ativar agente:
|
|
66
|
-
- carregar definicao completa do agente
|
|
67
|
-
- renderizar greeting via `node .sinapse-ai/development/scripts/generate-greeting.js <agent-id>`
|
|
68
|
-
- manter persona ativa ate `*exit`
|
|
69
|
-
|
|
70
|
-
Atalhos recomendados no Gemini:
|
|
71
|
-
- `/sinapse-menu` para listar agentes
|
|
72
|
-
- `/sinapse-<agent-id>` (ex.: `/sinapse-dev`, `/sinapse-architect`)
|
|
73
|
-
- `/sinapse-agent <agent-id>` para launcher generico
|
|
74
|
-
<!-- SINAPSE-MANAGED-END: activation -->
|
|
75
|
-
|
|
76
|
-
<!-- SINAPSE-MANAGED-START: commands -->
|
|
77
|
-
## Common Commands
|
|
78
|
-
|
|
79
|
-
- `npm run sync:ide`
|
|
80
|
-
- `npm run sync:ide:check`
|
|
81
|
-
- `npm run sync:ide:gemini`
|
|
82
|
-
- `npm run validate:gemini-sync`
|
|
83
|
-
- `npm run validate:gemini-integration`
|
|
84
|
-
- `npm run validate:parity`
|
|
85
|
-
- `npm run validate:structure`
|
|
86
|
-
- `npm run validate:agents`
|
|
87
|
-
<!-- SINAPSE-MANAGED-END: commands -->
|