sinapse-ai 7.7.11 → 8.0.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.
Files changed (91) hide show
  1. package/.claude/CLAUDE.md +10 -10
  2. package/.claude/rules/agent-authority.md +7 -7
  3. package/.claude/rules/agent-memory-imports.md +3 -1
  4. package/.claude/rules/coderabbit-integration.md +1 -0
  5. package/.claude/rules/mandatory-delegation.md +10 -10
  6. package/.claude/rules/mcp-usage.md +1 -1
  7. package/.claude/rules/security-data-protection.md +2 -2
  8. package/.claude/rules/security-scanning.md +10 -0
  9. package/.claude/rules/tool-response-filtering.md +1 -0
  10. package/.sinapse-ai/data/entity-registry.yaml +826 -880
  11. package/.sinapse-ai/data/registry-update-log.jsonl +36 -0
  12. package/.sinapse-ai/data/rls-security-patterns.md +384 -0
  13. package/.sinapse-ai/data/sinapse-kb.md +1 -1
  14. package/.sinapse-ai/development/agents/analyst.md +2 -2
  15. package/.sinapse-ai/development/agents/product-lead/MEMORY.md +1 -1
  16. package/.sinapse-ai/development/agents/product-lead.md +4 -4
  17. package/.sinapse-ai/development/agents/project-lead.md +2 -2
  18. package/.sinapse-ai/development/agents/sprint-lead.md +3 -3
  19. package/.sinapse-ai/development/tasks/analyze-project-structure.md +3 -3
  20. package/.sinapse-ai/development/tasks/create-service.md +1 -1
  21. package/.sinapse-ai/development/tasks/create-worktree.md +1 -1
  22. package/.sinapse-ai/development/tasks/environment-bootstrap.md +1 -1
  23. package/.sinapse-ai/development/tasks/execute-epic-plan.md +5 -5
  24. package/.sinapse-ai/development/tasks/extract-patterns.md +1 -1
  25. package/.sinapse-ai/development/tasks/ids-governor.md +1 -1
  26. package/.sinapse-ai/development/tasks/init-project-status.md +1 -1
  27. package/.sinapse-ai/development/tasks/list-worktrees.md +1 -1
  28. package/.sinapse-ai/development/tasks/next.md +1 -1
  29. package/.sinapse-ai/development/tasks/patterns.md +1 -1
  30. package/.sinapse-ai/development/tasks/plan-create-context.md +1 -1
  31. package/.sinapse-ai/development/tasks/plan-create-implementation.md +1 -1
  32. package/.sinapse-ai/development/tasks/plan-execute-subtask.md +1 -1
  33. package/.sinapse-ai/development/tasks/qa-fix-issues.md +1 -1
  34. package/.sinapse-ai/development/tasks/remove-worktree.md +1 -1
  35. package/.sinapse-ai/development/tasks/setup-github.md +1 -1
  36. package/.sinapse-ai/development/tasks/setup-llm-routing.md +1 -1
  37. package/.sinapse-ai/development/tasks/setup-mcp-docker.md +1 -1
  38. package/.sinapse-ai/development/tasks/spec-assess-complexity.md +1 -1
  39. package/.sinapse-ai/development/tasks/spec-critique.md +1 -1
  40. package/.sinapse-ai/development/tasks/spec-gather-requirements.md +1 -1
  41. package/.sinapse-ai/development/tasks/spec-research-dependencies.md +1 -1
  42. package/.sinapse-ai/development/tasks/spec-write-spec.md +1 -1
  43. package/.sinapse-ai/development/tasks/story-checkpoint.md +1 -1
  44. package/.sinapse-ai/development/tasks/update-sinapse.md +1 -1
  45. package/.sinapse-ai/development/tasks/validate-tech-preset.md +1 -1
  46. package/.sinapse-ai/development/tasks/verify-subtask.md +1 -1
  47. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +1 -1
  48. package/.sinapse-ai/install-manifest.yaml +78 -74
  49. package/README.md +341 -215
  50. package/bin/utils/staged-secret-scan.js +5 -0
  51. package/docs/architecture-overview.md +239 -0
  52. package/docs/community.md +2 -2
  53. package/docs/feature-process.md +162 -0
  54. package/docs/getting-started.md +115 -231
  55. package/docs/guides/agent-reference.md +203 -0
  56. package/docs/guides/{MEMORY-INTEGRATION.md → memory-integration.md} +2 -2
  57. package/docs/guides/{MEMORY-INTELLIGENCE-SYSTEM.md → memory-intelligence-system.md} +3 -3
  58. package/docs/guides/workflows-overview.md +282 -0
  59. package/docs/guiding-principles.md +188 -0
  60. package/docs/legal/license-clarification.md +120 -15
  61. package/docs/legal/privacy.md +93 -80
  62. package/docs/legal/terms.md +90 -103
  63. package/docs/{ORQX-PLAN.md → orqx-plan.md} +15 -15
  64. package/docs/pt/FEATURE_PROCESS.md +2 -2
  65. package/docs/pt/GUIDING-PRINCIPLES.md +2 -2
  66. package/docs/pt/community.md +2 -2
  67. package/docs/pt/roadmap.md +2 -2
  68. package/docs/pt/security.md +215 -79
  69. package/docs/roadmap.md +2 -2
  70. package/docs/security/{PR_SECURITY_CHECKLIST.md → pr-security-checklist.md} +1 -1
  71. package/docs/security.md +215 -79
  72. package/package.json +1 -1
  73. package/packages/installer/src/manifest-signature.js +194 -0
  74. package/squads/claude-code-mastery/agents/config-engineer.md +7 -7
  75. package/squads/claude-code-mastery/agents/hooks-architect.md +4 -4
  76. package/squads/claude-code-mastery/agents/mcp-integrator.md +6 -6
  77. package/squads/claude-code-mastery/agents/project-integrator.md +8 -8
  78. package/squads/claude-code-mastery/agents/roadmap-sentinel.md +7 -7
  79. package/squads/claude-code-mastery/agents/skill-craftsman.md +10 -10
  80. package/squads/claude-code-mastery/agents/swarm-orqx.md +4 -4
  81. package/squads/squad-brand/agents/brand-creative-engineer.md +1 -1
  82. package/squads/squad-brand/agents/brand-motion-vfx.md +1 -1
  83. package/squads/squad-brand/agents/brand-sonic-designer.md +1 -1
  84. package/squads/squad-brand/agents/brand-system-architect.md +2 -2
  85. package/docs/FEATURE_PROCESS.md +0 -93
  86. package/docs/GUIDING-PRINCIPLES.md +0 -95
  87. /package/docs/{CHANGELOG.md → changelog.md} +0 -0
  88. /package/docs/guides/{IDS-CONCEITOS-EXPLICADOS.md → ids-conceitos-explicados.md} +0 -0
  89. /package/docs/guides/{MEMORY-SYSTEM.md → memory-system.md} +0 -0
  90. /package/docs/security/{MANIFEST_SIGNING.md → manifest-signing.md} +0 -0
  91. /package/docs/{SQUAD-COMMANDS-REFERENCE.md → squad-commands-reference.md} +0 -0
