msitarzewski/agency-agents는 서로 다른 성격, 프로세스, 결과물을 가진 전문화된 AI 에이전트 역할들의 MIT 라이선스 컬렉션입니다. 이 저장소는 프론트엔드 전문가(frontend specialist), 제품 관리자(product manager), 마케팅 전문가(marketing expert)와 같이 이름이 붙여진 역할이 이해하기 쉽다는 점 때문에 인기가 있습니다.

하지만 설득력 있는 페르소나(persona)만으로는 작업이 역할 간에 이동할 때 어떤 권한(authority)이 변경되었는지 검토자에게 알려주지 못합니다.

UI에는 인수인계 카드(handoff card)가 필요합니다.

인수인계 모델 (Handoff model)

요청 (Request)
  -> 역할 선택 (Role selected)
  -> 증거 수집 (Evidence gathered)
...

모든 전환(transition)은 가시적으로 유지되어야 합니다. 하나의 채팅 아바타를 다른 것으로 교체하는 것만으로는 충분하지 않습니다.

카드 (The card)

인수인계 카드는 다음 질문에 답할 수 있어야 합니다:

1. 누구로부터? (From whom?): 작업을 생성한 역할.
2. 누구에게? (To whom?): 다음 역할 또는 인간 소유자.
3. 왜 지금인가? (Why now?): 인수인계를 트리거한 조건.
4. 어떤 증거가 있는가? (What evidence?): 파일, 출처, 테스트 및 해결되지 않은 가정(unresolved assumptions).
5. 어떤 권한인가? (What authority?): 읽기(Read), 제안(propose), 승인(approve) 또는 실행(execute).
6. 무엇이 만료되는가? (What expires?): 승인을 무효화하는 시간, 수정(revision) 또는 변경된 계획.

예시:

from: frontend-specialist
to: accessibility-reviewer
reason: interaction implementation complete
...

복구 상태 (Recovery states)

검토자는 이전의 증거를 잃지 않고 인수인계를 거부(reject)할 수 있어야 합니다. 거부 시에는 이유를 요구해야 하며 소유권을 이전 역할로 되돌려야 합니다. 근본적인 수정 사항이 변경되는 경우, 조용히 새로고침하는 대신 오래된 인수인계를 'stale(신선하지 않은)' 상태로 표시해야 합니다.

연구 프로토콜 (Research protocol)

5명의 참가자에게 동일한 다중 역할 작업(multi-role task)을 부여하고, 인수인계를 승인하기 전에 다음 도구의 효과를 예측하도록 요청합니다. 측정 항목은 다음과 같습니다:

• 현재 역할을 식별하는지 여부
• 해결되지 않은 가정을 찾아내는지 여부
• 검토(review)와 실행(execution)을 구분하는지 여부
• 오래된(stale) 인수인계를 거부하는 데 걸리는 시간
• 단순한 자신감이 아닌, 자신감에 뒤따르는 정확한 예측 여부

참여자가 상태를 변경(mutate)할 수 있는 동작임에도 불구하고 읽기 전용(read-only)이라고 믿고 승인한다면 세션을 중단하십시오. 이는 사용자 오류가 아니라 설계상의 안전 실패(design safety failure)입니다.

접근성 (Accessibility)

인수인계 이력(handoff history)에는 의미론적 순서가 있는 목록(semantic ordered list), 명확한 헤딩(headings), 키보드로 조작 가능한 승인/거절(approve/reject) 컨트롤, 그리고 에이전트의 색상이나 아바타에 의존하지 않는 상태 텍스트가 필요합니다. 모든 중간 사고 과정을 스트리밍하지 말고 중요한 상태 변화를 공지하십시오.

한계점 (Limitations)

이것은 제안된 인터페이스이자 연구 프로토콜입니다. 저는 해당 리포지토리(repository)의 사용자 인터페이스를 평가하거나 이러한 페르소나(personas)를 참여자들과 테스트하지 않았습니다. 실제 설치 및 역할 정의는 현재의 README를 확인하십시오.

전문화(Specialization)는 책임이 깔끔하게 이동할 때 유용해집니다. 페르소나는 스타일을 설명하지만, 인수인계 카드(handoff card)는 책임 소재(accountability)를 설명합니다.