Hermes profile은 역할 이름이 아니라 격리 경계입니다. 각 profile은 설정, 세션, Memory, Skills, 자격 증명을 따로 가집니다. 전문 agent 팀이 제대로 작동하려면 이 경계가 실제 책임과 맞아야 합니다. orchestrator도 명확한 description을 보고 일을 배분할 수 있어야 합니다.
- 전문 역할마다 별도 profile home을 둡니다.
- 막연한 persona 대신 결과와 제한을 description에 적습니다.
- 역할에 필요한 Skills와 도구 그룹만 배정합니다.
- 상태 복제 범위를 신중히 고릅니다.
--clone-all은 대다수 팀 구성에 필요한 범위보다 넓습니다.
1. 책임부터 나누기
fixture는 조사자, 코드 검증자, 한국어 작성자, 영어 작성자, 검토자, orchestrator의 여섯 역할을 정의합니다. 최종 프로젝트의 handoff를 기준으로 나눈 구조입니다. 조사는 근거 있는 claim을 만듭니다. 검증은 관찰한 출력을 남깁니다. 작성자는 두 입력을 사용합니다. 검토자는 parity를 확인하고 orchestrator는 작업을 전달합니다.
Hermes Kanban은 worker를 고를 때 profile description을 사용할 수 있습니다. 그래서 description이 중요합니다. “도움이 되는 writer”는 정보가 부족합니다. “사실을 바꾸지 않고 영어 기술 글을 현지화한다”는 문장은 router와 reviewer 모두에게 쓸 만한 경계를 줍니다.
2. 명세 검사하기
team.json에는 역할 이름, 논리적 home, description, Skills, 도구 그룹이 들어 있습니다. 실제 profile을 만들기 전에 읽기 전용 검사기를 실행합니다.
python3 examples/chapter-06-specialist-profiles/check_profiles.py
python3 -m unittest discover -s examples/chapter-06-specialist-profiles/tests -v검사기는 정해진 순서의 여섯 역할과 역할마다 다른 home을 요구합니다. 변조 테스트는 역할 하나를 지웁니다. home을 재사용하거나 secret처럼 보이는 필드를 추가하기도 합니다.
PASS: 6 specialist profiles have unique homes and explicit responsibilities3. profile 하나부터 만들기
팀 전체를 한꺼번에 만들기 전에 가장 작은 단위를 확인합니다.
hermes profile create researcher --description "Finds primary sources and records supported claims."
hermes profile show researcher
hermes profile listprofile show로 새 격리 경계를 살펴볼 수 있습니다. 구성이 맞다면 team.json의 다른 description으로 create 명령을 반복하세요. profile 이름은 소문자 영숫자를 사용하며 fixture는 하이픈도 허용합니다.
4. 복제 범위 고르기
기본 create는 독립된 시작점을 만듭니다. --clone은 원본 profile에서 일부 설정, secret, SOUL.md, Skills를 복사합니다. --clone-all은 훨씬 많은 상태를 복사합니다. 넓은 복제는 writer와 reviewer를 나눈 이유를 약하게 만들 수 있습니다.
모델 선택은 공유하더라도 도구와 Skills는 다르게 둘 수 있습니다. 각 역할의 profile context에서 설정하세요. 언젠가 필요할 것 같다는 이유만으로 자격 증명을 복사하지 마세요.
5. 격리와 routing 정보 확인하기
profile마다 hermes profile show <name>을 실행하고 승인한 명세와 비교합니다. description, 활성 home, 사용할 Skills와 도구를 확인하세요. 파일 명세만으로 실제 Hermes 상태가 같다고 증명할 수는 없습니다. 생성 뒤 readback이 필요한 이유입니다.
fixture는 실제 생성 직전에 멈춥니다. 팀 설계가 완전합니다. scope는 겹치지 않으며 credential 필드도 없습니다. 이 세 가지만 보장합니다. 독자의 컴퓨터에 여섯 profile이 존재한다고 주장하지 않습니다.
답글 남기기