4.2. Squad 만들기¶

템플릿을 선택하거나 에이전트를 직접 구성하여 Squad를 만들 수 있습니다. 네 단계 마법사가 기본 정보, 워크스페이스 선택, 에이전트 구성, 최종 검토를 안내합니다.

템플릿 사용하기¶

가장 빠른 시작 방법은 미리 만들어진 템플릿을 사용하는 것입니다. 사이드바에서 Squad 페이지를 열고 새 Squad를 클릭하면 템플릿 갤러리가 나타납니다.

템플릿	카테고리	에이전트	적합한 용도
Full-Stack Dev Team	개발	플래너, 프론트엔드 개발자, 백엔드 개발자, 코드 리뷰어	계획과 리뷰가 포함된 소프트웨어 개발
Content Team	콘텐츠	플래너, 작가, 편집자, 번역가	글 작성, 편집, 번역
Research Team	리서치	플래너, 연구원, 분석가, 요약 작성자	분석과 종합이 포함된 심층 리서치
Code Review Team	리뷰	플래너, 보안 리뷰어, 성능 리뷰어, 스타일 리뷰어	다양한 관점의 종합 코드 리뷰
Documentation Team	콘텐츠	플래너, API 문서 작성자, 튜토리얼 작성자, 다이어그램 작성자	다양한 형식의 기술 문서

템플릿 카드를 클릭하면 Squad를 만들기 전에 에이전트와 구성을 미리 볼 수 있습니다.

모든 Squad를 재사용 가능한 템플릿으로 저장할 수 있습니다. Squad의 구성을 세밀하게 조정한 후 템플릿으로 저장 작업을 사용하면 향후 사용을 위해 갤러리에서 사용할 수 있게 됩니다.

Squad의 이름과 선택적 설명을 입력합니다. 팀의 목적을 식별할 수 있는 명확한 이름을 선택하세요 (예: "인증 모듈 팀", "블로그 콘텐츠 팀").

Squad가 파일을 저장할 워크스페이스 디렉터리를 선택합니다. 마법사가 다음을 검증합니다:

워크스페이스는 플랜, 태스크, 에이전트 파일, 메타데이터를 위한 하위 디렉터리로 구성됩니다.

워크스페이스 위치

예상 출력에 충분한 디스크 공간이 있는 위치를 선택하세요. 각 Squad의 워크스페이스는 독립적이며 별도로 백업하거나 버전 관리할 수 있습니다.

Squad의 에이전트를 구성합니다. 다음 방법을 사용할 수 있습니다:

각 에이전트에 대해 다음을 구성합니다:

설정	설명
이름	에이전트의 표시 이름
역할	플래너, 개발자, 리뷰어, 작가, 또는 커스텀
시스템 프롬프트	에이전트의 동작과 전문성을 정의하는 지침
도구	에이전트가 사용할 수 있는 도구 (파일 읽기/쓰기, 메모리, 검색 등)
메모리	에이전트에게 영구 메모리 파일을 부여하려면 활성화

플래너 — 팀을 조율합니다. 요청을 분석하고, 플랜을 만들고, 태스크를 할당하고, 진행 상황을 추적합니다. Squad당 정확히 한 명의 플래너를 지정하세요.
개발자 — 코드를 작성하고 수정합니다. 프로젝트 파일을 읽고 쓰기 위한 파일 시스템 도구에 접근할 수 있습니다.
리뷰어 — 품질, 보안, 정확성을 위해 출력을 검토합니다. 일반적으로 읽기 전용 접근 권한을 가집니다.
작가 — 문서, 글, 기타 서면 콘텐츠를 작성합니다.
커스텀 — 미리 정의된 카테고리에 맞지 않는 역할을 정의합니다. 커스텀 역할 이름을 입력하고 시스템 프롬프트를 조정하세요.

전체 Squad 구성을 검토합니다:

만들기를 클릭하면 완료됩니다. 워크스페이스 디렉터리가 자동으로 생성되고 초기화됩니다.

Squad를 열고 구성을 수정합니다 — 이름 변경, 에이전트 추가 또는 제거, 시스템 프롬프트 변경, 도구 접근 권한 조정. 변경 사항은 다음 실행부터 적용됩니다.

Squad를 삭제할 때 다음을 선택할 수 있습니다:

워크스페이스를 유지한 경우, 워크스페이스에서 복원을 사용하여 나중에 Squad를 복원할 수 있습니다. 이 기능은 워크스페이스 디렉터리의 .squad-config.json 매니페스트를 읽어 Squad 항목을 다시 생성합니다.