squad-lifecycle

Automate BotNexus squad lifecycle management with deterministic naming and state merging.

2|3|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/sytone/botnexus --skill squad-lifecycle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: squad-lifecycle
Source: https://github.com/sytone/botnexus/tree/main/.copilot/skills/squad-lifecycle
Command: npx skills add https://github.com/sytone/botnexus --skill squad-lifecycle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Squad Lifecycle skill automates the end-to-end process of initializing, casting, and managing BotNexus squads, ensuring consistent setup and governance across repositories.

Core Features & Use Cases

  • Init Mode: Propose and validate a new squad roster before any files are created, preserving user intent.
  • Casting & Registry: deterministically assign unique cast names from a chosen universe and maintain casting state (registry.json, history.json, and domain mappings).
  • Team Management & Migrations: migrate legacy squads, join or retire agents, and maintain routing and decision logs with append-only history.
  • Integration Governance: enforce templates, roster headers (## Members), and orchestration pipelines to keep squad state in sync with workflows.

Quick Start

Initiate Init Mode to propose a squad roster and wait for user confirmation before creating the .squad structure.

Frequently Asked Questions about squad-lifecycle

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate squad setup and team member casting for BotNexus workflows?

To automate squad setup and team member casting, initiate Init Mode to propose and validate a roster, then apply deterministic naming and state merging rules to generate the .squad directory structure. This ensures consistent casting state and routing across branches.

What is the best way to migrate legacy squads and maintain routing state?

The best way to migrate legacy squads is to use the migration workflow to join or retire agents while maintaining routing and decision logs. It enforces append-only history via history.json to ensure smooth collaboration and preserve state integrity.

How does the .squad directory convention ensure deterministic team management?

The .squad directory convention ensures deterministic team management by enforcing policy.json and roster templates. It governs state merging rules, artifact formats, and registry.json to maintain consistent casting state and domain mappings.

Can I validate a squad roster before creating files and applying workflow templates?

Yes, you can validate a squad roster before files are created by using Init Mode. It proposes the roster and waits for user confirmation, preserving user intent before initializing the .squad structure and applying orchestration pipelines.

Do I need to manually update registry.json when adding or removing team members?

You do not need to manually update registry.json when adding or removing team members. The squad lifecycle process automatically maintains casting state, domain mappings, and history.json through deterministic assignment and append-only logging.

Why does squad state fall out of sync across branches during team management?

Squad state falls out of sync across branches when integration governance is not enforced. Applying roster headers and orchestration pipelines ensures that squad state and workflow routing remain consistently synchronized across all branches.