서브에이전트를 언제 쓰고 언제 쓰지 않는지

좋다는 말은 들었는데 어디에 써야 할지 모르겠다는 분이 많습니다.

쓰면 좋은 자리와 오히려 느려지는 자리가 나뉩니다.

저희가 써 보면서 정한 기준을 적어 봅니다.

별도의 문맥에서 도는 보조 작업자입니다.

일을 맡기면 그쪽에서 처리하고 결과만 돌려줍니다.

중간 과정은 이쪽 대화에 쌓이지 않습니다.

그래서 긴 작업을 맡겨도 이쪽이 지저분해지지 않습니다

파일을 백 개 뒤지는 일을 시켜도 결론만 돌아옵니다.

쓰는 이유의 절반이 이것입니다.

결과만 필요한 조사 작업입니다.

여러 파일을 뒤져서 어디에 무엇이 있는지 찾는 일이 대표적입니다.

그 과정을 다 볼 필요가 없는 일이면 맡기는 편이 낫습니다.

검색을 직접 시키면 안 되나요

되지만 중간 결과가 전부 쌓입니다.

그러면 정작 중요한 이야기가 밀려납니다.

결과만 필요한 일은 맡기고, 과정을 봐야 하는 일은 직접 시킵니다.

서로 상관없는 일이 여럿이면 한꺼번에 굴릴 수 있습니다.

기다리는 시간이 줄어듭니다.

다만 서로 같은 파일을 고치면 부딪칩니다

조사처럼 읽기만 하는 일은 겹쳐도 괜찮습니다.

고치는 일을 동시에 여럿 시키면 문제가 생깁니다.

한 번에 끝나는 간단한 일입니다.

파일 하나를 열어 보는 정도면 그냥 직접 하는 게 빠릅니다.

맡기는 데도 준비 시간이 들기 때문입니다.

어느 정도면 맡길 만한가요

중간 결과가 길게 쌓일 것 같으면 맡기십시오.

짧게 끝날 일이면 직접 하는 편이 낫습니다.

맡길 때는 무엇을 돌려받고 싶은지를 먼저 적습니다.

"찾아봐" 보다 "어느 파일 몇 줄에 있는지 목록으로" 가 낫습니다.

형태를 정해 주지 않으면 원하는 것과 다른 게 돌아옵니다

별도 문맥이라 이쪽 사정을 모릅니다.

그래서 필요한 배경을 함께 적어 주셔야 합니다.

도구를 좁힐 수 있습니다

그 작업자가 쓸 도구를 지정할 수 있습니다.

조사만 시킬 거면 읽기와 검색만 열어 둡니다.

쓰기를 열어 두지 않으면 실수로 파일을 고칠 일이 없습니다.

범위를 좁혀 두는 것만으로 사고가 줄어듭니다

여러 사람이 함께 쓰는 프로젝트라면 특히 그렇습니다.

열어 둘 이유가 없는 도구는 닫아 두는 편이 맞습니다.

매번 설명하지 않으려면 파일로 정의해 둘 수 있습니다.

`.claude/agents` 아래에 파일로 둡니다.

거기에 어떤 일을 하는지, 어떤 도구를 쓰는지 적어 둡니다.

스킬이랑 뭐가 다른가요

스킬은 절차를 묶은 것이고, 이쪽은 일을 맡을 사람을 정의하는 것입니다.

둘을 같이 쓰는 경우도 많습니다.

돌려받는 결과의 형태를 정해 두면 다시 물어볼 일이 줄어듭니다.

정하지 않으면 매번 다른 모양으로 돌아옵니다.

형태를 정해도 다르게 오는데요

예시를 하나 붙여 주십시오. 말로 설명하는 것보다 훨씬 정확하게 맞습니다.

원하는 모양을 한 줄 보여 주는 것이 설명 열 줄보다 낫습니다

저희는 자주 쓰는 형태를 아예 정의 파일에 적어 뒀습니다.

그 뒤로는 형태를 두고 왕복하는 일이 없어졌습니다.

우선 오늘 한 일 중에 중간 과정이 길게 쌓였던 작업을 떠올려 보십시오.

그게 맡기기 좋은 후보입니다.

다음에 같은 일이 생기면 결과의 형태를 먼저 적고 맡겨 보십시오.

한 번만 해 보시면 차이를 바로 느끼실 겁니다.

과정을 안 봐도 되는 일이 생각보다 많습니다.

결과가 이상하면 어떻게 하나요

다시 시키시면 됩니다. 대개 지시에 배경이 빠져 있어서 생기는 일입니다.

그다음 그 일을 맡길 때 필요한 배경이 무엇인지 적어 보십시오.

이 프로젝트가 뭘 하는 것인지, 어디를 봐야 하는지 같은 것들입니다.

별도 문맥이라 이쪽에서 오간 이야기를 모릅니다.

배경을 빼먹으면 엉뚱한 자리를 뒤집니다.

그럼 설명이 길어지지 않나요

한 번 적어 두고 정의 파일에 넣으면 다음부터는 안 적어도 됩니다. 그게 정의해 두는 이유입니다. 자주 맡기는 일일수록 효과가 큽니다.

결과만 필요한 일인지부터 물어보시면 판단이 쉬워집니다

#클로드코드 #서브에이전트 #AI자동화 #업무자동화 #개발도구 아비컴퍼니 드림