하네스 & 스킬 위키

이 위키가 다루는 것

용어는 쏟아지는데, 정작 “에이전트 하네스가 뭐냐”에 한 문장으로 답하기는 어렵습니다. 이 위키는 스킬(skill)이라는 가장 작은 단위에서 시작해, 그것을 감싸 돌리는 **하네스(harness)**까지를 공식 문서·스펙·대표 오픈소스만 근거로 차근차근 쌓아 올립니다.

기초

스킬의 폴더 구조와 점진적 공개, 도구 호출의 종류를 0. 에이전트 지도에서부터 짚습니다.

실행

계획·행동·관찰로 도는 4. 하네스 실행 루프와 컨텍스트·메모리 관리를 다룹니다.

협업

7. 서브에이전트 위임에서 출발해 오케스트레이션 패턴과 MCP 같은 연결 프로토콜로 이어집니다.

운영

권한·샌드박스 같은 10. 안전장치부터 추적·평가, 프레임워크 비교와 실전 예제까지 살핍니다.

읽는 법

왼쪽 사이드바를 0번부터 순서대로 따라가면 됩니다. 각 장은 한 줄 정의 → 그림 → 왜 중요한가 → 본문 → 예제 → 요약 체크리스트 순서로 똑같이 짜여 있어서, 어느 장을 펼쳐도 같은 동선으로 읽힙니다.

전체 장 한눈에

14개 장을 네 묶음으로 나눠 한자리에 모았습니다. 관심 가는 곳부터 바로 펼쳐 보셔도 됩니다.

기초

• 0. 에이전트 지도 — agent·harness·skill·tool·memory·orchestration이 어디서 갈라지는지 경계를 긋습니다.
• 1. 스킬 기본형 — SKILL.md 폴더 구조와 프런트매터, 점진적 공개 3단계를 정리합니다.
• 2. 점진적 공개 — 컨텍스트를 유한 예산으로 보고 필요할 때만 불러오는 JIT 원리를 다룹니다.
• 3. 도구 호출 — function calling·hosted tools·셸·컴퓨터 사용·MCP의 차이를 비교합니다.

실행

• 4. 하네스 실행 루프 — plan-act-observe 루프와 재시도·정지 조건·승인 게이트를 운영 관점으로 봅니다.
• 5. 컨텍스트 엔지니어링 — 컴팩션·프롬프트 캐싱·적시 검색으로 토큰 예산을 무엇으로 채울지 다룹니다.
• 6. 메모리와 상태 — 세션·롱텀 메모리와 워크스페이스 상태·체크포인트를 실행 루프와 엮어 설명합니다.

협업

• 7. 서브에이전트 — 위임·핸드오프·포크된 컨텍스트와 단일 에이전트를 나누는 판단 기준을 제시합니다.
• 8. 오케스트레이션 패턴 — 라우터·수퍼바이저·그래프·크루·스웜·파이프라인의 트레이드오프를 살핍니다.
• 9. 프로토콜 계층 — MCP·A2A·OpenAPI 커넥터와 OAuth 인증 경계를 공식 스펙 기준으로 정리합니다.

운영

• 10. 안전장치 — 권한·샌드박스·승인 게이트와 프롬프트 인젝션 방어 설계를 다룹니다.
• 11. 관측 · 평가 — 트레이싱·평가·회귀 데이터셋·비용 모니터링으로 에이전트를 믿을 만하게 만듭니다.
• 12. 프레임워크 비교 — 주요 프레임워크를 같은 렌즈로 비교해 어떤 상황에 무엇이 맞는지 짚습니다.
• 13. 실전 구축 — 미니 스킬과 미니 하네스를 의사코드로 만들며 앞 장들을 한 흐름으로 잇습니다.

용어가 막히면

낯선 단어가 나오면 용어집에서 한 줄 정의로 빠르게 확인하실 수 있습니다.