내 저장소에 Loop Engineering을 설정하는 Claude Skill을 만들었습니다

몇 달 동안 저는 대부분의 사람들이 그러하듯 코딩 에이전트(coding agent)를 동일한 방식으로 사용했습니다. 프롬프트(prompt)를 작성하고, 답변을 읽고, 다음 프롬프트를 작성하는 방식이었죠. 제가 바로 그 루프(loop)였습니다. 다음에 무엇이 올지 결정하고, 경로에서 벗어날 때 이를 알아차리는 주체가 바로 저였습니다.

Loop engineering(루프 엔지니어링)이 그 해결책이며, 저는 이를 단 한 번의 명령으로 실행할 수 있는 Claude Code skill로 만들었습니다.

Repo: github.com/sxivansx/loop-engineering

Loop engineering이란 실제로 무엇인가

Loop engineering은 당신이 직접 차례대로 에이전트에게 프롬프트를 입력하는 대신, 당신을 대신해 에이전트에게 프롬프트를 제공하는 시스템을 설계하는 것입니다. 당신은 목표(goal)와 중단 조건(stop condition)을 한 번만 정의합니다. 그러면 루프가 작업을 찾아내고, 수행하며, 별도의 에이전트로 이를 검증하고, 발생한 일을 기록한 뒤, 목표가 달성될 때까지 다시 실행합니다.

이는 트리거(trigger), 상태 파일(state file), 탐색 단계(discovery step), 메이커(maker), 체커(checker), 그리고 중단 조건(stop condition)이라는 6가지 부분으로 구성됩니다. 이것이 전체 어휘입니다. 이 skill은 당신이 매번 수동으로 연결할 필요가 없도록 이 요소들을 조립해 줍니다.

이 skill이 하는 일

설치한 후, 루프의 목표와 함께 실행하세요:

/loop-engineering keep the main branch's CI green

그다음부터는 설정을 진행하며 당신의 저장소(repo)에 작동하는 루프를 스캐폴딩(scaffolding)합니다:

1. 목표를 고정하고, 대부분의 사람들이 건너뛰는 한 가지, 즉 검증 가능한 중단 조건(verifiable stop condition)을 요청합니다.

결과물:

your-project/
├── LOOP.md
├── .claude/
...

예약된 작업(scheduled job), 푸시(push), 또는 배포(deploy)와 같이 부수 효과(side effects)를 동반하는 작업은 사용자의 확인 없이는 아무것도 일어나지 않습니다.

설치 방법

git clone https://github.com/sxivansx/loop-engineering ~/.claude/skills/loop-engineering

이렇게 하면 모든 프로젝트에서 /loop-engineering을 사용할 수 있습니다. 만약 단일 저장소(repo)에만 커밋하고 싶다면, 해당 저장소의 .claude/skills/ 디렉토리에 클론(clone)하세요. 폴더 이름이 명령어가 되므로 loop-engineering으로 유지해야 합니다.

내가 내장한 가드레일 (Guardrails)

자율적인 루프(autonomous loop)는 실수를 배포하는 자율적인 방법이기도 합니다. 따라서 이 스킬은 다음 조건 없이는 루프 설정을 거부합니다:

• 검증자(checker)는 결코 제작자(maker)가 될 수 없습니다. 코드를 작성한 에이전트(agent)가 스스로 그것이 올바르다고 말할 수 없습니다.
• 중단 조건(stop condition)은 막연한 느낌(vibe)이 아니라, 통과되는 명령(command)이어야 합니다.
• 상태(state)는 매 사이클마다 기록되므로, 루프가 이미 시도했던 작업을 반복하지 않습니다.
• 병합(merging), 배포(deploying), 삭제(deleting), 비용 지출(spending money)과 같이 되돌릴 수 없는 모든 작업에는 인간의 게이트(human gate)가 유지됩니다.
• 루프가 무언가를 검증할 수 없을 때는 추측하는 대신 인간에게 플래그(flag)를 표시합니다.

이것을 만들면서 계속 되새겼던 문장입니다. 두 사람이 정확히 동일한 루프를 설정하더라도 정반대의 결과를 얻을 수 있습니다. 한 사람은 자신이 이해하고 있는 작업을 더 빠르게 진행하기 위해 루프를 사용합니다. 다른 사람은 작업을 전혀 이해하지 않기 위해 루프를 사용합니다. 루프는 그 차이를 모릅니다. 당신은 알고 있습니다.

제작 이유

코드를 나의 것으로 만드는 판단력(judgment)을 넘겨주지 않으면서도, 모든 단계에서 병목 현상(bottleneck)이 되는 것을 멈추고 싶었습니다. 루프가 제대로 구축된다면 바로 그 역할을 수행합니다. 루프는 지루한 사이클을 실행하고, 나는 그것이 배포한 내용을 읽고 책임지는 엔지니어로 남습니다.

만약 당신이 동일한 작업을 수행하기 위해 에이전트에게 반복적으로 수동 프롬프팅(hand-prompting)을 해왔다면, 이것이 바로 제가 한 달 전에 가졌기를 바랐던 것입니다. 클론(clone)하고, 짜증 나는 반복 작업 하나를 지정한 뒤, 가드레일을 켜둔 채로 사용하세요.

다운로드: github.com/sxivansx/loop-engineering

Shivansh Pandey 작성. 루프 엔지니어링 (Loop Engineering)의 개념은 Peter Steinberger와 Boris Cherny에 의해 명확히 정의되었으며, Addy Osmani에 의해 종합되었습니다.