[Harness Engineering] 도메인별 하네스 템플릿
REST API 백엔드, 프론트엔드 웹 애플리케이션, 데이터 파이프라인 세 가지 도메인에 맞춘 완결된 하네스 템플릿을 제공한다. 각 템플릿은 CLAUDE.md, 에이전트 정의, 스킬 파일, 의존성 규칙, 테스트 전략을 포함하며, 복사 후 프로젝트에 맞게 커스터마이징하여 사용할 수 있다. 하네스는 프레임워크가 아니라 패턴이며, 프로젝트와 함께 진화한다.
CLAUDE.md
[Harness Engineering] 하네스 구조 해부
하네스의 물리적 구조는 오케스트레이터(CLAUDE.md), 전문 에이전트 정의(agents/.md), 스킬 파일(skills//skill.md), 상태 추적(feature-list.json, progress.md)의 네 계층으로 구성된다. 각 파일은 독립적이지 않고 서로 참조·연결되어 하나의 시스템을 이루며, 에이전트가 역할을 나누고, 규칙을 따르고, 일관된 품질을 유지하며 작업할 수 있는 환경을 만든다.
[Harness Engineering] 단계별 구축 가이드
하네스 구축은 규모에 맞게 단계적으로 접근해야 한다. Level 1(개인)은 CLAUDE.md + pre-commit 훅 + 기존 테스트 유지로 30분이면 충분하다. Level 2(소규모 팀)는 아키텍처 테스트, CI 파이프라인, 계층적 CLAUDE.md를 추가한다. Level 3(조직)은 엔트로피 점수 산출, 건강도 게이트, 주간 자동 리포트까지 확장한다. 핵심은 현재 규모에서 가장 아픈 문제를 해결하는 수준으로 도입하는 것이다.
[Harness Engineering] 컨텍스트 엔지니어링
컨텍스트 엔지니어링은 AI 에이전트가 올바른 결과물을 만들기 위해 필요한 정보를 구조화하고 제공하는 기술이다. 구체적인 규칙 파일(AGENTS.md), 계층적 구조, JSON 기반 기능 목록, 파일시스템 기반 진행 로그, 초기화 스크립트를 통해 에이전트에게 추측이 아닌 읽기를 시킨다. 핵심 원칙은 저장소가 단일 진실 소스가 되어야 한다는 것이다.
Claude Code .claude 디렉토리 완전 정복: 전체 구조와 역할 총정리
Claude Code의 .claude 디렉토리는 글로벌(~/.claude/)과 프로젝트(.claude/) 두 레벨로 나뉘며, CLAUDE.md(지침), settings.json(설정), commands·agents·skills·hooks·rules(확장), projects·file-history·todos(런타임 데이터)로 구성된다. ~/.claude.json과 .mcp.json은 디렉토리 밖에 별도로 존재하며, 엔터프라이즈 관리형 설정은 OS별 시스템 경로에 배포된다. 설정 우선순위는 엔터프라이즈 > 로컬 > 공유 > 글로벌 순이다.