2026년 현재 AI 코딩 도구가 모이는 표준 — CLAUDE.md, AGENTS.md, .cursorrules, .github/copilot-instructions.md, 그리고 Claude Code의 Skills·서브에이전트·hooks·MCP·permission 모드까지. 어떤 파일에 무엇을 넣고, 어떻게 계층화하고, 무엇을 피해야 하는지. 복사해서 쓸 수 있는 스니펫과 함께 정리합니다.
Anthropic이 2025년 가을에 처음 도입하고 12월에 오픈 표준화한 Agent Skills는 2026년 5월 현재 Claude Code의 표준 확장 방식이 되었다. 본질은 단순하다 — YAML 프론트매터 + 마크다운 지시 + 필요하면 스크립트/레퍼런스. 모델이 description을 읽고 스스로 invoke 여부를 결정한다. 이 글은 SKILL.md의 정확한 스펙(필드 전부), 디렉터리 레이아웃, 호출 모델, 패키징/배포, 그리고 release-notes-from-git-log Skill을 끝까지 만들어보는 핸즈온이다. MCP·subagent·plugin과의 결정 트리, 실제 개발자들이 만들고 있는 Skill 사례까지.
AI 하네스(Harness)는 AI 모델을 감싸서 제어하는 오케스트레이션 레이어입니다. System Prompt, Tools, Context, Skills, Hooks, Permissions, Memory의 7가지 구성 요소를 해부하고, Claude Agent SDK와 LangGraph로 직접 만드는 방법까지 — AI 엔지니어 필독 가이드.