№001 harness-engineering · 01
하네스 엔지니어링이란? AI 에이전트 환경 설계 입문 가이드 (1/8)
하네스 엔지니어링은 프롬프트만이 아니라 AI 에이전트가 일하는 환경 전체(규칙·도구·기억·권한·역할·검증)를 체계적으로 설계하는 방법론입니다. 정의·에이전트 루프·7가지 설계 축을 입문자 눈높이로 정리합니다.
Series · Folio
harness-engineering
08 parts각 편은 단독으로 완결되도록 쓰였으나, 합치면 하나의 장편이 됩니다.
№002 harness-engineering · 02
[Claude Code] AI 에이전트 과업 분해 — 큰 작업을 나누는 4가지 기준과 plan 에이전트 (2/8)
Claude Code·OpenCode 에이전트에게 큰 작업을 맡길 때 왜 실패하는지, 좋은 분해의 4가지 조건과 plan 에이전트로 계획과 실행을 분리하는 패턴을 정리합니다. 실전 템플릿과 CLAUDE.md 규칙 예시 포함.
№003 harness-engineering · 03
CLAUDE.md 작성 가이드 — 에이전트 지식 구조화의 3계층 원칙과 Agent Legibility (3/8)
CLAUDE.md(AGENTS.md)는 백과사전이 아니라 50줄짜리 맵이어야 합니다. 맵 → docs/ → 코드의 3계층 구조, OpenAI 실패 사례, Agent Legibility 개념, 점진 발전 4주 플랜을 정리합니다.
№004 harness-engineering · 04
[Claude Code] AI 에이전트 도구 설계 — Tool, Skill, Plugin, MCP의 차이와 SKILL.md 작성법 (4/8)
Claude Code·OpenCode 에이전트의 도구 레이어를 Tool → Skill → Plugin 3계층과 MCP(Model Context Protocol)로 나눠 정리합니다. SKILL.md 작성 레시피, MCP 서버 설정 예시, 도구 추가 전 체크리스트 포함.
№005 harness-engineering · 05
Claude Code 권한 설정 — allow/ask/deny와 permission mode, hooks 조합으로 안전한 자동화 (5/8)
Claude Code의 allow/ask/deny 3단계 권한, default/plan/auto permission mode, hooks를 조합해 최소 권한 자동화 파이프라인을 설계하는 방법을 실제 settings.json 예시와 함께 정리합니다.
№006 harness-engineering · 06
[Claude Code] AI 에이전트 메모리 패턴 — PROGRESS.md와 --continue로 세션 이어가기 (6/8)
Claude Code·OpenCode·OpenClaw에서 세션이 끊겨도 에이전트가 어제까지의 결정을 기억하게 만드는 메모리 패턴을 정리합니다. PROGRESS.md 템플릿, --continue와 새 세션 선택 기준, 구조적 커밋 메시지, 세션 핸드오프 프로토콜 포함.
№007 harness-engineering · 07
[Claude Code] AI 에이전트 Subagent 만들기 — code-reviewer·researcher 역할 분리 패턴 (7/8)
Claude Code에서 subagent로 역할을 분리해 code-reviewer·researcher·test-writer 전문 에이전트를 만드는 방법을 정리합니다. 실제 정의 파일 3개 예시, tools.allow/deny 설계, 확장 순서와 흔한 실수까지 포함합니다.
№008 harness-engineering · 08
[Claude Code] 하네스 엔지니어링 검증 루프 설계: 실패 로그와 Hooks 활용 (8/8)
Claude Code 기반 AI 에이전트가 같은 실수를 반복하지 않도록 만드는 검증 루프 설계법. 실패 로그를 남기고 Hooks로 해당 축만 보강하는 4단 루프(관찰·진단·보강·검증)를 실전 시나리오와 함께 정리합니다.
