팀원들이 리더를 거치지 않고 서로 직접 대화할 수 있게 해주는 세 가지 도구 TeamCreate, TaskCreate, SendMessage를 다룬다. 3인이 넘으면 리더가 무너진다. 리더는 한 번에 한 사람과만 대화할 수 있으니, 3인이 넘는 경우 순차 파이프라인으로 퇴행해서 병목이 발생한다. 리더는 이벤트 루프, 팀원은 피어 잘 설계된 오케스트레이터는 리더를 중개자가 아니라 수신자이자 통합자의 위치에 둔다. 왼쪽 그림의 리더는 모든 메시지를 받아 ‘누구에게 전달할지’를 판단하는 중앙 브로커이다. 오른쪽 그림의 리더는 팀원들이 스스로 조율하는 동안 기다리다가, 작업이 끝나거나 막혔을 때 알림을 받는 수신자이다....
description을 Pushy 3단계 공식(동식 나열, 트리거 상황, 경계 조건)으로 작성하는 방법을 익히고, 컨텍스트를 아끼면서도 정보를 충분히 담는 Progressive Disclosure 구조를 이해한다. 규칙이 아닌 이유를 본문에 담는 Why-First 원칙을 실제 예시로 확인한다. 스킬을 썼는데 왜 호출이 안 될까 클로드는 스킬을 호출 할 지 결정할 때 본문을 읽지 않고, name과 description 만 보고 판단한다. 클로드 코드는 세션이 열릴 때 전체 컨텍스트 윈도의 약 1%만 스킬 목록에 쓴다. 1% 예산은 SLASH_COMMAND_TOOL_CHAR_BUDGET 환경 변수로 조정할 수 있으며, 기본 대체 한도는 약 8,000자이다....
에이전트 정의 파일을 ‘설정 파일’이 아닌 ‘역할 계약서’로 바라보는 관점을 갖고 name, descrfiption, model, tools 필드와 본문 7섹션을 올바르게 채우는 방법을 익힌다. 어떤 모델을 고를지, 어떤 도구를 허용할지를 결정하는 기준도 함께 살펴본다. 어제 잘 굴러가던 팀이 오늘 아침 사라지는 이유 모든 에이전트는 반드시 .claude/agents/{name}.md 파일로 정의한다. 파일 없이 프롬프트 파라미터에 역할을 직접 넣는 것을 금지한다. 없으면, 다음 날 다시 팀을 소환할 떄 역할을 처음부터 다시 서명해야 한다. 없으면, 두 세션이 같은 기준으로 판단했는지 검즈할 길이 없다....
에이전트, 스킬, 오케스트레이터 각각의 역할과 경계를 이해하고, 책임이 뒤섞였을 때 나타나는 네 가지 문제를 파악한다. 재사용 불가 병렬화 불가 누락 반복 컨텍스트 폭발 2인 팀을 분해해보자 하네스는 누가(Agent), 어떻게 (Skill), 언제∙누구와(Orchestrator) 라는 세 가지 요소로 나뉘며, 이들은 독립적으로 설계되고 실행 시점에만 맞물린다. 한 파일에 다 넣으면 무엇이 깨지는가 위 에이전트가 문제가 되는 이유 재사용 불가: “Conventional Commits 형식 체크” 로직을 PR 리뷰용 에이전트에서도 쓰고 싶다면 복사-붙여넣기밖에 방법이 없다. 한쪽을 고치면 다른 쪽도 함께 고쳐야 하고, 그러다 일관성이 흐트러진다....
하네스 엔지니어링이 무엇인지 이해한다. 프롬프트 엔지니어링과 하네스 엔지니어링이 어떻게 다른지 정리하고 흔히 오해하는 세 가지 개념을 짚어본다. 혼자 일하는 AI는 자기 실수를 못 본다 단일 에이전트는 자신의 실수를 잘 보지 못한다. 하나의 에이전트가 plan → code → verify → self-revise 를 일반적으로 거친다. 이 과정은 자기 출력물을 자기가 검토하는 것과 같기때문에 한계가 있다. 병목은 능력이 아니라 구조다 AI 에이전트 시대에 ‘엄격함’은 사라진게 아니라 자리를 옮겼다. 예시: GC가 들어왔을 때 메모리 관리의 엄격함이 사라진 것이 아니라 런타임과 프로파일러로 옮겨 갔다....
하네스가 ‘좋은 프롬프트’와 어떻게 다른지 결과물로 직접 느끼고, .claude/agents와 .claude/skills/ 디렉터리를 처음부터만들어 본다. author와 reviewer 두 에이전트가 파일을 주고받으며 협업하는 2인팀을 완성하고, 자연어 한 줄로 팀을 소환하는 경험을 한다. 직접 해보기 생성-검증 패턴(generator-verifier): author 에이전트가 쓰고 reviewer 에이전트가 검토한다. 한쪽이 놓친 문제를 다른 한쪽의 기준에서 걸릴 가능성이 높아진다. 에이전트에 model 필드를 지정하지 않으면 부모 세션의 모델을 따라간다.