하네스 엔지니어링 활용기 - 1

mongBrown·2026년 5월 11일

하네스 엔지니어링

하네스 엔지니어링에 대해서 설명을 듣게 되어서,
이 항목을 내가 지금 CS 공부할 때 활용해보려고 했다.

하네스 엔지니어링에 대해서 영상을 보며 정리해 보았다.

하네스 엔지니어링이란 것은
결국 AI가 부담을 느끼지 않고 안정적으로 다음 단계로 나갈 수 있도록
전체 데이터를 한번에 주는 것이 아닌, 목차별로 항목을 나누어서 제공하고

CI/CD 강제 를 통해, 내가 정한 틀에서 벗어나고자 할 떄
강제할 수 있는 훅이나 룰을 셋팅을 통해 다시 기존 방향으로 가도록 하는 것이 핵심이다.

코드를 작성하는 입장에서는 처음에 계획을 세우고,
script 파일을 실행을 통해서 수정한 부분이 세워진 계획대로 동작하는지 검증할 수 있게한다.
그 단계를 통과하지 못할 경우, 실패하도록 구성을 하는 것이다.

그리고, 작업을 하면서 참고해야할 것들을 document 로 참고할 수 있도록 하고
진행한 사항은 logs 에 남기면서 체크할 수 있도록 해 자동으로 코드를 만드는 플로우를 만들어 내고 있었다.

이 부분을 보니, CS 공부할 떄랑은 맞지 않는 부분도 있을 수 있어 보이지만,
적용을 할 수 있는 부분도 있어보여 지금 상태를 보고, 바꿀 수 있는 부분을 찾아보기로 했다.


잘못 쓰고 있던 것들

규칙 파일이 잘못 쓰이고 있었다

무조건 읽어야할 파일을 CLAUDE.md 에서 두개로 지정했었는데, 그중 rule.md 에 규칙과 데이터가 같이 들어있었다.
진행한 질문 목록과, 진행했던 것 중 헷갈렷던 항목들에 대해서 기록을 한 부분을 같이 기록하고 있었다.
진행한 질문이 30개가 넘어가면서 파일이 400줄을 넘겼었다.

그래서 이 부분은 각 단계로 나누어 필요할 때 로그성으로 보고 활용하도록 변경했다.

잘못된 Trigger 활용

Claude가 마음대로 다음 상태로 넘어가는 걸 막고자 triggers.md라는 파일을 따로 만들었다. 각 상태에서 어떤 발화가 왔을 때만 다음 상태로 이동할 수 있는지를 기입하는 방식이었다.

### 학습 중
다음 가능 상태: `로그 생성 승인 대기`, `규칙 수정 중`

"만들어줘" / "정리해줘" / "저장해줘"  →  로그 생성 승인 대기
"규칙" / 설정 관련                    →  규칙 수정 중
그 외 사용자 발화                     →  학습 중 유지

Claude는 결국 내가 무슨 상태인지 알기 위해 모든 항목을 포함해서 들고 있었을 것 같고..
필요 없는 항목만 들고있도록 하게 했던것 같다.


지금 바꾼 것들

쓸모없는 파일들 제거

# 현재 CLAUDE.md

### 1단계: 주제 선택

`1-topic-select.md`를 참고한다.

### 2단계: 학습 중

`2-learning.md`를 참고한다.

rule.md, trigger.md는 삭제했고, 각 상태에 해당하는 규칙은 status/1~5.md로 분리했다.
그리고, 각각 정해진 md 파일을 읽도록 했다.

그리고, 진행했던 항목과 헷갈리는 항목들은 log/ 폴더에 쌓익도, 필요할 떄 만 접근하도록 했다.


기대하는 바

이번 수정으로 크게 달라진건 없을 것 같다.
아직 까지 하네스 엔지니어링의 핵심인 CI/CD 강제 등 진행하고 훅 등을 통해 각 단계의 실패를 지정하고
수행하는 부분을 건들지는 못했으니 하지만 CS공부에 이정도 자동화는 아니여야 하긴 하는데.. 싶긴 하지만
일단 각각 상황에서 맥락으로 파악해야할 부분을 줄였으며, 각 단계별로 볼 부분이 정리까지는 된 것 같다.

바꾸어 갈지 틀은 어느정도 잡았으니, 진행하면서 아이디어가 생겼을 때 또 변경해보고자 한다.

profile
화이팅!

0개의 댓글