마지막 업데이트 2026-07-22
이 문서는 Hermes 에이전트에게 복잡한 이슈 분석, 코드 수정, 검증까지 한 번에 맡기기 위한 실전용 지시 템플릿입니다. 핵심은 “무엇이 문제인지”보다 “무엇이 완료 상태인지”를 정확히 전달하는 것입니다.
즉, Hermes가 스스로 탐색하고 진행할 수 있도록 목표와 완료 조건을 분명하게 주는 방식입니다.
무엇을 해결해야 하는지 한 문장으로 적습니다.
어떤 상태가 되면 끝인지 명시합니다.
수정 범위, 금지 사항, 우선순위를 적습니다.
typecheck, lint, 테스트, 브라우저 확인 등 확인 기준을 적습니다.
목표: [해결하고 싶은 문제 또는 만들고 싶은 기능]
완료 조건: [이 상태가 되면 작업 종료]
제약: [수정 범위, 위험한 변경 금지, 성능/안전 조건]
검증: [typecheck, lint, 테스트, 브라우저 확인, 로그 확인]
이 목표를 기준으로 너가 알아서 원인 분석, 수정, 검증까지 완료해줘.
중간에 꼭 필요한 경우에만 나에게 질문해줘.목표: guest 아바타의 idle/talking 전환에서 다른 아바타 영상이 보이는 문제를 해결해줘.
완료 조건: 선택한 avatar의 video만 유지되고, 다른 avatar의 영상이 노출되지 않아야 해.
목표: RMS 입모양 수정 기능이 영상 매칭 문제와 관련 있는지 확인해줘.
완료 조건: 직접 관련인지, 간접 영향인지, 무관한지 코드 기준으로 결론이 나와야 해.
목표: guest에서 핑퐁이 음성이 host로 전달되지 않는 문제를 해결해줘.
완료 조건: socket/media relay 경로가 정상 작동하고 재현되지 않아야 해.
목표: dev 배포 후 health는 정상인데 화면이 비는 문제를 해결해줘.
완료 조건: 브라우저에서 정상 렌더링되고, 원인이 로그/코드로 설명되어야 해.
단, 범위가 너무 넓으면 Hermes가 최적 경로를 찾기 어렵기 때문에 대상과 완료 조건은 꼭 적는 것이 좋습니다.
“goal: guest avatar 영상 매칭 문제 해결 / 완료 조건: 선택한 avatar만 유지 / 검증: typecheck와 브라우저 재현 확인”
“아바타가 좀 이상한데 알아서 봐줘.”
이 방식이면 Hermes가 탐색부터 수정, 검증까지 더 자연스럽게 이어갈 수 있습니다.