하네스엔지니어링(revfactory)-2

1. 에이전트 .claude/agents/{name}.md 작성 요령

• 구성: 프론트매터(5 필드) + 본문(7 섹션)

1. 본문

1. 본문(1) - 핵심역할
   • 하는일을 1~3개로 명시한다. 동시에 하지 않는 일을 정의하여, 역할을 나눈다.
   • 명확히 작성해야할 내용:
   1. 무엇을 하는가?
   2. 무엇을 다루는가?
2. 본문(2) - 작업원칙
   • 에이전트가 선택할수 있는 후보들을 명시한다.
   • 명확히 작성해야할 내용:
   1. 에이전트가 두가지 선택지 중 한가지를 선택할수 있어야함.
   2. 규칙의 이유가 담겨야함.
   3. 이 에이전트만의 특성이 담겨야함(아직 와닿지 않는 내용).
3. 본문(3) - 입출력 프로토콜
   • 에이전트간의 협업을 위해, 소통창구(파일)를 명시한다.
   • 명확히 작성해야할 내용:
   1. 입력: {파일경로/사용자 프롬프트}
   2. 출력: {파일경로}
   3. 형식: {반환값의 포맷}
4. 본문(4) - 팀 통신 프로토콜
   • SendMessage 도구로 주고받을 정보의 세 요소(누구에게/무엇을/언제)를 명시한다.
   • 명확히 작성해야할 내용:
   1. 메시지를 받을 에이전트에게 전달할 내용(현재 에이전트가 발견한 사실)
   2. 메시지를 받을 에이전트에게 요구하는 내용(호출된 에이전트가 취하길 기대하는 동작/요청)
5. 본문(5) - 에러 핸들링
   • 에이전트의 종료조건을 명시한다.
   • 명확히 작성해야할 내용:
   1. 구체적인 실패 시나리오
   2. 각 (성공/실패)시나리오에서 취해야할 행동
   3. 최대 재시도 횟수
6. 본문(6) - 협업
   • 에이전트의 호출관계를 명시한다.
   • 명확히 작성해야할 내용:
   1. 상류: {이 에이전트를 호출하는 에이전트/스킬}
   2. 하류: {이 에이전트의 산출물을 읽는 에이전트}
   3. 재호출: {다른 에이전트/스킬에 의한 재호출 조건, 횟수}
7. 본문(7) - 자체검증
   • 에이전트가 산출물을 반환하기 전, 스스로 거치는 체크리스트
   • 명확히 작성해야할 내용:
   1. {체크리스트 내용}