github/squad

어떤 프로젝트인가요?

핵심 기능

• 01역할과 역할 헌장을 저장소의 파일로 관리하는 지속형 AI 팀을 구성합니다.
• 02역할에 따라 작업을 배정하는 코디네이터 아래에서 여러 에이전트를 병렬로 실행합니다.
• 03결정 사항과 에이전트별 기록을 남겨 세션이 바뀌어도 지식을 이어갑니다.
• 04watch 모드로 GitHub 이슈를 주기적으로 확인하고 분류하며 Copilot 에이전트에 작업을 맡길 수 있습니다.
• 05같은 팀을 Claude Code, Kiro, OpenCode, Cursor, Codex, Antigravity에서도 사용할 수 있습니다.
• 06코드로 팀을 정의할 수 있는 TypeScript SDK를 제공합니다.

활용 사례

• 새 프로젝트를 시작하면서 AI 팀에 역할을 제안하고 초기 작업을 나누도록 하는 경우.
• 각 단계에서 사람이 검토하며 GitHub 이슈 백로그를 분류하고 처리하는 경우.
• 저장소를 클론하는 모든 사람과 일관된 AI 팀 구성을 공유하는 경우.
• Squad 팀을 프로그래밍 방식으로 호출하는 .NET 또는 TypeScript 애플리케이션을 만드는 경우.

빠른 시작

1. 1

   프로젝트 폴더를 만들고 이동합니다

   mkdir my-project && cd my-project
2. 2

   npm으로 Squad CLI를 설치합니다(Node.js 22.5 이상 필요)

   npm install -g @bradygaster/squad-cli
3. 3

   프로젝트에서 Squad를 초기화합니다

   squad init
4. 4

   Squad 에이전트로 Copilot을 열고 팀을 설정합니다

   copilot --agent squad --yolo

사용 전 알아둘 점

• !에이전트 팀을 실행하려면 GitHub Copilot이 필요합니다.
• !npm으로 설치하려면 Node.js 22.5 이상이 필요합니다. 또는 플랫폼 설치 프로그램을 사용하세요.
• !버전 간 호환성을 깨는 변경 사항은 CHANGELOG에 문서화되어 있으므로 업그레이드하기 전에 확인하세요.

포함된 컬렉션

토픽

자주 묻는 질문

squad은(는) 무엇인가요?

저장소에 파일로 구성된 사람 주도형 AI 에이전트 팀으로, GitHub Copilot 등 AI 호스트를 활용해 코드 작성과 협업을 지원합니다. Squad는 소프트웨어 프로젝트에 AI 에이전트 팀을 구성하는 CLI이자 SDK입니다. 만들려는 것을 설명하면 Squad가 리드, 프론트엔드, 백엔드, 테스터 같은 전문 역할을 제안합니다. 각 구성원은 저장소의 .squad/ 폴더에 있는 마크다운 파일로 정의되므로, 팀의 역할 헌장, 라우팅 규칙, 결정 사항, 에이전트별 기록이 코드와 함께 버전 관리되고 저장소를 클론하는 누구와도 공유됩니다.

squad은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

squad은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

squad은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. squad의 마지막 커밋은 2026년 11월 6일입니다.

squad은(는) 어디에 사용할 수 있나요?

새 프로젝트를 시작하면서 AI 팀에 역할을 제안하고 초기 작업을 나누도록 하는 경우. 각 단계에서 사람이 검토하며 GitHub 이슈 백로그를 분류하고 처리하는 경우. 저장소를 클론하는 모든 사람과 일관된 AI 팀 구성을 공유하는 경우. Squad 팀을 프로그래밍 방식으로 호출하는 .NET 또는 TypeScript 애플리케이션을 만드는 경우.

squad는 어떻게 설치하나요?

프로젝트 폴더를 만들고 이동합니다: mkdir my-project && cd my-project npm으로 Squad CLI를 설치합니다(Node.js 22.5 이상 필요): npm install -g @bradygaster/squad-cli 프로젝트에서 Squad를 초기화합니다: squad init Squad 에이전트로 Copilot을 열고 팀을 설정합니다: copilot --agent squad --yolo

squad은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/github/squad