- **Communication (`swarms/communication`)**: Provides wrappers for inter-agent communication, database access, message passing, and
- **Communication (`swarms/communication`)**: Provides wrappers for inter-agent communication, database access, message passing, and
@ -104,6 +97,34 @@ The Swarms protocol is organized into several key layers, each responsible for a
---
---
## Proposing Large Improvements or Enhancements: Swarms Improvement Proposals (SIPs)
For significant changes, new agent architectures, or radical new features, Swarms uses a formal process called **Swarms Improvement Proposals (SIPs)**. SIPs are design documents that describe new features, enhancements, or changes to the Swarms framework. They ensure that major changes are well-documented, discussed, and reviewed by the community before implementation.
**When to use a SIP:**
- Proposing new agent types, swarm patterns, or coordination mechanisms
- Core framework changes or breaking changes
- New integrations (LLM providers, tools, external services)
- Any complex or multi-component feature
**SIP Process Overview:**
1. Discuss your idea in [GitHub Discussions](https://github.com/kyegomez/swarms/discussions)
2. Submit a SIP as a GitHub Issue using the SIP template
3. Engage with the community and iterate on your proposal
4. Undergo review and, if accepted, proceed to implementation
**Learn more:** See the full [SIP Guidelines and Template](https://docs.swarms.world/en/latest/protocol/sip/)
---
## Detailed Architecture Diagram
## Detailed Architecture Diagram
The following Mermaid diagram visualizes the protocol flow and the relationship between the main folders in the `swarms/` package:
The following Mermaid diagram visualizes the protocol flow and the relationship between the main folders in the `swarms/` package:
@ -409,6 +430,8 @@ For more on the philosophy and architecture, see [Development Philosophy & Princ