하네스 도구

핵심 아이디어

하네스 도구는 AI가 엉뚱한 방향으로 가지 않도록 작업 범위, 규칙, 기록을 잡아 주는 도구입니다. 바이브 코딩에서는 AI에게 바로 "코드부터 만들어 줘"라고 시키기보다, AI가 참고할 문서와 작업 원칙, 변경 기록을 함께 준비합니다.

쉽게 말하면

하네스 도구는 말을 잘 달리게 하려고 채우는 마구처럼, AI가 안전한 범위 안에서 일하도록 잡아 주는 장치입니다. AI가 빠르게 코드를 만들더라도 사람이 방향을 확인하고 되돌아갈 수 있게 도와줍니다.

예시

이 시리즈에서는 다음을 하네스 도구처럼 사용합니다.

• AI 코딩 도구: AI agent와 대화하며 파일을 만들고 명령을 실행하는 도구
• opencode: 이 시리즈에서 기본으로 쓰는 AI 코딩 도구
• agent.md: AI가 지켜야 할 작업 원칙을 적어 두는 문서
• docs/: 앱의 목적과 설계를 쌓아 두는 폴더
• Git과 GitHub: AI가 바꾼 내용을 기록하고 확인하는 장치

헷갈리기 쉬운 점

하네스 도구는 특정 프로그램 하나만 뜻하지 않습니다. opencode 같은 AI 코딩 도구도 하네스 도구가 될 수 있고, agent.md, docs/, Git처럼 AI 작업을 안전하게 묶어 주는 장치도 하네스 도구가 될 수 있습니다.

이 블로그에서의 역할

이 시리즈에서는 하네스 도구를 먼저 준비한 뒤 작은 앱을 만듭니다. 하네스 도구를 준비하면 AI가 만든 결과를 사람이 더 쉽게 확인하고, 필요한 경우 이전 상태로 돌아갈 수 있습니다.