You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
squad init installs generic CI/CD workflows without opt-in #201
When squad init is run, it copies all 12 workflows from templates/workflows/ into the user's .github/workflows/ directory unconditionally. These fall into two distinct categories:
Category 1 — Squad-framework workflows (appropriate in user repos)
These automate Squad's AI team features and make sense in any Squad-enabled repo:
squad-heartbeat.yml — Auto-triage on issues/PRs via Ralph
squad-triage.yml — Assigns squad:* labels when squad label is added
squad-issue-assign.yml — Routes issues to agent members
sync-squad-labels.yml — Syncs squad:* labels from team.md roster
Category 2 — Squad product CI/CD (should never be installed in user repos)
These are Squad's own product pipeline and make assumptions about Squad's specific tech stack:
Conflict with existing CI workflows the user already has
Fail on non-Node projects (Python, Go, Rust, etc.)
Trigger unwanted release automation against Squad's own branch strategy
Fix
Add a FRAMEWORK_WORKFLOWS constant and unconditionally filter the workflow copy loop to only install the four framework workflows. No option or user prompt needed — the Category 2 workflows are Squad's own product CI/CD and have no place in any user repo.
Scope note (from architectural review):squad upgrade continues to sync all 12 workflows for existing users — the templates.ts manifest was intentionally left out of scope for this fix. New users get only the 4 framework workflows on init; existing users on upgrade see no change. A future enhancement could let users opt out of specific workflows via .squad/config.json.
Excellent analysis, @williamhallatt! Separating framework workflows (for user repos) from Squad product CI/CD (for our own pipeline) is a critical distinction. Silently installing unrelated workflows creates confusion and failure modes. Your FRAMEWORK_WORKFLOWS filter is exactly right. Thanks for thinking this through! 🎯
Activity
fix(sdk): only install Squad-framework workflows during init
williamhallatt commentedon Mar 5, 2026
Scope note (from architectural review):
squad upgradecontinues to sync all 12 workflows for existing users — thetemplates.tsmanifest was intentionally left out of scope for this fix. New users get only the 4 framework workflows oninit; existing users onupgradesee no change. A future enhancement could let users opt out of specific workflows via.squad/config.json.docs(ai-team): Merge PR github#201 workflow filter reviews
feat: Wave 3 — docs migration, site engine, 5 guides, mechanical upda…
fix: wire aspire CLI, export doctor, opt-in workflows, auto-gitignore…
fix: wire aspire CLI, export doctor, opt-in workflows, auto-gitignore…
bradygaster commentedon Mar 7, 2026
✅ Fixed in PR #233 — added --no-workflows flag to squad init.
bradygaster commentedon Mar 7, 2026
Excellent analysis, @williamhallatt! Separating framework workflows (for user repos) from Squad product CI/CD (for our own pipeline) is a critical distinction. Silently installing unrelated workflows creates confusion and failure modes. Your FRAMEWORK_WORKFLOWS filter is exactly right. Thanks for thinking this through! 🎯
— McManus 📝, on behalf of the Squad