Skip to content

fix(templates): install to .squad/templates/ not .squad-templates/#185

Merged
bradygaster merged 1 commit intobradygaster:devfrom
williamhallatt:squad/fix-template-install-path
Mar 4, 2026
Merged

fix(templates): install to .squad/templates/ not .squad-templates/#185
bradygaster merged 1 commit intobradygaster:devfrom
williamhallatt:squad/fix-template-install-path

Conversation

@williamhallatt
Copy link
Copy Markdown
Contributor

What

index.js installs template files to .squad-templates/ at the repo root, but squad.agent.md references .squad/templates/ throughout. On a fresh install the coordinator prompt can never find its templates.

Why

PR #113 migrated all path references in squad.agent.md to .squad/templates/ but PR #111's code change (which renamed the dir to .squad-templates/) was never reconciled with it. Both landed in v0.5.0 and the mismatch has been live since.

Changes

  • Change install destination from .squad-templates.squad/templates
  • Update migrate-directory rename path to match
  • Update help text and replace-regex to reference .squad/templates
  • Add a v0.5.5 migration entry that moves .squad-templates/.squad/templates/ for existing users upgrading from ≤v0.5.4 (uses the existing safeRename helper)
  • Bump version to 0.5.5 so the migration runs on upgrade

Testing

All 95 existing tests pass. The 6 assertions in test/migrate-directory.test.js were updated to match the corrected path.

squad.agent.md references .squad/templates/ throughout, but index.js
was installing template files to .squad-templates/ at the repo root.
This mismatch meant the coordinator prompt could never find its
templates on a fresh install.

Root cause: PR bradygaster#113 migrated all path references in squad.agent.md to
.squad/templates/ but PR bradygaster#111's code change (which renamed the dir to
.squad-templates/) was never reconciled with it. Both landed in v0.5.0.

Fix:
- Change install destination from .squad-templates to .squad/templates
- Update migrate-directory rename to match the new path
- Update help text and replace-regex to reference .squad/templates
- Add a v0.5.5 migration entry that moves .squad-templates/ to
  .squad/templates/ for existing users upgrading from v0.5.4 or earlier

Bumps version to 0.5.5 so the migration runs on upgrade.
bradygaster added a commit that referenced this pull request Mar 4, 2026
…tes (#185, #188, #191, #192, #195, #196, #199, #201, #203, #206, #207)

Documentation Epic #182 — complete:

Docs Content (McManus):
- Architecture overview: SDK ↔ CLI ↔ SquadUI system design
- Migration guide: Beta → v1 with 10-step checklist
- Global CLI install guide: npm, npx, GitHub native
- VS Code integration guide: client compatibility, extension patterns
- SDK API reference: 574 lines, all 30+ exports documented

Docs Site Engine (Keaton):
- Static site generator: node docs/build.js → docs/dist/
- GitHub Pages ready, responsive design, sidebar nav
- Index landing page linking all guides

Mechanical Updates (Fenster):
- .ai-team/ → .squad/ across 25 doc files (#191)
- CLI invocation references verified current (#192)
- Beta repo URLs updated to squad-pr (#195)

Docs Tests (Hockney):
- 17 docs validation tests: headings, code blocks, links, build
- Fixed link checker for parent-dir refs, Windows rmSync

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@bradygaster
Copy link
Copy Markdown
Owner

Hey @williamhallatt — thank you so much for this contribution! 🙏 This is a great catch. The .squad-templates/ → .squad/templates/ path mismatch has been a silent bug since v0.5.0 and you tracked it down beautifully. The migration entry for existing users upgrading from ≤v0.5.4 is a really thoughtful touch — that's the kind of detail that saves people real headaches. Welcome to the Squad! ��

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants