하네스의 물리적 구조는 오케스트레이터(CLAUDE.md), 전문 에이전트 정의(agents/.md), 스킬 파일(skills//skill.md), 상태 추적(feature-list.json, progress.md)의 네 계층으로 구성된다. 각 파일은 독립적이지 않고 서로 참조·연결되어 하나의 시스템을 이루며, 에이전트가 역할을 나누고, 규칙을 따르고, 일관된 품질을 유지하며 작업할 수 있는 환경을 만든다.
하네스 엔지니어링의 다섯 가지 주요 안티패턴은 천 페이지 매뉴얼(과도한 규칙), 과도한 제어 흐름(절차 정의), 도구 과다 제공, 실패를 모델 탓으로 돌리기, 하네스 오버엔지니어링이다. 공통 해결 원칙은 에이전트가 실수할 때마다 그 실수를 구조적으로 불가능하게 만드는 해결책을 코드로 반영하는 것이며, 하네스는 완성되는 것이 아니라 실패를 연료로 진화하는 것이다.
하네스 구축은 규모에 맞게 단계적으로 접근해야 한다. Level 1(개인)은 CLAUDE.md + pre-commit 훅 + 기존 테스트 유지로 30분이면 충분하다. Level 2(소규모 팀)는 아키텍처 테스트, CI 파이프라인, 계층적 CLAUDE.md를 추가한다. Level 3(조직)은 엔트로피 점수 산출, 건강도 게이트, 주간 자동 리포트까지 확장한다. 핵심은 현재 규모에서 가장 아픈 문제를 해결하는 수준으로 도입하는 것이다.
컨텍스트 엔지니어링은 AI 에이전트가 올바른 결과물을 만들기 위해 필요한 정보를 구조화하고 제공하는 기술이다. 구체적인 규칙 파일(AGENTS.md), 계층적 구조, JSON 기반 기능 목록, 파일시스템 기반 진행 로그, 초기화 스크립트를 통해 에이전트에게 추측이 아닌 읽기를 시킨다. 핵심 원칙은 저장소가 단일 진실 소스가 되어야 한다는 것이다.