에이전트로 자동화하기

요즘 반복하는 업무를 두세 개 적습니다.

후보마다 입력·판단·출력을 한 줄씩 적습니다.

판단이 적고 반복이 잦은 후보를 고릅니다.

되돌리기 어려운 단계가 있으면 승인 지점으로 표시합니다.

고른 하나와 고른 이유를 workflow.md에 적습니다.

반복해서 같은 설명을 붙여 시키는 일 하나를 고르고, 그 일을 언제 시키는지 한 줄로 적습니다.

Claude에게 정의 파일을 만들어 달라고 요청합니다.

내가 반복해서 시키는 일이 있어. [여기에 그 일을 한 줄로]. 이걸 맡을 서브에이전트 정의를 만들어 줘. 공식 서브에이전트 제작 가이드를 따라 줘. 설명(description)은 언제 이 에이전트에 넘겨야 하는지가 드러나게 써 주고, 파일을 만들기 전에 어떤 도구까지 허용할지 나한테 먼저 물어봐 줘.

예상 결과 허용할 도구를 먼저 확인하는 질문이 오고, 답한 뒤 `.claude/agents/` 아래에 정의 파일이 생깁니다.

만들어진 파일을 열어 이름과 설명이 의도대로 적혔는지 봅니다.

설명이 호출 여부를 결정하니 여기가 제일 중요합니다.

방금 만든 정의는 지금 세션에서는 아직 안 보이므로, 대화를 끝내고 새로 시작합니다.

새 세션에서, 설명에 적은 상황을 실제로 만들어 에이전트가 불려 나오는지 확인합니다.

방금 만든 에이전트가 맡기로 한 그 일을, 에이전트 이름은 대지 않고 평소 말하듯 요청할게. [여기에 평소 하던 요청].

예상 결과 이름을 대지 않았는데도 그 에이전트에게 작업이 넘어갑니다. 안 넘어가면 설명 문장이 상황과 안 맞는 것입니다.

요구사항, 작업자 사이 소통 필요, 완료 조건을 확인한 뒤 아래 표에서 실행 방식을 고릅니다.

짧거나 순서대로 진행해야 하는 작업은 한 세션에서 처리합니다.

설치하기로 했다면 공식 저장소 주소와 추가되는 기능을 확인한 뒤, 현재 프로젝트에만 적용합니다.

OMC 공식 저장소와 Claude Code 플러그인 안내를 확인해 줘. 설치 전에 출처, 추가되는 스킬·에이전트·훅, 현재 프로젝트에만 적용하는 방법을 표로 보여 주고 아직 설치하지 마.

예상 결과 공식 출처와 추가 기능, 적용 범위가 정리되고 설치 전 상태에서 멈춥니다.

비밀 정보·결제·삭제가 없는 작은 연습 작업으로 고른 모드 하나를 실행합니다.

연습 폴더 안의 안내 문서 한 장을 대상으로 [고른 모드]를 써 줘. 바꿀 파일, 완료 조건, 실행할 검사를 먼저 보여 주고 그 범위 안에서만 진행해 줘.

예상 결과 작업 전 범위와 완료 조건이 보이며 실행 뒤 바뀐 파일과 검사 결과가 남습니다.

Claude의 완료 설명과 실제 파일·검사 출력을 대조합니다.

둘이 다르면 완료로 표시하지 않고 원인을 적습니다.

매주나 매일 반복하는 일 하나를 고르고, 지금 손으로 어떤 순서로 하는지 단계별로 적습니다.

각 단계를 어디에 둘지 정하도록 요청합니다.

내가 반복하는 일이 있어. 지금 손으로 하는 순서는 이래. [여기에 단계별로]. 이걸 자동화하려고 해. 각 단계를 내가 직접 할 것·서브에이전트에 맡길 것·훅으로 자동 실행할 것 중 어디에 둘지 나눠 주고, 나눈 이유를 한 줄씩 붙여 줘. 아직 파일은 만들지 마.

예상 결과 단계마다 직접·에이전트·훅 중 한 가지 수행 방법이 정해지고, 규모나 독립성을 근거로 든 이유가 붙습니다.

나온 배치를 보고 위임으로 간 단계가 정말 앞 대화를 몰라도 되는 일인지 확인합니다.

아니면 직접으로 옮깁니다.

확정한 배치대로 필요한 에이전트를 만듭니다.

방금 확정한 배치대로 필요한 서브에이전트를 만들어 줘. 공식 서브에이전트 제작 가이드를 따르고, 설명(description)에는 언제 이 에이전트에 넘겨야 하는지를 적어 줘. 역할이 겹치는 에이전트는 만들지 말고 하나로 합쳐 줘.

예상 결과 배치에 필요한 만큼만 정의 파일이 생기고, 역할이 겹치는 것은 합쳐집니다.

실제 일감 하나로 처음부터 끝까지 한 바퀴 돌립니다.

이번 주 실제 일감으로 방금 만든 흐름을 처음부터 끝까지 한 번 돌려 줘. 중간에 막히면 멈추고 어디서 왜 막혔는지 알려 줘.

예상 결과 한 바퀴가 실제로 돌고, 멈춘 단계가 있으면 그 단계와 이유가 나옵니다.

자동화한 흐름에서 결과가 어긋나면 가장 곤란해지는 단계 하나를 고릅니다.

통과 기준을 먼저 정하도록 요청합니다.

내가 자동화한 [단계 이름]의 결과가 쓸 만한지 판단하는 기준을 정하려고 해. 눈으로 봐서 아는 것 말고, 확인할 수 있는 형태로 기준을 3개 이내로 제안해 줘. 각 기준을 무엇으로 확인하는지도 함께 적어 줘.

예상 결과 확인 가능한 기준 3개 이내가 나오고, 기준마다 무엇으로 확인하는지가 붙습니다.

나온 기준 중 사람이 봐야만 아는 것과 기계가 확인할 수 있는 것을 가릅니다.

기계가 확인할 수 있는 기준을 훅으로 걸어 둡니다.

방금 정한 기준 중 명령으로 확인할 수 있는 것을 Hook으로 등록해 줘. 동작 전에 막아야 하는지, 동작 뒤에 결과만 알려 주면 되는지 먼저 구분하고, 선택한 시점과 실패 동작을 설명해 줘.

예상 결과 검사의 목적에 따라 PreToolUse 또는 PostToolUse가 선택되고, 실패할 때 실제로 무엇이 멈추는지 설명됩니다.

일부러 어긋난 입력을 넣어 게이트가 실제로 막는지 확인합니다.

방금 건 검사가 실제로 걸리는지 보려고 해. 기준을 일부러 어기는 경우를 하나 만들어서 돌려 주고, 검사가 잡아내는지 확인해 줘.

예상 결과 어긋난 경우에 검사가 걸리고 흐름이 멈춥니다. 안 걸리면 게이트가 실제로 동작하지 않는 것입니다.