Skip to content

docs: rename .ai-team/ references to .squad/ across docs and templates - #171

Closed
zeier wants to merge 1 commit into
github:devfrom
zeier:squad/docs-rename-ai-team-to-squad
Closed

zeier wants to merge 1 commit into
github:devfrom
zeier:squad/docs-rename-ai-team-to-squad

Conversation

@zeier

@zeier zeier commented Mar 2, 2026

Copy link
Copy Markdown

Summary

The v0.5.0 release renamed .ai-team/ to .squad/ and .ai-team-templates/ to .squad-templates/, but 21 documentation and template files still referenced the deprecated paths. This PR updates all remaining references to match the current implementation.

Changes

21 files updated (122 insertions, 122 deletions — clean 1:1 replacements):

Docs — Feature pages (5 files)

  • docs/features/ceremonies.md — ceremony config path
  • docs/features/directives.md — decisions inbox paths, decisions.md references
  • docs/features/copilot-coding-agent.md — git add command
  • docs/features/export-import.md — skills path, import directory, collision detection
  • docs/features/human-team-members.md — alumni path

Docs — Core guides (3 files)

  • docs/guide.md — 30 lines across setup, memory, skills, upgrades, ownership table
  • docs/insider-program.md — FAQ answers about state safety
  • docs/tips-and-tricks.md — decisions.md, history.md, git add commands

Docs — Scenarios (3 files)

  • docs/scenarios/disaster-recovery.md — 46 lines, all recovery procedures
  • docs/scenarios/client-compatibility.md — file access matrix entries
  • docs/scenarios/ci-cd-integration.md — routing, workflow template paths

Templates (9 files)

  • templates/scribe-charter.md — owned paths, git add, commit prefix docs(squad):
  • templates/charter.md — collaboration section paths
  • templates/roster.md — charter path references in roster table
  • templates/prd-intake.md — team.md, history, decisions paths
  • templates/ceremony-reference.md — ceremony config paths
  • templates/casting-reference.md — casting state paths
  • templates/issue-lifecycle.md — team.md storage path
  • templates/orchestration-log.md — log save path
  • templates/skills/squad-conventions/SKILL.md — file structure docs

Other (1 file)

  • .github/copilot-instructions.md — repo structure description

Intentionally NOT changed

  • Blog posts — historical narratives describing events at the time
  • CHANGELOG.md — historical release records
  • Migration guide (docs/migration/v0.5.0-squad-rename.md) — references both paths by design
  • Proposals and specs — point-in-time documents
  • README.md — already accurate
  • index.js and tests — intentional dual-path backward compatibility for --migrate-directory

Verification

  • Grep confirmed zero remaining .ai-team references in the 21 updated files
  • All replacements are mechanical 1:1 path substitutions with no behavioral changes
  • npm test — no test changes (tests intentionally reference both paths for migration testing)

The v0.5.0 release renamed .ai-team/ to .squad/ and .ai-team-templates/
to .squad-templates/, but 21 documentation and template files still
referenced the deprecated paths. This commit updates all remaining
references to match the current implementation.

Files updated:
- docs/guide.md, tips-and-tricks.md, insider-program.md
- docs/features/ (ceremonies, directives, copilot-coding-agent,
  export-import, human-team-members)
- docs/scenarios/ (disaster-recovery, client-compatibility,
  ci-cd-integration)
- .squad/templates/ (charter, roster, scribe-charter, prd-intake,
  ceremony-reference, casting-reference, issue-lifecycle,
  orchestration-log, skills/squad-conventions/SKILL.md)
- .github/copilot-instructions.md

Intentionally NOT changed:
- Blog posts (historical narratives)
- CHANGELOG.md (historical release records)
- Migration guide (references both paths by design)
- Proposals and specs (point-in-time documents)
- index.js and tests (dual-path backward compat)
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.

1 participant