@@ -753,14 +753,14 @@ Type `*help` to see all commands, or `*guide` for comprehensive usage instructio
753
753
 
754
754
  **I collaborate with:**
755
755
 
756
- - **@devops (Gage):** For applying version upgrades, managing MCP infrastructure, and deploying configuration changes
757
- - **@architect (Aria):** For evaluating architectural impact of new Claude Code features
756
+ - **@devops (Pipeline):** For applying version upgrades, managing MCP infrastructure, and deploying configuration changes
757
+ - **@architect (Stratum):** For evaluating architectural impact of new Claude Code features
758
758
  - **@config-engineer (Sigil):** For settings.json, CLAUDE.md, and .claude/rules/ optimization when adopting new features
759
- - **@developer (Dex):** Receives adoption strategies and plan-first workflows for implementation
759
+ - **@developer (Pixel):** Receives adoption strategies and plan-first workflows for implementation
760
760
 
761
761
  **I delegate to:**
762
762
 
763
- - **@devops (Gage):** For executing `claude update`, applying managed settings, and infrastructure changes
763
+ - **@devops (Pipeline):** For executing `claude update`, applying managed settings, and infrastructure changes
764
764
  - **@config-engineer (Sigil):** For implementing configuration changes recommended by migration guides
765
765
 
766
766
  **When to use others:**
@@ -921,10 +921,10 @@ Run `*sdk-guide` for comprehensive SDK documentation.
921
921
 
922
922
  ### Related Agents
923
923
 
924
- - **@devops (Gage)** - Executes version upgrades and infrastructure changes
925
- - **@architect (Aria)** - Evaluates architectural impact of new features
924
+ - **@devops (Pipeline)** - Executes version upgrades and infrastructure changes
925
+ - **@architect (Stratum)** - Evaluates architectural impact of new features
926
926
  - **@config-engineer (Sigil)** - Implements configuration changes for feature adoption
927
- - **@developer (Dex)** - Primary consumer of plan-first workflows and adoption strategies
927
+ - **@developer (Pixel)** - Primary consumer of plan-first workflows and adoption strategies
928
928
 
929
929
  ---
930
930
  ---
@@ -1104,15 +1104,15 @@ Type `*help` to see all commands, or `*guide` for detailed usage.
1104
1104
 
1105
1105
  **I collaborate with:**
1106
1106
 
1107
- - **@developer (Dex):** Implements application code that skills reference
1108
- - **@architect (Aria):** Provides system architecture context for skill design
1109
- - **@quality-gate (Quinn):** Reviews skill quality and validates trigger accuracy
1110
- - **@devops (Gage):** Handles plugin publishing and marketplace deployment
1107
+ - **@developer (Pixel):** Implements application code that skills reference
1108
+ - **@architect (Stratum):** Provides system architecture context for skill design
1109
+ - **@quality-gate (Litmus):** Reviews skill quality and validates trigger accuracy
1110
+ - **@devops (Pipeline):** Handles plugin publishing and marketplace deployment
1111
1111
 
1112
1112
  **I delegate to:**
1113
1113
 
1114
- - **@devops (Gage):** For git push, PR creation, and plugin marketplace deployment
1115
- - **@developer (Dex):** For implementation of application features beyond skill scope
1114
+ - **@devops (Pipeline):** For git push, PR creation, and plugin marketplace deployment
1115
+ - **@developer (Pixel):** For implementation of application features beyond skill scope
1116
1116
 
1117
1117
  **When to use others:**
1118
1118
 
@@ -1239,10 +1239,10 @@ Type `*help` to see all commands, or `*guide` for detailed usage.
1239
1239
 
1240
1240
  ### Related Agents
1241
1241
 
1242
- - **@developer (Dex)** - Application code implementation
1243
- - **@architect (Aria)** - System architecture
1244
- - **@devops (Gage)** - Publishing and deployment
1245
- - **@quality-gate (Quinn)** - Quality review
1242
+ - **@developer (Pixel)** - Application code implementation
1243
+ - **@architect (Stratum)** - System architecture
1244
+ - **@devops (Pipeline)** - Publishing and deployment
1245
+ - **@quality-gate (Litmus)** - Quality review
1246
1246
  - **@squad-creator (Craft)** - SINAPSE squad creation (complementary)
1247
1247
 
1248
1248
  ---
@@ -937,13 +937,13 @@ Type `*guide` for comprehensive usage instructions.
937
937
 
938
938
  **I collaborate with:**
939
939
 
940
- - **@architect (Aria):** Validates multi-agent topology decisions and system design alignment
941
- - **@developer (Dex):** Receives subagent definitions and team configurations for implementation use
942
- - **@quality-gate (Quinn):** Reviews agent team findings through QA gate validation
940
+ - **@architect (Stratum):** Validates multi-agent topology decisions and system design alignment
941
+ - **@developer (Pixel):** Receives subagent definitions and team configurations for implementation use
942
+ - **@quality-gate (Litmus):** Reviews agent team findings through QA gate validation
943
943
 
944
944
  **I delegate to:**
945
945
 
946
- - **@devops (Gage):** For git push, PR creation, and CI/CD integration of agent configurations
946
+ - **@devops (Pipeline):** For git push, PR creation, and CI/CD integration of agent configurations
947
947
 
948
948
  **When to use others:**
949
949
 
@@ -176,7 +176,7 @@ integration:
176
176
  - agent: "brand-auditor (Sentinel)"
177
177
  when: "Assets criados, precisam de validacao de coerencia"
178
178
  context_passed: "lista de assets gerados, guidelines utilizadas, API usada"
179
- - agent: "@developer (Dex)"
179
+ - agent: "@developer (Pixel)"
180
180
  when: "Asset SVG ou web template precisa ser integrado em codebase"
181
181
  context_passed: "arquivo SVG/HTML/CSS, contexto de uso, responsividade"
182
182
  receives_from:
@@ -126,7 +126,7 @@ commands:
126
126
 
127
127
  integration:
128
128
  delegates_to:
129
- - agent: "@developer (Dex)"
129
+ - agent: "@developer (Pixel)"
130
130
  when: "Motion specs prontas para implementacao"
131
131
  context_passed: "easing curves, durations, codigo CSS/JS, Lottie files"
132
132
  - agent: "brand-auditor (Sentinel)"
@@ -159,7 +159,7 @@ integration:
159
159
  - agent: "brand-auditor (Sentinel)"
160
160
  when: "Sound system criado, precisa de validacao"
161
161
  context_passed: "audio files, sonic DNA docs, sound system specs"
162
- - agent: "@developer (Dex)"
162
+ - agent: "@developer (Pixel)"
163
163
  when: "Notification sounds prontos para integracao em app"
164
164
  context_passed: "audio files, formato, evento de trigger, specs de implementacao"
165
165
  receives_from:
@@ -115,10 +115,10 @@ knowledge_bases:
115
115
 
116
116
  integration:
117
117
  delegates_to:
118
- - agent: "@architect (Aria)"
118
+ - agent: "@architect (Stratum)"
119
119
  when: "Design system precisa de decisao arquitetural sobre tech stack"
120
120
  context_passed: "tokens, componentes, formato de export desejado"
121
- - agent: "@developer (Dex)"
121
+ - agent: "@developer (Pixel)"
122
122
  when: "Design system pronto para implementacao"
123
123
  context_passed: "tokens CSS, componentes documentados, grid specs"
124
124
  - agent: "brand-auditor (Sentinel)"
@@ -1,93 +0,0 @@
1
- # Feature Request Process
2
-
3
- > 🌐 **EN** | [PT](./pt/FEATURE_PROCESS.md) | [ES](./es/FEATURE_PROCESS.md)
4
-
5
- ---
6
-
7
- This document explains how to propose new features for SINAPSE.
8
-
9
- ## Quick Ideas
10
-
11
- For quick ideas or small improvements:
12
-
13
- 1. Open a Discussion in the "Ideas" category
14
- 2. Describe the problem and proposed solution
15
- 3. Community and maintainers will discuss
16
- 4. If there's interest, it may be promoted to RFC
17
-
18
- ## RFC Process (For Significant Features)
19
-
20
- For larger features that require design decisions:
21
-
22
- ### When to Write an RFC
23
-
24
- - New major features
25
- - Breaking changes
26
- - Significant architectural changes
27
- - Changes affecting many users
28
-
29
- ### RFC Lifecycle
30
-
31
- 1. **Draft**: Author writes RFC using our [RFC Template](../.github/RFC_TEMPLATE.md)
32
- 2. **Under Review**: 2-week comment period
33
- 3. **Decision**: Maintainers accept/reject
34
- 4. **Implementation**: If accepted, implementation begins
35
-
36
- ### Criteria for Acceptance
37
-
38
- - Aligns with project vision
39
- - Technically feasible
40
- - Has clear implementation path
41
- - Community demand demonstrated
42
- - Maintainable long-term
43
-
44
- ## Voting
45
-
46
- - Use :+1: reactions to show support
47
- - Top-voted ideas are prioritized
48
- - Maintainers have final decision
49
-
50
- ## Timeline
51
-
52
- - Ideas: No fixed timeline
53
- - RFCs: 2-week minimum review period
54
- - Implementation: Based on roadmap capacity
55
-
56
- ## From Idea to Implementation
57
-
58
- ```text
59
- Community Idea (Discussion)
60
-
61
- │ [Approved by maintainers]
62
-
63
- Internal Backlog Item
64
-
65
- │ [Prioritized by Product Owner]
66
-
67
- Sprint Planning
68
-
69
- │ [Implemented by Development Team]
70
-
71
- Release (credited in CHANGELOG.md)
72
- ```
73
-
74
- ### Who Can Add to Backlog?
75
-
76
- The Product Owner (@product-lead) is the sole authority for adding items to the internal backlog.
77
- This ensures proper prioritization and alignment with project goals.
78
-
79
- ### Contributor Credit
80
-
81
- Contributors whose ideas are implemented will be credited in:
82
-
83
- - The CHANGELOG.md release notes
84
- - The PR that implements the feature
85
- - Our contributors page (if applicable)
86
-
87
- ## Questions?
88
-
89
- Ask in GitHub Discussions or Discord.
90
-
91
- ---
92
-
93
- _See also: [Community Handbook](../COMMUNITY.md) | [Contributing Guide](../CONTRIBUTING.md)_
@@ -1,95 +0,0 @@
1
- # SINAPSE Method Guiding Principles
2
-
3
- > 🌐 **EN** | [PT](./pt/GUIDING-PRINCIPLES.md) | [ES](./es/GUIDING-PRINCIPLES.md)
4
-
5
- ---
6
-
7
- The SINAPSE Method is a natural language framework for AI-assisted software development. These principles ensure contributions maintain the method's effectiveness.
8
-
9
- ## Core Principles
10
-
11
- ### 1. Dev Agents Must Be Lean
12
-
13
- - **Minimize dev agent dependencies**: Development agents that work in IDEs must have minimal context overhead
14
- - **Save context for code**: Every line counts - dev agents should focus on coding, not documentation
15
- - **Web agents can be larger**: Planning agents (PRD Writer, Architect) used in web UI can have more complex tasks and dependencies
16
- - **Small files, loaded on demand**: Multiple small, focused files are better than large files with many branches
17
-
18
- ### 2. Natural Language First
19
-
20
- - **Everything is markdown**: Agents, tasks, templates - all written in plain English
21
- - **No code in core**: The framework itself contains no programming code, only natural language instructions
22
- - **Self-contained templates**: Templates are defined as YAML files with structured sections that include metadata, workflow configuration, and detailed instructions for content generation
23
-
24
- ### 3. Agent and Task Design
25
-
26
- - **Agents define roles**: Each agent is a persona with specific expertise (e.g., Frontend Developer, API Developer)
27
- - **Tasks are procedures**: Step-by-step instructions an agent follows to complete work
28
- - **Templates are outputs**: Structured documents with embedded instructions for generation
29
- - **Dependencies matter**: Explicitly declare only what's needed
30
-
31
- ## Practical Guidelines
32
-
33
- ### When to Add to Core
34
-
35
- - Universal software development needs only
36
- - Doesn't bloat dev agent contexts
37
- - Follows existing agent/task/template patterns
38
-
39
- ### When to Create Squads
40
-
41
- - Domain-specific needs beyond software development
42
- - Non-technical domains (business, wellness, education, creative)
43
- - Specialized technical domains (games, infrastructure, mobile)
44
- - Heavy documentation or knowledge bases
45
- - Anything that would bloat core agents
46
-
47
- See [Squads Overview](./guides/squads-overview.md) for detailed examples and ideas.
48
-
49
- ### Agent Design Rules
50
-
51
- 1. **Web/Planning Agents**: Can have richer context, multiple tasks, extensive templates
52
- 2. **Dev Agents**: Minimal dependencies, focused on code generation, lean task sets
53
- 3. **All Agents**: Clear persona, specific expertise, well-defined capabilities
54
-
55
- ### Task Writing Rules
56
-
57
- 1. Write clear step-by-step procedures
58
- 2. Use markdown formatting for readability
59
- 3. Keep dev agent tasks focused and concise
60
- 4. Planning tasks can be more elaborate
61
- 5. **Prefer multiple small tasks over one large branching task**
62
- - Instead of one task with many conditional paths
63
- - Create multiple focused tasks the agent can choose from
64
- - This keeps context overhead minimal
65
- 6. **Reuse common tasks** - Don't create new document creation tasks
66
- - Use the existing `create-doc` task
67
- - Pass the appropriate YAML template with structured sections
68
- - This maintains consistency and reduces duplication
69
-
70
- ### Template Rules
71
-
72
- Templates follow the [SINAPSE Document Template](../common/utils/sinapse-doc-template.md) specification using YAML format:
73
-
74
- 1. **Structure**: Templates are defined in YAML with clear metadata, workflow configuration, and section hierarchy
75
- 2. **Separation of Concerns**: Instructions for LLMs are in `instruction` fields, separate from content
76
- 3. **Reusability**: Templates are agent-agnostic and can be used across different agents
77
- 4. **Key Components**:
78
- - `template` block for metadata (id, name, version, output settings)
79
- - `workflow` block for interaction mode configuration
80
- - `sections` array defining document structure with nested subsections
81
- - Each section has `id`, `title`, and `instruction` fields
82
- 5. **Advanced Features**:
83
- - Variable substitution using `{{variable_name}}` syntax
84
- - Conditional sections with `condition` field
85
- - Repeatable sections with `repeatable: true`
86
- - Agent permissions with `owner` and `editors` fields
87
- - Examples arrays for guidance (never included in output)
88
- 6. **Clean Output**: YAML structure ensures all processing logic stays separate from generated content
89
-
90
- ## Remember
91
-
92
- - The power is in natural language orchestration, not code
93
- - Dev agents code, planning agents plan
94
- - Keep dev agents lean for maximum coding efficiency
95
- - Starter squads handle specialized domains
File without changes