Skip to content

Source repo squad team is stale — missing icons, outdated templates, UX drift from fresh init #67

Closed

Description

@bradygaster

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 running squad init for the first time.

Specific drift observed:

team.md:

  • Members use Wikipedia links instead of role emoji icons (🏗️, ⚛️, 🔧, etc.)
  • @copilot capabilities section is less detailed than the current templates/roster.md
  • Coordinator name is "Copilot" not "Squad" (template uses "Squad")

Charters:

  • Existing charters were hand-written before the templates/charter.md template was finalized
  • Missing some standard sections or have inconsistent formatting vs current template

General:

  • Any new template improvements (ceremonies, routing, skills) may not have propagated back to source
  • This is a "cobbler's children have no shoes" problem — if source repo drifts, it's likely customer installs drift too after upgrades

Why this matters

  1. Dogfooding gap — Brady and the team aren't experiencing Squad the way users do
  2. Customer risk — if we don't notice drift in our own repo, we won't catch it for users upgrading from older versions
  3. UX consistency — role icons in the roster aren't just cosmetic, they help the coordinator identify agents at a glance

Proposed fix

Add an upgrade --refresh-team or equivalent mechanism that:

  1. Refreshes team.md formatting to match current templates/roster.md (icons, structure)
  2. Updates charter formatting to match templates/charter.md (without overwriting custom content like expertise, boundaries, voice)
  3. Validates .ai-team/ structure matches current expectations
  4. Reports what was refreshed

For the source repo specifically, a one-time manual refresh may suffice — but the general mechanism benefits all users.

Acceptance Criteria

  • Source repo team.md has role emoji icons instead of Wikipedia links
  • @copilot capabilities match current template
  • Charters have all standard sections from template
  • Consider whether upgrade subcommand should auto-refresh team formatting

Activity

  1. added this to the v0.4.1 milestone on Feb 15, 2026
  2. bradygaster commented on Feb 16, 2026

    @bradygaster
    CollaboratorAuthor

    ✅ Fixed via #68. Ran squad upgrade --self to refresh .ai-team/ from templates. Squad repo is now up-to-date.

  3. added a commit that references this issue on Mar 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingrelease:v0.4.1Targeted for v0.4.1

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions