Shore up squad init --sdk: unified SDK init quality gate #347
Description
SDK Init Shore-Up — Umbrella Issue
Consolidates: #337, #338, #339, #340, #341, #342
Problem
squad init --sdk produces incomplete squad state. Three critical gaps:
- Config ↔ team.md sync broken (SDK init: Adding team members doesn't update squad.config.ts #337) — Adding/removing members updates team.md but never touches squad.config.ts
- Built-in members missing (SDK init: Ralph (Work Monitor) missing from generated squad.config.ts #338, SDK init: @copilot routing configured without team.md roster entry #339) — Ralph and @copilot work in CLI squads but are invisible to SDK consumers
- CastingEngine bypassed (CLI casting bypasses CastingEngine template system #342) — CLI init uses raw LLM prompts, ignoring curated universe templates
Solution: 3-Phase Plan
Phase 1 — Fix the Gaps (P1, Small)
- SDK init: Adding team members doesn't update squad.config.ts #337 — Config ↔ team.md sync: update squad.config.ts when members change
- SDK init: Ralph (Work Monitor) missing from generated squad.config.ts #338 — Include Ralph in generated squad.config.ts
- SDK init: @copilot routing configured without team.md roster entry #339 — Add @copilot to team.md roster and squad.config.ts
Phase 2 — Wire CastingEngine (P1, Medium)
- CLI casting bypasses CastingEngine template system #342 — Integrate CastingEngine into CLI init flow (augment LLM proposals with curated templates)
Phase 3 — Exercise Test Matrix (P2, Large)
- SDK feature parity: 29 features need active exercise testing #340 — 29 features need active exercise testing
- PRD: SDK-First Feature Parity — Full Test Results (32/50 verified, 6 gaps, 12 need setup) #341 — Full parity test results (32/50 verified, gaps identified)
PRD & Analysis
- Full PRD:
.squad/identity/prd-sdk-init-shoreup.md - Technical Analysis:
.squad/identity/sdk-init-technical-analysis.md - Implementation Roadmap:
.squad/identity/sdk-init-implementation-roadmap.md
Open Design Questions
- AST vs regex for squad.config.ts mutations
- CastingEngine: augment LLM proposals (recommended) or replace entirely?
- Ralph charter: create one, or document as "built-in, no charter"?
Success Criteria
squad init --sdkgenerates config with all team members including Ralph and @copilot- Adding/removing members updates squad.config.ts automatically
- CastingEngine templates used during init (not bypassed)
- Test matrix at 90%+ verified features