What problem does it solve?
Defines core conventions and patterns used in the Squad codebase to ensure consistency, reliability, and safe, maintainable AI squad tooling.
Core Features & Use Cases
- Zero-dependency design for Squad CLI tools, relying only on Node.js built-ins.
- Defined error handling pattern using fatal() for user-facing errors and clean failure modes.
- Standardized CLI and project structure with .squad/ directories and templates.
- Windows compatibility and robust path handling via path.join to avoid platform-specific bugs.
- Init idempotency to avoid overwriting user state during setup or upgrades.
- Copy pattern guidance for safe file and directory operations during upgrades and scaffolding.
- Real-world use: teams adopting Squad conventions can bootstrap new projects with consistent tooling and error handling from day one.
- Anti-pattern warnings and governance to prevent unsafe changes.
Quick Start
Audit your Squad project against these conventions to ensure zero-dependency patterns and safe file operations.