AI 하네스
AI 하네스란 무엇인가
Last Updated: 6월 5, 2026ICLR 2026를 계기로 harness(실행 계층)와 scaffold(행동 정의 계층)를 분리하는 좁은 정의가 정리되었지만, 실무 현장에서는 모델을 제외한 모든 것을 통칭하는 포괄적 AI harness 개념이 훨씬 널리 쓰입니다. AI 하네스 wiki에서는 skill, hook, rule 과 같은 포괄적 개념의 하네스에 대해 다룹니다. 본 포스트에서는 하네스와 스캐폴드에 대한 정의에 대해 짧게 정리하였습니다. 1. 하네스 용어 혼란 이 논의는 ICLR...
AI 코딩 에이전트의 주요 구성요소
Last Updated: 6월 5, 2026여기서 말하는 Rules, Skills, Subagents, Memory, Hooks는 주로 Claude Code/Claude 기반 코딩 에이전트 환경에서 정리된 개념 체계에 가깝습니다. Cursor, Codex, Gemini CLI, Windsurf 같은 다른 AI 코딩 도구들도 비슷한 기능을 제공하지만, 명칭과 저장 위치, 호출 방식은 도구마다 다를 수 있습니다. 따라서 이 표는 모든 코딩 에이전트의 공통 표준이라기보다, Claude를 기준으로 AI 코딩 에이전트의 구성요소를 이해하기...
Claude Skills
Last Updated: 6월 5, 2026Claude Skill은 특정 작업 유형에 대한 지식과 절차를 담는 재사용 단위입니다. 디렉터리 이름이 직접 호출 이름이 되며, description은 Claude가 자동으로 사용할지 판단하는 핵심 단서입니다. Skill에 넣기 좋은 내용은 다음과 같습니다. LLM이 자동으로 스킬을 이용하지 않고 사용자가 수동으로만 실행해야 하는 작업은 disable-model-invocation: true를 formatter(— — 사이) 부분에 추가합니다. 예를 들어 배포, 커밋, 외부 전송처럼 부작용이 큰...
Claude Memory
Last Updated: 6월 5, 2026Memory: 세션을 넘어 축적되는 프로젝트 학습 기록 Memory는 Claude가 세션을 넘어 프로젝트별 학습 내용을 기억하는 공간입니다. CLAUDE.md가 사람이 작성한 규칙이라면, Memory는 작업 중 반복해서 배운 사실과 디버깅 패턴을 축적하는 용도입니다. 즉, CLAUDE.md는 “앞으로 항상 이렇게 일하라”는 명시적 운영 규칙이고, Memory는 “이 프로젝트를 다루다 보니 이런 문제가 반복되더라”는 경험 기반 노트에 가깝습니다. Memory에 남기기 좋은 내용:...
Claude Hook
Last Updated: 6월 5, 2026Claude Hook 은 Claude Code의 특정 lifecycle 지점에서 자동 실행되는 사용자 정의 자동화입니다. 쉽게 말하면, Claude가 작업하는 중간중간에 “반드시 실행되어야 하는 검사나 후처리”를 끼워 넣는 장치입니다. Claude에게 프롬프트로 “위험한 명령은 실행하지 마”, “수정 후 lint를 돌려”, “작업 끝나기 전에 테스트해”라고 지시할 수도 있지만, 프롬프트 지시는 세션이 길어지거나 컨텍스트가 바뀌면 누락될 수 있습니다. 반면 Hook은 Claude의...
Claude Subagents
Last Updated: 6월 5, 2026Claude Subagents: 별도 컨텍스트를 가진 전문 작업자 Claude Subagents 는 별도 컨텍스트에서 동작하는 전문 에이전트입니다. 많은 파일을 읽고 분석해도 중간 과정이 메인 대화에 쌓이지 않고, 최종 요약만 돌아옵니다. subagent 파일 위치 모든 프로젝트에서 재사용할 개인 Subagent는 ~/.claude/agents/에 둘 수 있습니다. 같은 이름의 Subagent가 여러 위치에 있으면 더 높은 우선순위의 위치가 적용됩니다. Subagent 파일은 크게 두...
Claude Rules (Claude.md)
Last Updated: 6월 5, 2026Claude.md : 세션 전체의 기본 작업 기준 AI 코딩 에이전트는 매번 새로운 요청을 받을 때마다 프로젝트의 전체 맥락을 처음부터 완벽히 기억하지 못합니다. 그래서 프로젝트마다 반복적으로 지켜야 하는 기준을 별도의 규칙 파일에 적어 두고, 세션이 시작될 때 자동으로 읽게 만드는 장치가 필요합니다. Claude Code에서 이 역할을 하는 대표 파일이 CLAUDE.md입니다. CLAUDE.md는 단순한 메모장이 아니라, 에이전트가 코드를...
참고) Claude Hook Matcher
Last Updated: 6월 5, 2026Claude Hook Matcher 종류 표현 방식 기준 Matcher 종류 예시 의미 주의점 전체 매칭 빈 값, *, matcher 생략 해당 event가 발생할 때마다 실행 자주 실행되는 event에서는 과도하게 넓을 수 있음 정확 매칭 Bash 특정 값과 정확히 일치할 때 실행 tool event에서는 도구 이름과 정확히 일치해야 함 OR 매칭 `Edit|Write` 여러 값 중 하나와 일치하면...