훈 Labs

일하는 방식

2026년 2월부터 개발을 거의 전부 AI 코딩 에이전트에게 맡기고 있습니다. 그래서 제 일은 코드를 쓰는 것보다, 에이전트가 낸 결과를 믿을 수 있게 만드는 쪽에 가깝습니다. 스물여섯 개 레포를 거치며 남은 방식은 여섯 가지입니다. 사례는 모두 실제 작업 기록에서 왔습니다.

1규칙은 문서로, 금지는 기계로

레포마다 에이전트가 작업 전에 먼저 읽는 규칙 파일을 둡니다. 다만 되돌릴 수 없는 동작은 규칙 문서에 적는 것으로 끝내지 않고, 명령이 실행되기 전에 기계적으로 검사해 막습니다.

사례 첫 앱을 만들 때 에이전트가 다른 곳을 고치다 사용량 제한 로직과 필터의 핵심 함수를 지운 일이 있었습니다. 그 뒤 규칙 파일과 변경 기록 프로토콜(무엇을 바꿨는지, 어떻게 확인하는지, 기록을 어디에 남겼는지)이 생겼고, 지금 만드는 하드웨어에서는 보드의 영구 기록 영역처럼 한 번 쓰면 되돌릴 수 없는 곳을 막는 장치로 이어졌습니다.

2주장마다 검증 단계

실물이 걸린 주장에는 어디까지 확인했는지를 붙여 씁니다. 문서로만 있는 것, 만들어 둔 것, 장치가 응답한 것, 눈으로 확인한 것, 정확도까지 맞춘 것을 서로 다른 말로 적고, 단계를 건너뛰어 쓰지 않습니다.

사례 검증 주장이 자꾸 부푸는 문제를 제가 제기했고, Claude Code가 제안한 형식을 골라 다른 레포로 퍼뜨렸습니다. 예제 코드는 링 LED가 열세 개라고 했지만, 뜯어서 세어 보니 열두 개였습니다. 모니터에서 좋아 보이던 색은 실제 링에서 약하게 보여 실물 기준으로 다시 골랐습니다.

3예측을 먼저 적는다

결과를 보기 전에 예측을 적습니다. 결과를 보고 나서 설명을 만들면 어떤 결과든 설명되기 때문입니다. 틀린 판단은 지우지 않고, 정정 기록을 덧붙입니다.

사례 기기 화면이 버벅일 때, 짐작으로 고치지 않고 예측을 먼저 적은 뒤 보드 안에서 시간을 재서 원인을 갈랐습니다.

4서로 다른 눈으로 감사한다

쓰기 권한이 없는 감사 에이전트와 다른 회사의 AI가 작업을 따로 검토합니다. 논문을 쓰며 익힌, 남이 다시 따져 볼 수 있어야 한다는 기준을 개발에 옮긴 것입니다.

사례 작업을 마감할 때마다 서로 다른 모델 네 개가 대화 기록 원문을 따로 읽고, 기록에 빠진 것과 틀린 것을 찾습니다. 어느 한 AI의 판정을 그대로 받지 않고, 마지막 판정은 로그와 테스트로 제가 냅니다.

5기록은 대화 밖에

상태를 대화 안에 두지 않습니다. 결정과 근거, 시간순 기록, 다음에 이어 갈 지점을 파일로 남기고, 세션이 바뀌면 거기서 다시 시작합니다. 관찰한 사실과 해석을 섞지 않고 적습니다.

사례 이 원칙은 제 연구 주제(인지 커널 모델, CKM)이기도 합니다. 그 덕분에 1년이 지난 기록도 다시 꺼내 쓸 수 있었고, 이 사이트의 개발 이야기도 그 기록을 모아 썼습니다.

6장치보다 구멍 찾기

장치를 갖췄다는 것과 장치가 작동한다는 건 다른 일입니다. 그래서 장치를 늘리는 것보다, 구멍을 찾아 고치는 일을 계속 돌리는 데 시간을 씁니다.

사례 위험한 명령을 막는 가드가 터미널 명령만 검사하고 있었는데, 플러그인 도구로 명령을 실행하는 길은 그 검사를 거치지 않는다는 걸 뒤늦게 발견해 그 플러그인을 껐습니다. 정의표에 없는 검증 단계가 하루 넘게 기록에 쓰이다가, 네 모델의 마감 감사에서 걸려 정의를 추가한 적도 있습니다.

이 방식이 어떻게 생겼는지는 개발 이야기에 적었습니다.