Title: Source repo squad team is stale — missing icons, outdated templates, UX drift from fresh init · Issue #67 · github/squad · GitHub
Open Graph Title: Source repo squad team is stale — missing icons, outdated templates, UX drift from fresh init · Issue #67 · github/squad
X Title: Source repo squad team is stale — missing icons, outdated templates, UX drift from fresh init · Issue #67 · github/squad
Description: Problem The "squad squad" (the team in this repo's .ai-team/) was hand-created early in development and hasn't been refreshed as the product's templates evolved. This means the team building Squad has a worse experience than new users ru...
Open Graph Description: Problem The "squad squad" (the team in this repo's .ai-team/) was hand-created early in development and hasn't been refreshed as the product's templates evolved. This means the team building Squad ...
X Description: Problem The "squad squad" (the team in this repo's .ai-team/) was hand-created early in development and hasn't been refreshed as the product's templates evolved. This means th...
Opengraph URL: https://github.com/github/squad/issues/67
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Source repo squad team is stale — missing icons, outdated templates, UX drift from fresh init","articleBody":"## Problem\n\nThe \"squad squad\" (the team in this repo's `.ai-team/`) was hand-created early in development and hasn't been refreshed as the product's templates evolved. This means the team building Squad has a **worse experience** than new users running `squad init` for the first time.\n\n### Specific drift observed:\n\n**team.md:**\n- Members use Wikipedia links instead of role emoji icons (🏗️, ⚛️, 🔧, etc.)\n- @copilot capabilities section is less detailed than the current `templates/roster.md`\n- Coordinator name is \"Copilot\" not \"Squad\" (template uses \"Squad\")\n\n**Charters:**\n- Existing charters were hand-written before the `templates/charter.md` template was finalized\n- Missing some standard sections or have inconsistent formatting vs current template\n\n**General:**\n- Any new template improvements (ceremonies, routing, skills) may not have propagated back to source\n- This is a \"cobbler's children have no shoes\" problem — if source repo drifts, it's likely customer installs drift too after upgrades\n\n## Why this matters\n\n1. **Dogfooding gap** — Brady and the team aren't experiencing Squad the way users do\n2. **Customer risk** — if we don't notice drift in our own repo, we won't catch it for users upgrading from older versions\n3. **UX consistency** — role icons in the roster aren't just cosmetic, they help the coordinator identify agents at a glance\n\n## Proposed fix\n\nAdd an `upgrade --refresh-team` or equivalent mechanism that:\n1. Refreshes `team.md` formatting to match current `templates/roster.md` (icons, structure)\n2. Updates charter formatting to match `templates/charter.md` (without overwriting custom content like expertise, boundaries, voice)\n3. Validates `.ai-team/` structure matches current expectations\n4. Reports what was refreshed\n\nFor the source repo specifically, a one-time manual refresh may suffice — but the general mechanism benefits all users.\n\n## Acceptance Criteria\n\n- [ ] Source repo team.md has role emoji icons instead of Wikipedia links\n- [ ] @copilot capabilities match current template\n- [ ] Charters have all standard sections from template\n- [ ] Consider whether `upgrade` subcommand should auto-refresh team formatting","author":{"url":"https://github.com/bradygaster","@type":"Person","name":"bradygaster"},"datePublished":"2026-02-15T09:15:11Z","url":"https://github.com/github/squad/issues/67"}
| 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:d5c4025e-0539-a3f3-f3c1-9e2721cc88f3 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | DC00:19F84C:26E9678:317959A:6B018024 |
| html-safe-nonce | d74e7c36f5b62a3b10e1c112c565c8f1b6c22ac53a83862533dc67d01fbec842 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEQzAwOjE5Rjg0QzoyNkU5Njc4OjMxNzk1OUE6NkIwMTgwMjQiLCJ2aXNpdG9yX2lkIjoiNTgxMDI5ODkxMTYzNzczMzQxMyIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | da66e178630fea52efebf2c7197e77d6f8e4797664cd0b2eaee0b99aaee8c70e |
| hovercard-subject-tag | issue:3943593348 |
| 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/67/issue_layout |
| twitter:image | https://opengraph.githubassets.com/22120948cbf868e1100be60ff788a4b4be92eb82b2b7bfaa7577ccda08a391c3/github/squad/issues/67 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/22120948cbf868e1100be60ff788a4b4be92eb82b2b7bfaa7577ccda08a391c3/github/squad/issues/67 |
| og:image:alt | Problem The "squad squad" (the team in this repo's .ai-team/) was hand-created early in development and hasn't been refreshed as the product's templates evolved. This means the team building Squad ... |
| 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