4.3. 계획 수립 & 실행¶

Squad에 요청을 제출하면 플래너 에이전트가 구조화된 플랜을 생성하고, 사용자가 검토 및 승인한 후, 의존성을 고려한 웨이브 단위로 태스크를 실행합니다.

요청 제출¶

Squad 모니터링 대시보드를 열고 입력 필드에 요청을 입력합니다. 달성하고자 하는 바를 자연어로 설명하세요:

"CRUD 엔드포인트, 입력 유효성 검사, 단위 테스트가 포함된 사용자 관리 REST API를 구축하세요."

플래너가 수동 검토 없이 좋은 플랜을 만들 것이라고 신뢰하는 경우 선택적으로 자동 승인을 토글할 수 있습니다.

계획 수립 단계¶

플래너 에이전트가 요청을 받아 다음을 포함하는 플랜을 생성합니다:

• 제목 — 계획된 작업의 간결한 요약
• 태스크 — 각각 다음을 포함하는 개별 작업 단위:
  • 제목과 설명
  • 할당된 에이전트
  • 다른 태스크에 대한 의존성
  • 우선순위 수준 (낮음, 보통, 높음, 긴급)

graph LR
    T1[API 스키마 설계] --> T2[엔드포인트 구현]
    T1 --> T3[유효성 검사 작성]
    T2 --> T4[단위 테스트 작성]
    T3 --> T4
    T4 --> T5[코드 리뷰]

플랜 승인¶

자동 승인이 활성화되지 않은 경우, 플랜 승인 대화 상자에서 플랜이 검토용으로 제시됩니다. 확인할 수 있는 항목:

• 설명이 포함된 전체 태스크 목록
• 에이전트 할당
• 의존성 그래프
• 예상 복잡도

승인을 클릭하면 실행이 시작되고, 거부를 클릭하면 플랜이 폐기됩니다. 선택적으로 플래너가 다시 시도할 수 있도록 피드백을 제공할 수 있습니다.

웨이브 실행¶

승인되면 태스크는 의존성에 따라 웨이브로 구성됩니다:

gantt
    title 실행 웨이브
    dateFormat X
    axisFormat %s

    section 웨이브 1
    API 스키마 설계        :0, 1
    section 웨이브 2
    엔드포인트 구현        :1, 2
    유효성 검사 작성       :1, 2
    section 웨이브 3
    단위 테스트 작성       :2, 3
    section 웨이브 4
    코드 리뷰             :3, 4

• 같은 웨이브 내 태스크는 병렬로 실행됩니다
• 다음 웨이브는 이전 웨이브의 모든 태스크가 완료된 후에만 시작됩니다
• 태스크가 실패하면 이후 웨이브의 의존 태스크는 자동으로 건너뜁니다

실행 라이프사이클¶

진행 상황 모니터링¶

Squad 모니터링 대시보드에서 실시간 실행 진행 상황을 보여줍니다:

• 현재 웨이브와 전체 웨이브 수
• 태스크 수 — 대기, 실행 중, 완료, 실패, 건너뜀
• 에이전트별 상태 — 활성, 유휴, 또는 오류 상태인 에이전트
• 토큰 사용량 — 에이전트별 및 전체 실시간 소비량
• 활동 피드 — 이벤트의 시간순 로그 (에이전트 시작, 태스크 완료, 메모리 업데이트 등)
• 실시간 작업 요약 티커 — 채팅 영역 하단의 소형 바에 계획 수립 및 실행 단계 동안 플래너 또는 활성 에이전트가 현재 수행 중인 작업의 한 줄 요약이 지속적으로 업데이트됩니다. × 버튼을 클릭하여 닫을 수 있습니다.

실행 취소¶

언제든 취소를 클릭하여 현재 실행을 중단할 수 있습니다. 실행 중인 태스크는 종료되고 대기 중인 태스크는 취소됨으로 표시됩니다. 완료된 태스크 결과는 보존됩니다.

에이전트 채팅 세션¶

에이전트 채팅을 통해 개별 에이전트와 직접 상호작용할 수도 있습니다:

• Squad 내 모든 에이전트와 채팅 세션을 시작할 수 있습니다
• 메시지가 실시간으로 스트리밍됩니다
• 대화가 워크스페이스에 저장됩니다
• 세션별 토큰 사용량이 추적됩니다

이 기능은 임시 질문, 에이전트 동작 디버깅, 또는 정상적인 계획 수립 흐름 외부에서 추가 컨텍스트를 제공하는 데 유용합니다.