앞 편까지 루프의 부품과 도구 대응을 봤습니다. 이 편은 코스에서 가장 짧지만 가장 중요한 구분을 다룹니다. 루프는 하나가 아니라 둘이 겹쳐 있습니다. 안쪽 루프는 지금 이 작업을 끝내기 위해 돌고, 바깥쪽 루프는 그 작업에서 배운 것을 다음 작업의 출발점으로 만들기 위해 돕니다.
읽고 나면 "쓸수록 똑똑해진다"는 말이 어떤 구조에서만 참이 되는지, 우리 62라운드가 안쪽이고 스킬 파일이 바깥쪽이라는 것을 설명할 수 있습니다. 마지막 편은 이 문서 묶음 자체가 어떻게 두 루프로 만들어졌는지를 보여 줍니다.
핵심 요약
- 안쪽 루프는 한 작업 안의 판단, 행동, 관찰 반복입니다. 완료 조건에 닿으면 끝납니다.
- 바깥쪽 루프는 결과물 단위의 검증, 수정, 재검증이며 교훈을 디스크에 적어 다음 세션에 넘깁니다.
- 바깥쪽이 없으면 안쪽은 매번 같은 실수에서 시작합니다. 바깥쪽이 있으면 안쪽의 첫 라운드 점수가 올라갑니다.
- 사람 팀의 문서화와 다른 점은 적은 것이 다음 실행에 자동으로 실린다는 것입니다.
안쪽 루프와 바깥쪽 루프: 쓸수록 똑똑해진다
"쓸수록 똑똑해진다"를 이중 구조로 잡는다
모델 자체는 세션 사이에 배우지 않습니다. 오늘의 Claude와 내일의 Claude는 같은 가중치입니다. 그런데 우리 채점 루프는 8월 25일 홈 페이지에서 68점으로 시작해 32라운드가 걸렸고, 이튿날 문의 admin 화면은 8라운드 만에 94, 93, 91에 닿았습니다. 모델이 똑똑해진 것이 아닙니다. 첫날의 교훈이 스킬 파일이 되어 둘째 날 첫 라운드부터 실렸기 때문입니다. "쓸수록 똑똑해진다"는 모델의 성질이 아니라 두 루프가 맞물린 구조의 성질입니다.
안쪽 루프: 작업을 완료까지 반복한다
안쪽 루프는 한 작업 안에서 돕니다. 에이전트가 판단하고, 도구를 부르고, 결과를 관찰하고, 다시 판단합니다. Claude Code가 한 프롬프트에 대해 수십 번 도구를 부르는 것이 가장 작은 안쪽 루프이고, 우리 채점 루프의 한 세션(실측, 수정, 캡처, 채점을 목표 점수까지 반복)이 조금 큰 안쪽 루프입니다.
안쪽 루프는 완료 조건(점수 95, 테스트 통과)에 닿으면 끝나고, 끝나면 컨텍스트와 함께 사라집니다. 62라운드 동안 알아낸 "90 부근 정체면 섹션별 쌍 비교로 바꾼다", "점선 플레이스홀더는 89에서 70으로 감점된다"는 세션이 닫히면 없습니다.
바깥쪽 루프: 교훈을 다음번의 출발점으로 바꾼다
바깥쪽 루프는 결과물 단위로 돕니다. 안쪽 루프가 끝난 뒤 사람이나 리뷰어나 훅이 결과물을 검증하고, 통과하면 교훈을 적고, 아니면 안쪽 루프를 다시 돌립니다. 적는 자리가 디스크라는 점이 핵심입니다.
우리 바깥쪽 루프의 실제 순서입니다.
- 안쪽 루프가 끝나면 라운드별 점수 표와 채점자 오판 기록을
.omc/wiki/와 볼트의 방법론 문서에 씁니다. 8월 25일 문서의 "수렴 기법 7개"와 "기술 함정 4개"가 그것입니다. - 반복해서 쓸 절차는 스킬로 굳힙니다. 이튿날
codex-score-loopSKILL.md가 만들어졌고, 채점 명령의 고정 형태와 프롬프트 뼈대와 마감 조건이 들어갔습니다. - 규칙 한 줄로 줄어드는 것은 CLAUDE.md에 넣습니다. "결제 코드 수정 시 교차 리뷰 필수"가 프로젝트 규칙 6번이 됐습니다.
- 다음 세션은 이 세 파일을 딛고 시작합니다. Claude Code는 CLAUDE.md를 세션 시작 시 로드하고, 스킬은
description이 맞으면 자동으로 불러오며, 자동 메모리MEMORY.md의 처음 200줄을 함께 싣습니다.
바깥쪽 루프에서 사람이 하는 일은 "무엇을 적을지 고르는 것"입니다. 전부 적으면 CLAUDE.md가 200줄을 넘어 준수율이 떨어집니다. 문서가 권하는 기준이 우리 기준과 같습니다. 같은 실수를 두 번째로 했을 때, 지난 세션에 입력한 것과 같은 설명을 다시 입력하고 있을 때 적습니다.
바깥쪽이 안쪽을 서서히 끌어올린다
두 루프가 맞물리면 안쪽 루프의 출발점이 매번 조금씩 올라갑니다. 첫날 홈 페이지의 첫 라운드는 68이었고, 스킬이 생긴 뒤 admin 화면의 첫 라운드는 캡처 공정화와 채점 제외 항목이 처음부터 적용된 상태였습니다. 결제 diff 교차 리뷰는 첫 라운드부터 불변 규칙을 번호로 적고 "지난 지시 반영 O/X"를 요구하는 프롬프트로 시작했기 때문에 4라운드로 끝났습니다.
바깥쪽이 없는 팀은 매 세션 같은 함정(codex exec stdin 대기)에서 멈추고, 매번 프롬프트를 새로 쓰며, 지난주와 이번 주의 점수를 비교하지 못합니다. 안쪽 루프만 돌리는 것은 같은 자리에서 뛰는 것입니다.
정리
- 안쪽 루프는 작업을 끝내기 위해, 바깥쪽 루프는 다음 작업을 더 잘 시작하기 위해 돕니다.
- 안쪽의 교훈은 세션과 함께 사라지므로 바깥쪽에서 위키, 스킬, CLAUDE.md 순으로 디스크에 굳힙니다.
- 무엇을 적을지 고르는 것이 사람의 일이며, 기준은 "같은 실수 두 번째", "같은 설명 다시 입력"입니다.
- 두 루프가 맞물릴 때만 "쓸수록 똑똑해진다"가 참이 됩니다.
자주 묻는 질문
안쪽 루프와 바깥쪽 루프는 무엇이 다른가요?
안쪽은 한 작업 안의 판단, 행동, 관찰 반복이며 완료 조건에 닿으면 끝나고 컨텍스트와 함께 사라집니다. 바깥쪽은 결과물 단위의 검증, 수정, 재검증이며 통과한 뒤 교훈을 디스크에 적어 다음 세션의 출발점으로 만듭니다.
바깥쪽 루프는 교훈을 구체적으로 어떻게 적나요?
세 층으로 나눕니다. 라운드 표와 오판 기록 같은 서사는 위키나 볼트 문서에, 반복할 절차는 SKILL.md에, 한 줄 규칙은 CLAUDE.md에 적습니다. 우리는 8월 25일 방법론 문서, 26일 codex-score-loop 스킬, 프로젝트 규칙 6번 순서로 굳혔습니다.
루프 엔지니어링이 쓸수록 똑똑해진다는 건 무슨 뜻인가요?
모델이 배운다는 뜻이 아닙니다. 안쪽 루프의 교훈이 바깥쪽 루프를 통해 디스크에 남고, 다음 안쪽 루프가 그것을 딛고 시작하므로 첫 라운드의 출발점이 매번 올라간다는 뜻입니다. 홈 32라운드가 admin 8라운드, 결제 diff 4라운드로 줄어든 것이 그 결과입니다.
사람 팀의 사내 문서화와 무엇이 다른가요?
적은 것이 다음 실행에 자동으로 실린다는 점입니다. 사내 위키는 사람이 찾아 읽어야 효과가 나지만, CLAUDE.md는 세션 시작 시 로드되고 스킬은 description이 맞으면 자동 호출되며 훅은 규칙을 강제합니다. 그래서 무엇을 어느 층에 적을지가 문서화보다 훨씬 중요합니다.