하네스 엔지니어링이란?

[주인장]

하네스 엔지니어링이란?

하네스 엔지니어링(Harness Engineering)은 AI가 안정적으로 일을 수행할 수 있도록 작업 환경과 규칙, 절차를 함께 설계하는 방법을 말합니다.

쉽게 말하면 AI에게 한 번 좋은 질문을 하는 것에서 끝나는 것이 아니라, AI가 프로젝트를 제대로 이해하고 반복해서 좋은 결과를 만들 수 있도록 주변 환경을 구성하는 것입니다.

■ 프롬프트 엔지니어링과 차이

프롬프트 엔지니어링은 다음과 같이 생각할 수 있습니다.

"AI에게 무엇이라고 말할 것인가?"

반면 하네스 엔지니어링은 다음과 같습니다.

"AI가 제대로 일할 수 있도록 어떤 작업 환경을 만들어 줄 것인가?"

즉, 프롬프트 자체보다 더 넓은 개념입니다.

■ 왜 필요한가?

Claude Code, Codex와 같은 AI 코딩 도구를 사용하다 보면 단순히 "이 기능을 만들어줘"라고 요청하는 것만으로는 원하는 결과가 나오지 않는 경우가 많습니다.

AI가 프로젝트 구조를 정확히 이해하지 못할 수도 있고, 기존 코드의 규칙을 무시하거나 예상하지 못한 파일을 수정할 수도 있습니다.

이런 문제를 줄이기 위해 AI가 참고할 수 있는 규칙과 문서, 테스트 방법, 작업 순서를 미리 만들어 두는 것이 하네스 엔지니어링입니다.

■ 하네스 엔지니어링에 포함되는 것

• AI 작업 지침

CLAUDE.md, AGENTS.md와 같은 파일을 만들어 AI가 따라야 할 규칙을 정의합니다.

예를 들면 다음과 같은 내용을 넣을 수 있습니다.

• 사용하는 프로그래밍 언어와 버전

• 폴더 구조

• 코딩 규칙

• 수정하면 안 되는 파일

• 테스트 방법

• 작업 순서

• 프로젝트 문서

AI가 프로젝트를 이해하는 데 필요한 문서를 준비합니다.

예를 들면 다음과 같습니다.

README.md
architecture.md
api-spec.md
implementation-plan.md

이런 문서가 잘 정리되어 있으면 AI가 프로젝트 전체 구조를 이해하기 쉬워집니다.

• 작업 순서 정의

AI가 무작정 코드를 작성하게 하지 않고 일정한 순서로 작업하도록 합니다.

예를 들면 다음과 같습니다.

계획 수립
→ 코드 작성
→ 빌드
→ 테스트
→ 오류 수정
→ 다음 단계 진행

이런 절차를 만들어 두면 AI가 중간에 잘못된 방향으로 가는 것을 줄일 수 있습니다.

• 자동 검증

AI가 작성한 코드가 정상적인지 자동으로 확인하는 환경도 중요합니다.

예를 들면 다음과 같은 명령을 사용할 수 있습니다.

build
test
lint

AI가 코드를 작성한 후 자동으로 빌드와 테스트를 수행하게 하면 오류를 빠르게 발견할 수 있습니다.

■ 간단한 프로젝트 예시

Spring Boot와 React를 사용하는 프로젝트라면 다음과 같은 구조를 만들 수 있습니다.

CLAUDE.md

docs

• implementation-plan.md

• architecture.md

• api-spec.md

backend

frontend

tests

그리고 AI에게 다음과 같은 작업 규칙을 줄 수 있습니다.

"CLAUDE.md의 규칙을 따르고 implementation-plan.md의 순서대로 구현한다."

"각 단계가 끝날 때마다 빌드와 테스트를 수행한다."

"오류가 발생하면 수정한 후 다음 단계로 진행한다."

이렇게 하면 단순히 여러 번 질문하는 방식보다 훨씬 안정적으로 프로젝트를 진행할 수 있습니다.

■ 쉽게 비유하면

프롬프트 엔지니어링은 직원에게 일을 설명하는 것과 비슷합니다.

하네스 엔지니어링은 직원이 일을 잘할 수 있도록 업무 매뉴얼, 작업 환경, 검사 절차까지 만들어 주는 것과 비슷합니다.

즉,

프롬프트 엔지니어링
= AI에게 일을 잘 설명하는 방법

하네스 엔지니어링
= AI가 일을 잘 끝낼 수 있는 환경을 만드는 방법

이라고 이해하면 쉽습니다.

■ 정리

하네스 엔지니어링은 AI 자체를 더 똑똑하게 만드는 기술이라기보다, AI가 실수하지 않고 원하는 작업을 끝낼 수 있도록 작업 환경을 설계하는 기술이라고 볼 수 있습니다.

앞으로 AI 코딩 도구가 단순한 질문 답변 도구가 아니라 실제 개발 작업을 수행하는 에이전트 형태로 발전할수록 하네스 엔지니어링의 중요성도 더욱 커질 가능성이 있습니다.