Claude Code 스킬을 더 깔았더니 일이 늘었다: 같은 질문과 승인이 반복되는 이유

Claude Code 스킬을 여러 개 붙이면 각 절차가 앞 단계의 결정을 다시 묻는다. 스킬을 늘리기 전에 지금 남은 불확실성과 기존 증거 사이의 빈칸부터 보는 법.

공유
스킬을 더 붙였는데 내가 더 바빠졌다

스킬을 더 붙였는데 내가 더 바빠졌다. 에이전트에게 일을 맡기려던 사람이 어느새 질문에 답하고, 명세 두 벌을 비교하고, 리뷰어 사이의 의견 차이를 중재한다. 좋은 개발 절차를 모아 놓았으니 결과도 좋아질 것 같았는데, 정작 하루가 끝날 때까지 자신이 무엇을 결정했는지 다시 정리해야 한다.

여기서 스킬은 Claude Code가 읽는 작업 지침 묶음이다. 공식 문서에 따르면 스킬은 SKILL.md 파일 하나에 언제 쓸지 적은 머리말과 따를 지침을 담는다. 개인용은 ~/.claude/skills/, 프로젝트용은 .claude/skills/ 아래에 두고, 플러그인으로 받은 스킬은 /플러그인:스킬 이름으로 붙는다. Claude는 머리말의 설명을 보고 스킬을 스스로 꺼내 쓰거나, 사용자가 /스킬이름으로 직접 부른다. 붙이는 일이 폴더 하나를 두는 정도라 여러 개를 쉽게 쌓을 수 있고, 이 글의 문제도 거기서 시작한다.

가상의 장면을 하나 놓아 보자. 작은 유료 서비스를 준비하는 사람이 제품 요구사항을 문서 도구에 적었다. 개발 에이전트에게 넘기자 인터뷰가 시작된다. 인터뷰를 마친 뒤 설계 스킬을 켜니 다른 대안을 비교하겠다고 한다. 구현을 시작하려는 순간 별도의 작업 관리 절차가 전체 명세와 세부 명세를 요구한다. 리뷰 결과에는 앞서 정한 제품 범위를 다시 묻는 의견이 섞여 있다. 각각의 요청만 읽으면 모두 신중하다. 이어서 겪는 사람에게는 같은 일을 여러 번 설명하는 하루가 된다.

이 장면은 특정 도구의 사용 결과를 관찰한 보고가 아니다. pstack, do-the-thing, Manyfast, 가설 먼저 개발의 문서를 함께 읽으며 예상한 결합 비용이다. 네 가지 모두 나름의 실패를 막으려 한다. 문제는 도구를 추가할 때 그 실패가 아직 남아 있는지 확인하지 않는 데서 생긴다. 이미 결정한 요구를 다시 묻는 인터뷰와, 아직 모르는 요구를 찾는 인터뷰는 겉모양이 같다.

절차가 사람의 주의력을 돌려주려면 앞선 절차의 결과를 받아들여야 한다. 새 단계가 시작될 때마다 설명과 승인이 초기화된다면, 에이전트가 처리하는 작업량이 늘어도 사용자가 감독해야 할 지점은 줄지 않는다. 도입할 절차를 고를 때는 이름이나 완성도보다, 지금 남은 불확실성과 기존 증거 사이에 어떤 빈칸이 있는지부터 봐야 한다.

인터뷰·설계 비교·명세·리뷰 단계가 약속·범위·근거를 넘겨야 하며, 사람에게 돌아온 질문을 인계 실패의 비용과 사람이 판단할 질문으로 나눈 비교도

각자 성실한 절차가 만날 때

pstack의 설계 스킬 architect는 구현 전에 구조적으로 다른 설계안을 최소 두 개 만들고 종합하도록 한다. 코드를 쓰기 시작하면 첫 구조에 매달리기 쉬우므로, 먼저 선택지를 벌려 보는 방식이다. 또 기본 흐름에서는 설계 종합 뒤 사람의 확인을 기다리지 않고 구현으로 넘어간다. 확인 단계는 사용자가 요청할 때 켠다. pstack 자체가 모든 설계에서 재승인을 요구한다는 비판은 정확하지 않다.

이 차이는 중요하다. 설계안을 둘 만드는 계산 비용과, 사람에게 둘 중 하나를 고르게 하는 주의력 비용은 다르다. 에이전트가 대안을 비교하고 근거를 남겨 구현한다면 사람에게 새로운 일이 생기지 않을 수도 있다. 반대로 이미 결정된 구조를 바꾸는 문제까지 대안 탐색에 섞으면, 사용자는 구현을 맡긴 뒤 다시 설계 회의에 들어가게 된다. 어느 경우가 벌어지는지는 대안의 개수보다 결정 권한을 어떻게 넘겼는지에 달렸다.

do-the-thing의 현재 설치본은 이런 중복을 피하는 규칙을 명시한다. 명확하고 위험이 낮은 작은 작업은 큰 명세와 세부 명세 없이 처리한다. 기존 인터뷰와 명세를 받았다면 유효한 답과 기준을 보존하고, 처음부터 다시 시작하지 않는다. 이 글이 비판하는 대상은 그 규칙 자체보다, 다른 절차를 붙이는 과정에서 이 보존 규칙이 사라지는 사용법이다. 한쪽에서 끝낸 질문이 다른 쪽에서는 미응답으로 취급될 때 사람이 다시 호출된다.

따라서 절차를 더 쓸지 결정하는 기준은 만들 문서의 개수가 될 수 없다. 아직 모르는 요구가 있으면 인터뷰가 필요하고, 여러 모듈에 걸친 구조가 불분명하면 설계 비교가 필요하다. 이미 답한 질문과 검증한 기준은 다음 단계의 입력으로 남겨야 한다. 이 원칙을 지키면 절차를 충분히 쓰면서도 반복을 줄일 수 있다. 다만 기존 결정을 받아들이려면, 다음 에이전트가 그 결정이 왜 유효한지 읽을 수 있어야 한다.

더 읽기