소개
AI 하네스를 본격적으로 구성하기 전에 가장 먼저 진행한 것은 개발 환경과 운영 규칙 정리였습니다
처음에는 단순히 여러 AI 에이전트를 연결하면 자동화가 자연스럽게 될 거라고 생각했지만, 실제로는 에이전트보다 더 중요한 것이 있었습니다.
바로 규칙 설계와 역할 분리였습니다.
특히 하나의 AI 에이전트에게 너무 많은 역할을 부여하면 다음과 같은 문제가 자주 발생했습니다.
컨텍스트 길이 증가
작업 집중도 저하
역할 충돌
이전 작업 맥락 유실
결과물 품질 편차 증가
그래서 하네스를 구성하기 전에 먼저 아래와 같은 기본 구조를 정리하기 시작했습니다.
작업 규칙 정의
역할 분리
아키텍처 제약 설정
린트 및 타입 검사 환경 구성
반복 작업 자동화 준비
진행 방법
1. cmux 구성
여러 터미널 세션을 효율적으로 관리하기 위해 cmux를 먼저 구성했습니다.
멀티 에이전트 환경에서는:
로그 확인
실행 상태 모니터링
빌드 상태 확인
테스트 실행
등을 동시에 확인해야 하는 경우가 많아서 단일 터미널로는 한계가 있었습니다.
그래서 여러 작업을 병렬로 관리하기 위한 환경부터 먼저 준비했습니다.
2. Hermes 기반 자동화 준비
반복적으로 수행되는 작업들을 자동화하기 위해 Hermes 기반 작업 흐름도 함께 준비했습니다.
주요 목적은 아래와 같았습니다.
반복 명령 자동화
작업 흐름 단순화
실행 실수 감소
에이전트 간 공통 작업 표준화
특히 AI 에이전트 환경에서는 사람이 직접 반복 수행하는 작업이 많아질수록 오히려 흐름이 깨지는 경우가 많았습니다.
그래서 자동화 이전에 “무엇을 반복하는가”를 먼저 정리하는 과정이 중요했습니다.
1주차 hermes 구성 영상을 보고 구성을 하였고 일단 무료 버전인 딥시크 v4-flash로 해서 구성을 하였습니 다 . 이후 현재 가입된 codex 등 다른 llm 을 연결해서 해봐야할듯 합니다
구성 화면
다양한 항목이 포함된 컴퓨터 화면의 스크린샷
3. AGENTS.md / CLAUDE.md 구성
가장 중요하게 생각했던 부분입니다.
AI 에이전트가 안정적으로 동작하려면 프롬프트보다 먼저 “작업 규칙”이 명확해야 했습니다.
구성은 아래처럼 최대한 단순하게 유지했습니다.
AGENTS.md
- 구현 원칙
- 비즈니스 규칙
- 기술 스택
- 커밋 규칙
- 빌드 & 실행
- 절대 금지 사항Claude 사용 시에는 별도로 CLAUDE.md를 추가해서 동일한 정책을 유지했습니다.
AGENTS.md → 범용 에이전트용
CLAUDE.md → Claude 전용그리고 가장 중요했던 원칙은:
"파일을 길게 만들지 않는다"
였습니다.
실제로 AGENTS.md가 지나치게 길어지면:
컨텍스트 소비 증가
중요 규칙 희석
에이전트 집중도 감소
문제가 발생했습니다.
그래서 최대한 100줄 이내로 유지하고,
긴 설명은 별도의 skills 또는 commands로 분리했습니다.
4. 기본 구조 설계
하네스 구성 전 아래와 같은 기본 디렉토리 구조도 먼저 정리했습니다.
agents/
commands/
skills/역할별 책임을 분리하기 위한 목적이었습니다.
5. 역할 기반 에이전트 분리
이번 준비 과정에서 가장 중요하게 느낀 부분입니다.
AI 에이전트의 작업을 여러 개의 서브 에이전트로 분리하는 이유는 단순 병렬 처리 때문이 아니었습니다.
핵심은:
컨텍스트 유실 방지
역할 집중도 향상
작업 정확도 증가
성공률 향상
이었습니다.
실제로 하나의 거대한 에이전트에게 모든 역할을 맡기면:
설계
구현
리뷰
문서화
가 서로 충돌하기 시작했습니다.
그래서 역할을 아래처럼 분리했습니다.
Planner / PM
- 요구사항 분석
- 기획서 작성
Coder
- 코드 작성
- 알고리즘 구현
- 패턴 적용
Reviewer / Documenter
- 코드 리뷰
- README 정리
- API 문서화
- 테스트 검증
- 엣지 케이스 확인이렇게 나누자 오히려 컨텍스트 품질과 결과 일관성이 더 좋아졌습니다.
결과와 배운 점
이번 하네스 준비 과정에서 가장 크게 배운 점은:
"에이전트보다 규칙 설계가 더 중요하다"
는 것이었습니다.
좋은 모델을 사용하는 것보다 더 중요한 것은:
역할 분리
컨텍스트 관리
작업 제약
공통 규칙
책임 범위 정의
였습니다.
특히 아래 두 가지를 매우 중요하게 느꼈습니다.
1. 긴 규칙은 오히려 독이 된다
처음에는 모든 내용을 AGENTS.md에 넣으려고 했지만,
오히려 집중도가 떨어지고 중요한 규칙이 흐려졌습니다.
그래서:
핵심만 남기고
나머지는 skills 분리
commands 분리
방식으로 단순화했습니다.
2. 역할 충돌은 품질 저하로 이어진다
하나의 에이전트에게 너무 많은 역할을 주면:
설계 관점
구현 관점
리뷰 관점
이 서로 섞이기 시작했습니다.
결국 역할을 명확히 분리하는 것이 결과 품질 안정화에 훨씬 효과적이었습니다.
앞으로 계획
다음 단계에서는:
품질 검사 설정 ( 린팅과 커밋검사)
tdd 및 e2e 테스트 등 흐름 정리
자동화 범위 확장
까지 진행해볼 예정입니다
도움 받은 글 (옵션)
22기 1주차 실습세션 - Hermes 설치
