Title: [EPIC] v0.5.0 — .squad/ Migration & Architectural Cleanup · Issue #91 · github/squad · GitHub
Open Graph Title: [EPIC] v0.5.0 — .squad/ Migration & Architectural Cleanup · Issue #91 · github/squad
X Title: [EPIC] v0.5.0 — .squad/ Migration & Architectural Cleanup · Issue #91 · github/squad
Description: v0.5.0 — Last Breaking Change Before v1.0 Timeline: Feb 17 - Mar 16, 2026 (4 weeks) Release Date: March 16, 2026 Status: In Progress (Week 1 Day 2) Breaking Change Primary: Consolidate to single .squad/ directory (#69) .ai-team/ → .squad...
Open Graph Description: v0.5.0 — Last Breaking Change Before v1.0 Timeline: Feb 17 - Mar 16, 2026 (4 weeks) Release Date: March 16, 2026 Status: In Progress (Week 1 Day 2) Breaking Change Primary: Consolidate to single .s...
X Description: v0.5.0 — Last Breaking Change Before v1.0 Timeline: Feb 17 - Mar 16, 2026 (4 weeks) Release Date: March 16, 2026 Status: In Progress (Week 1 Day 2) Breaking Change Primary: Consolidate to single .s...
Opengraph URL: https://github.com/github/squad/issues/91
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[EPIC] v0.5.0 — .squad/ Migration & Architectural Cleanup","articleBody":"# v0.5.0 — Last Breaking Change Before v1.0\r\n\r\n**Timeline:** Feb 17 - Mar 16, 2026 (4 weeks) \r\n**Release Date:** March 16, 2026 \r\n**Status:** In Progress (Week 1 Day 2)\r\n\r\n## Breaking Change\r\n\r\n**Primary:** Consolidate to single `.squad/` directory (#69)\r\n- `.ai-team/` → `.squad/`\r\n- `.ai-team-templates/` → `.squad/templates/` (nested)\r\n- ~1,672 occurrences across 130+ files\r\n- Mandatory migration via `squad upgrade --migrate-directory`\r\n- Backward compatibility window: v0.5.0 → v1.0.0\r\n- Full legacy removal: v1.0.0\r\n\r\n**Rationale:** One folder to find, one folder to .gitignore, one folder to understand. No confusion about where Squad state lives.\r\n\r\n## MUST Ship Issues\r\n\r\n| Issue | Title | Owner | Estimate |\r\n|-------|-------|-------|----------|\r\n| #69 | Consolidate to .squad/ (directory + templates) | Fenster | 85h |\r\n| #76 | Refactor squad.agent.md for GHE 30KB limit | Verbal | 24h |\r\n| #86 | Squad undid uncommitted changes (HIGH SEVERITY) | Fenster + Hockney | 6-12h |\r\n| #71 | Cleanup label workflows | Fenster | 18h |\r\n| #84 | Add timestamps to session logs | Fenster | 12h |\r\n| #62 | CI/CD integration patterns | Kobayashi | 28h |\r\n\r\n**Total Core:** ~173-179 squad-hours\r\n\r\n## Bundled Enhancements\r\n\r\n| PR | Title | Status | Shipped |\r\n|----|-------|--------|---------|\r\n| #80 | Add llms.txt outputs to docs build | ✅ Merged to dev | Feb 17 |\r\n| #89 | Fix MCP Discord notifications setup docs | ✅ Merged to dev | Feb 17 |\r\n\r\nBoth ride with v0.5.0 release March 16.\r\n\r\n## Launch Features\r\n\r\n### Insider Program (Week 1 Priority)\r\n**Binary access model:** Insider (continuous dev/nightly) or Release (stable).\r\n\r\n**WHY FIRST:** Testing infrastructure enables incremental validation throughout sprint. Contributors test #69, #76, #86 fixes as they merge to dev, not waiting until Week 3 beta.\r\n\r\n**Installation:**\r\n- Regular: `npx github:bradygaster/squad`\r\n- Insider: `npx github:bradygaster/squad#insider`\r\n- Upgrade: `squad upgrade` supports regular → insider switching\r\n\r\n**Architecture:**\r\n- Separate `insider` branch (\"dev minus the team state\")\r\n- Isolated state: `.squad-insider/` directory\r\n- Version: `v0.5.0-insider+{commit}` for bug reporting\r\n- Honor-system access + public list in CONTRIBUTORS.md\r\n\r\n**No rings, no caps:** Everyone who contributes meaningfully can be an insider.\r\n\r\n**Recognition:** `[INSIDER]` badge in CONTRIBUTORS.md, Discord #squad-insiders channel, blog credits, release notes.\r\n\r\n**Responsibilities:** Test within 48-72h, file detailed bugs, validate exit criteria (optional).\r\n\r\n## Supporting Initiatives\r\n\r\n### Blogging (McManus)\r\nTarget: 4 blog posts during v0.5.0 cycle\r\n1. **Week 1 (Feb 20-21):** v0.5.0 kickoff — insider program opens, migration preview, #86 findings\r\n2. **Week 2 (Feb 27-28):** Under the hood — squad.agent.md split (#76), single-folder rationale\r\n3. **Week 3 (Mar 6-7):** Insider testing — early signals, migration feedback\r\n4. **Week 4 (Mar 16):** v0.5.0 ships — migration guide, insider invitation confirmation, #86 fix announcement\r\n\r\n### Architectural Analysis (#86 & #87)\r\n**Decision (Feb 16, comment #3911872475):**\r\n- **#86 (data loss bug):** STAYS in v0.5.0. HIGH SEVERITY, trust-destroying. Week 1 investigation ✅ COMPLETE (prompt-only fix, 3-4h). Don't ship v0.5.0 until fix validated across 4 test scenarios.\r\n- **#87 (workflow npm assumptions):** DEFERRED to v0.6.0. Polish feature, user workaround exists (delete 3 files), not a blocker, scope protection paramount.\r\n\r\n## Deferred to v0.6.0\r\n\r\n| Issue | Title | Rationale |\r\n|-------|-------|-----------|\r\n| #63 | Review label taxonomy | Post-migration polish |\r\n| #82 | Session log compression | Performance optimization |\r\n| #85 | Skill confidence auto-bump | Intelligence enhancement |\r\n| #36 | JetBrains + GitHub.com research | After VS Code parity (#32-35) |\r\n| #79 | Historical decision search | Discovery feature |\r\n| #87 | Workflow project type detection | Template polish, not blocker |\r\n| #75 | Agent spawning metrics | Observability |\r\n\r\n## Mandatory Beta Program\r\n\r\n**Cohort size:** 5-10 users \r\n**Duration:** Week 3-4 (Mar 3-16) \r\n**Target:** Power users, existing contributors, early adopters\r\n\r\n**Exit criteria (all required):**\r\n1. Migration succeeds on 5 real repos (with existing `.ai-team/` state)\r\n2. Zero state corruption reports\r\n3. Upgrade path tested (v0.4.1 → v0.5.0)\r\n4. Workflows pass on migrated repos\r\n5. Documentation validates (migration guide, troubleshooting)\r\n6. #86 fix validated (no more uncommitted work loss)\r\n7. Performance acceptable (no >10% overhead vs v0.4.1)\r\n\r\n## Timeline\r\n\r\n### Week 1 (Feb 17-23): Insider Program + Critical Investigation\r\n**PRIMARY:** Insider Program infrastructure (enables incremental testing)\r\n- Set up `insider` branch + CI/CD automation\r\n- Document install paths (regular vs insider)\r\n- CONTRIBUTORS.md badge system\r\n- Discord #squad-insiders channel setup\r\n- First insider publish (v0.5.0-insider+{commit})\r\n\r\n**SECONDARY:** Critical bug investigation\r\n- #86 data loss bug ✅ COMPLETE (Fenster: reproduced, root cause identified, prompt-only fix designed)\r\n- #69 audit ✅ COMPLETE (Fenster: 1,672 references across 130+ files, 3-PR plan)\r\n- #76 architecture ✅ COMPLETE (Verbal: 108KB → \u003c30KB split, lib/ design)\r\n\r\n**Blog post #1** (Feb 20-21): v0.5.0 kickoff — insider program opens NOW\r\n\r\n### Week 2 (Feb 24 - Mar 2): Implementation Wave 1\r\n- #86 fix implementation (Verbal: prompt updates, Hockney: test scenarios) — 6h\r\n- #69 PR #1: CLI foundation + migration command — 8h\r\n- #76 PR #1: File extraction to .ai-team/lib/ — 6h\r\n- Recruit beta cohort (5-10 users via insider channel)\r\n- **Blog post #2** (Feb 27-28): Under the hood — single .squad/ folder, lib/ split\r\n\r\n### Week 3 (Mar 3-9): Implementation Wave 2 + Beta Testing\r\n- #69 PR #2: Documentation mass update (~120 files) — 5h\r\n- #69 PR #3: Workflows dual-path detection — 6h\r\n- #76 PR #2: Validation testing — 6h\r\n- Beta testing with 7 exit criteria validation\r\n- Bug fixing including #86 validation\r\n- Continuous insider builds\r\n- **Blog post #3** (Mar 6-7): Insider testing signals\r\n\r\n### Week 4 (Mar 10-16): Final Wave + Release\r\n- #71, #84, #62 completion (cleanup work)\r\n- Final validation (all 7 criteria + #86)\r\n- Beta graduation\r\n- Release v0.5.0 (March 16)\r\n- **Blog post #4** (March 16): v0.5.0 ships\r\n\r\n## Success Criteria\r\n\r\n- [ ] All 6 MUST ship issues resolved\r\n- [ ] All 7 beta exit criteria met\r\n- [ ] #86 fix validated (no regression)\r\n- [ ] Migration tested on 5+ real repos\r\n- [ ] Blog posts completed (4 total)\r\n- [ ] Insider Program launched Week 1\r\n- [ ] Documentation complete (migration guide, insider setup)\r\n\r\n## Week 1 Day 2 Progress (Feb 18)\r\n\r\n**Completed:**\r\n- ✅ #86 investigation (Fenster: reproduced, prompt-only fix, 3-4h estimate)\r\n- ✅ #69 audit (Fenster: 1,672 refs → 3 atomic PRs over 2 weeks)\r\n- ✅ #76 architecture (Verbal: 108KB → lib/ split, 12-16h estimate)\r\n- ✅ PR #57 review (Keaton: community contribution, defer to Week 2)\r\n\r\n**In Progress:**\r\n- 🔄 Insider Program setup (PRIMARY Week 1 task — NOT STARTED YET)\r\n- 🔄 Blog post #1 drafting (McManus — DUE FEB 20-21, 2 days away)\r\n\r\n**Next:**\r\n- Route Insider Program setup to Kobayashi (CI/CD + branch automation)\r\n- Route blog post #1 to McManus (insider program launch announcement)\r\n\r\n## Communications\r\n\r\n- **Insider Program:** Binary model (insider or release), launches Week 1 for incremental testing\r\n- **Migration:** Single `.squad/` folder, mandatory but supported, backward compat until v1.0.0\r\n- **#86 fix:** Trust signal — Squad protects your work (prompt-only, 3-4h, ships v0.5.0)\r\n- **Last breaking change:** v1.0.0 will be polish, not breaking\r\n\r\n---\r\n\r\n**Note:** This is the last breaking change before v1.0.0. Post-v0.5.0 releases focus on stability, polish, and feature additions without migration pain.\r\n","author":{"url":"https://github.com/bradygaster","@type":"Person","name":"bradygaster"},"datePublished":"2026-02-17T01:20:16Z","url":"https://github.com/github/squad/issues/91"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:2f35a85a-49ef-9f75-fbfb-6a58bec2e7ac |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | A2BC:63A36:21B48:2BE88:6B015953 |
| html-safe-nonce | 472bbc3454be6f194b394f0bb9d3b454fc129aa513ebffd4213fa2c9fddedbfd |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBMkJDOjYzQTM2OjIxQjQ4OjJCRTg4OjZCMDE1OTUzIiwidmlzaXRvcl9pZCI6IjYzNDA5MzcyNDE5NzU2NzUyMTkiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | bf64804f61b17f5a44506198ecb75534501f7d00cec39b3ce29abcc8cf25e47b |
| hovercard-subject-tag | issue:3950245902 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/github/squad/91/issue_layout |
| twitter:image | https://opengraph.githubassets.com/e0d0d3f94eb0471d674a0c07b0703eda1f3092d7472ce82b780b46785a76d18a/github/squad/issues/91 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/e0d0d3f94eb0471d674a0c07b0703eda1f3092d7472ce82b780b46785a76d18a/github/squad/issues/91 |
| og:image:alt | v0.5.0 — Last Breaking Change Before v1.0 Timeline: Feb 17 - Mar 16, 2026 (4 weeks) Release Date: March 16, 2026 Status: In Progress (Week 1 Day 2) Breaking Change Primary: Consolidate to single .s... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | bradygaster |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/github/squad git https://github.com/github/squad.git |
| octolytics-dimension-user_id | 9919 |
| octolytics-dimension-user_login | github |
| octolytics-dimension-repository_id | 1151205052 |
| octolytics-dimension-repository_nwo | github/squad |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1151205052 |
| octolytics-dimension-repository_network_root_nwo | github/squad |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width