Squadra

Squadra 3+ is an efficient coordination tool designed for AI coding agents, specifically Claude, Codex, and Cursor. This powerful toolkit enhances collaboration by consolidating tasks, acknowledgments, proof verifications, and independent reviews in a single, reliable registry that runs directly on your machine without the need for an account. The local dashboard presents this information clearly, making it easy to track progress in multiple languages, including English and Italian.

Key Features

• Unified Registry: Every AI window—the coordinator, builder, and reviewer—writes to a single registry, ensuring that all tasks, messages, proof records, and decisions are recorded without relying on memory.
• Independent Reviews: A distinct identity is required for reviews, ensuring that work is evaluated by someone other than the author, which prevents bias and enhances accountability.
• Immutable Proofs: The prove command verifies changes against the original code, delivering an immutable package of outcomes. Any modifications after proofing invalidate both the proof and the review.
• Acknowledged Tasks: Work only begins when the intended recipient explicitly acknowledges a task. This clear communication helps prevent misunderstandings.
• Interactive Dashboard: The live dashboard displays tasks and visual progress in plain terms. Users can choose light or dark themes and receive alerts for task completions and other updates.
• Robust Checkpointing: The toolkit automatically saves progress, allowing for recovery at any point and enabling seamless handovers while maintaining context and author identity.
• Community Plugin Support: Squadra is extensible through plugins, offering the opportunity for users to create custom solutions that bring additional data into the dashboard.

How Squadra Works

Squadra orchestrates the teamwork of various AI agents through defined roles. A coordinated approach allows tasks to be assigned simultaneously across different windows, reducing downtime and improving efficiency. Each agent can operate on a separate code copy (a checkout) while sharing the same registry, enabling seamless multi-agent workflows.

Example Workflow

1. Initialization: Set up the project and introduce all AI windows to ensure they are connected for task assignment.
2. Task Management: Assign tasks with clearly defined objectives, expectations, and deadlines. Every task is logged in the registry.
3. Build and Validate: Builders complete tasks, running their proof checks before handing over the work for independent validation.
4. Dashboard Monitoring: Utilize the dashboard to track progress in real-time, with the ability to view detailed histories for each task and interaction.

Commands and Communication

Squadra utilizes straightforward commands to facilitate communication between windows:

# Start a squad
Use the squadra skill for this project. Shared registry: ~/.local/state/squadra/atlas.

# Assign work to a builder
Create a task "Key rotation service" for the builder window...

Users can navigate through complex workflows easily with a comprehensive set of commands that encourage clarity and cooperation among all agents.

Conclusion

Overall, Squadra provides a robust, open-source solution that enhances collaborative coding through structured workflows and accountability. Leveraging the capabilities of AI agents, it streamlines project management, promoting efficiency and thorough comprehension of project tasks.