bradygaster/squad

Squad – 인간이 지휘하는 AI 개발 팀 (알파 버전)

무엇인가요 – Squad는 단일 개발자가 Git 리포지토리 내부에 AI 에이전트 팀 (프론트엔드, 백엔드, 테스터, 리드 등)을 생성하고 관리할 수 있는 생산성 도구입니다. 에이전트는 GitHub Copilot로 구동되며 CLI (@bradygaster/squad-cli)를 통해 조율됩니다. 팀은 .squad/ 폴더 아래의 마크다운 파일로 지속되며, 축적된 '지식'이 코드와 함께 이동합니다.

핵심 개념

• 팀 정의 – squad init은 team.md, routing.md, decisions.md, 그리고 각 에이전트 폴더에 챠터와 이력이 포함된 .squad/ 디렉터리를 생성합니다.
• 인간 중심의 제어 – 인간이 최종 결정권을 가지며, 에이전트는 협업 자동화, 반복적인 코드 작성, 트리아주, 테스트만을 담당합니다. 모든 작업은 로그에 기록되어 검토 가능합니다.
• 워치 모드 (Ralph) – 선택적 데몬이 GitHub 이슈/PR을 주기적으로 확인하고 자동으로 트리아주하며, 필요 시 Copilot 에이전트를 자동으로 생성하여 문제를 처리합니다. 구성 가능한 상태 백엔드 (메모리, git-notes, 오리phan 브랜치)와 계층적 오류 복구 전략을 지원합니다.
• CLI 명령어 – 17개의 주요 명령어 (init, upgrade, triage, copilot, nap, aspire 등)는 설정, 업그레이드, 헬스 체크, 상태 외부화, 스쿼드 내보내기/가져오기, 플러그인/마켓플레이스 관리 등을 커버합니다.
• SDK 우선 모드 – 기본 마크다운 기반 구성 외에도, 개발자는 @bradygaster/squad-sdk를 사용해 TypeScript (squad.config.ts)로 스쿼드를 정의할 수 있으며, squad build로 마크다운 파일을 생성할 수 있습니다.
• GitHub Agentic Workflows – Squad는 재사용 가능한 GitHub Agentic Workflow로 설치 가능하며, 이슈 커멘트에서 슬래시 명령어로 제어할 수 있습니다.

일반적인 워크플로우

1. mkdir my-project && git init
2. npm install -g @bradygaster/squad-cli && squad init
3. gh auth login으로 인증
4. VS Code에서 Copilot Chat을 열고 Squad 에이전트를 선택하거나 copilot --agent squad --yolo를 실행합니다.
5. 프로젝트 설명 (예: "React와 Node로 구성된 레시피 공유 앱")
6. Squad가 에이전트 목록을 제안; yes로 확인
7. 에이전트들이 병렬로 작업 시작 — 프론트엔드는 UI 구축, 백엔드는 API 생성, 테스터는 테스트 작성 등 — 인간은 PR을 검토하고 결정을 승인합니다.

설치 방법

• CLI (전역): npm install -g @bradygaster/squad-cli
• 소스에서：리포지토리 복제 후 npm install (워크스페이스), npm run build, 이후 npm run dev:link로 개발 버전을 전역으로 링크합니다.
• .NET 프리뷰: Microsoft Agent Framework 통합을 위한 NuGet 패키지 Squad.Agents.AI는 src/Squad.Agents.AI에 제공됩니다.

상태 – 알파 버전 (README에 배지 표시). API 및 CLI 플래그는 변경될 예정이며, 주요 변경 사항은 CHANGELOG.md에 기록됩니다.

누가 사용할 수 있나요

• 감시를 잃지 않고 AI 지원 병렬 작업을 원하는 단독 개발자.
• 리포지토리 내에 "AI 강화" 워크플로우를 프로토타이핑하고자 하는 소규모 팀.
• 에이전트 오케스트레이션, GitHub Copilot, 자동 트리아주를 실험하는 연구자 또는 애호가.

더 알아보기

• 전체 명령어 참조는 README에 있음 (각 명령어와 플래그에 대한 테이블).
• SDK 문서 (docs/src/content/docs/reference/sdk.md).
• 샘플 프로젝트 (samples/README.md).
• GitHub Agentic Workflows 가이드 (README 내 링크).

---

위 모든 세부 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.