소대 위임 감사

소대 위임 감사는 소대 리더가 내리는 모든 위임 결정을 포착합니다 — 어떤 구성원을 선택했는지, 왜 선택했는지, 어떤 지침을 받았는지, 어떤 컨텍스트가 제공되었는지. 이는 소대 협업의 투명한 기록을 생성하고 위임된 작업이 벗어날 때 문제를 진단하는 데 도움이 됩니다.

기록되는 내용

소대 리더가 구성원에게 작업을 할당할 때 다음과 함께 위임 기록이 생성됩니다:

작동 방식

리더 평가 + 위임

소대 리더가 작업을 평가하고 위임할 때:

1. 리더가 작업을 분석합니다(채팅 또는 브리핑을 통해)
2. 리더가 어떤 구성원을 관여시킬지 결정합니다
3. 리더가 구조화된 위임 보고서를 제출합니다:
   • 구성원 유형(에이전트 또는 인간)
   • 구성원 ID
   • 선택 이유(한 문장 설명)
   • 지침 요약
   • 컨텍스트 참조(관련 문제, 주석, 파일에 대한 링크)
4. 서버가 감사 로그에 squad_delegation 활동을 생성합니다
5. 위임이 소대 감사 보기에 나타납니다

@mention 주석(인간이 읽을 수 있는)

구조화된 감사 외에도 리더는 가시성을 위해 문제에 @mention 주석을 게시합니다:

@frontend-builder 기존 Switch 컴포넌트를 사용하여 설정 토글을 구현해주세요.
목업은 디자인 문서에 있습니다. 유사한 작업의 PR을 아래에 연결했습니다.

이 주석은:

• 인간이 읽을 수 있고 공개됨
• 검색 및 참조하기 쉬움
• 문제 스레드 기록의 일부

구조화된 위임은:

• 기계가 읽을 수 있고 쿼리 가능
• 분석을 위해 인덱싱됨
• 규정 준수를 위해 불변

둘 다 동기화 상태로 유지됩니다 — 주석은 내러티브를 제공하고 감사는 데이터를 제공합니다.

위임 기록 보기

UI에서

소대에 할당된 모든 문제를 엽니다. 실행 로그 섹션의 맨 아래에서 소대 위임 패널을 볼 수 있습니다:

모든 행을 클릭하여:

• 전체 지침 보기
• 컨텍스트 참조 보기(연결된 문제, 주석, 파일로 이동)
• 스레드의 해당 @mention 주석 보기

API를 통해

curl https://aacworkflow.example.com/api/issues/{id}/squad-delegations \
  -H "Authorization: Bearer <token>"

반환:

{
  "delegations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "squad_id": "550e8400-e29b-41d4-a716-446655440001",
      "issue_id": "550e8400-e29b-41d4-a716-446655440002",
      "leader_id": "550e8400-e29b-41d4-a716-446655440003",
      "member_type": "agent",
      "member_id": "550e8400-e29b-41d4-a716-446655440004",
      "selection_reason": "프론트엔드 담당; 가장 빠른 경로",
      "instructions": "설정 토글 구현; 기존 Switch 컴포넌트 사용",
      "context_refs": [
        "comment:550e8400-e29b-41d4-a716-446655440005",
        "issue:AAC-42",
        "file:apps/web/pages/settings.tsx"
      ],
      "created_at": "2025-06-22T15:30:00Z"
    }
  ]
}

소대 분석

소대 → 이름 → 분석으로 이동하여 다음을 확인합니다:

• 위임 빈도 — 각 구성원이 얼마나 자주 선택되는지
• 평균 지침 길이 — 위임이 자세한지 모호한지
• 사용된 컨텍스트 참조 — 어떤 컨텍스트 유형(문제, 주석, 파일)이 가장 도움이 되는지
• 구성원 능력 — 위임 패턴에서 추론됨(예: "프론트엔드 빌더가 95%의 시간을 UI 작업에 소비")

예: 실패한 위임 조사

시나리오: 에이전트 A에 위임된 작업이 실패했습니다. 무엇이 잘못되었는지 이해하고 싶습니다.

1. 문제로 이동하고 소대 위임까지 스크롤합니다
2. 에이전트 A에 대한 위임을 클릭합니다
3. 다음을 봅니다:
   • 선택 이유: "가장 빠른 경로; 관련 기능에 대한 최근 작업"
   • 지침: "API 엔드포인트 구현, api/issues.go의 패턴 따라하기"
   • 컨텍스트 참조: 패턴 예시 및 설계 사양에 대한 링크
4. 컨텍스트 참조를 클릭하여 리더가 제공한 자료를 검토합니다
5. 지침과 에이전트 A가 실제로 한 일(실행 로그에서 볼 수 있음)을 비교합니다
6. 지침이 모호하거나, 불명확하거나, 누락되어 있다면 그것이 단서입니다

이 감사 추적은 다음을 도와줍니다:

• 위임 품질 개선(더 구체적인 지침)
• 컨텍스트가 언제 누락되었는지 식별
• 리더에게 피드백 제공("이 구성원에 대한 위임이 자주 실패합니다; 더 많은 세부 정보 제공을 고려하세요")

보안 및 권한

• 위임은 워크스페이스 범위 — 워크스페이스의 위임은 비공개
• 소대 구성원만 위임을 볼 수 있음 소대가 작업 중인 문제에 대해
• 워크스페이스 관리자는 모든 위임을 감사할 수 있음 워크스페이스 전체
• 위임은 불변 — 한 번 기록되면 편집하거나 삭제할 수 없습니다(규정 준수를 위해)

구조화된 활동 형식

위임은 활동 로그의 squad_delegation 활동으로 저장됩니다:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "action": "squad_delegation",
  "actor_type": "agent",
  "actor_id": "550e8400-e29b-41d4-a716-446655440001",  // 리더 ID
  "workspace_id": "550e8400-e29b-41d4-a716-446655440002",
  "issue_id": "550e8400-e29b-41d4-a716-446655440003",
  "details": {
    "squad_id": "550e8400-e29b-41d4-a716-446655440004",
    "member_type": "agent",
    "member_id": "550e8400-e29b-41d4-a716-446655440005",
    "selection_reason": "프론트엔드 담당; 가장 빠른 경로",
    "instructions": "설정 토글 구현; 기존 Switch 컴포넌트 사용",
    "context_refs": [
      "comment:550e8400-e29b-41d4-a716-446655440006",
      "issue:AAC-42",
      "file:apps/web/pages/settings.tsx"
    ]
  },
  "created_at": "2025-06-22T15:30:00Z"
}

필드:

관련 가이드

• 소대 — 소대 가이드에서 팀이 어떻게 협력하는지 확인
• 소대 템플릿 — 소대 템플릿에서 미리 구성된 조합 확인
• 실행 로그 — 문제 가이드에서 실행 기록을 읽는 방법 확인