What problem does it solve?
It prevents premature repo/team file creation by orchestrating a two-phase team initialization that first proposes roles for confirmation, then only creates the required .squad/ structure after approval.
Core Features & Use Cases
- Phase 1 Team Proposal (with confirmation): Identifies the user via
git config user.name, proposes a cast (with a casting and persistent naming algorithm), and uses ask_user to confirm the roster before touching the filesystem.
- Phase 2 Team Creation (guardrailed initialization): Creates
.squad/ directories, initializes casting state files (policy.json, registry.json, history.json), seeds agent context, and enforces team.md with the required ## Members header for workflow compatibility.
- Repo-safety and merge readiness: Adds
.gitattributes merge rules for append-only .squad/ files to reduce conflicts across branches.
- Use Case: Starting a new project where no
.squad/team.md exists yet—this skill quickly turns a high-level project description into a ready team structure without risking accidental changes before the user approves.
Quick Start
Use init-mode to initialize .squad/ by first proposing a team roster and then, after you confirm, creating the full project team structure.