캡스톤 실습 — 나만의 워크플로우 설계하기

지금까지 배운 개념(2장·3장)과 도구(4장), 조직 운영 감각(7장), 워크스페이스 구조(5장·8장)를 한데 모아, 아주 작은 규모라도 처음부터 끝까지 직접 설계·실행하는 마지막 실습이다. 정답은 하나가 아니다. 이 장은 "무엇을 만들지"가 아니라 "어떤 순서로 결정해야 빠지는 부분 없이 만들 수 있는지"를 가이드한다.

이 실습의 목표

4장 §2에서는 미리 정해진 시나리오(reviewer, writer)를 따라 했고, 11장에서는 정해진 domain(co-retail)으로 베리언트(variant)를 만들어봤다. 이번에는 시나리오도 domain도 본인이 정한다. 규모는 작아도 된다. 실제로 매주 반복하는 5분짜리 잡무 하나면 충분하다. 중요한 것은 "이 결정을 왜 이 순서로 내렸는가"를 스스로 설명할 수 있게 되는 것이다.

1단계 — 문제 정의와 팀 설계

2단계 — 가드레일 먼저 정하기

3장의 원칙대로, 서브에이전트를 실제로 만들기 전에 권한부터 정한다. 아래 표를 채워본다.

이 세 질문의 답이 곧 서브에이전트 frontmatter의 tools 필드와, 오케스트레이터에게 지시할 때 넣을 "여기까지만 하고 멈춰" 문구가 된다.

3단계 — 서브에이전트 정의와 워크플로우 구현

4장 §2 실습에서 했던 것과 같은 방식으로, Claude Desktop App(또는 Code)에서 채팅으로 직접 서브에이전트를 만들어 달라고 요청한다. 아래는 채워 넣을 빈 틀이다. 대괄호 부분을 본인의 답으로 바꿔 채팅창에 붙여넣는다.

[역할 이름]이라는 이름의 서브에이전트를 .claude/agents/[역할 이름].md에 만들어줘.
[이 에이전트가 하는 일 한 문장]. tools는 [2단계에서 정한 최소 권한]만 허용하고
model은 [1장·5장에서 배운 기준으로 고른 티어]로 설정해줘.

스페셜리스트가 둘 이상이라면 D-1 시나리오처럼 각각 만든 뒤, 마지막에 "두 단계를 순서대로 진행해" 또는 "동시에 진행해"처럼 오케스트레이션 방식을 명시적으로 지시한다. 어느 쪽을 선택했는지, 그리고 1장 §4b에서 배운 것처럼 이 선택이 요청의 의존 관계에 따라 달라진다는 점을 스스로 확인한다.

4단계 — 검증과 회고

실제로 한 번 실행해본 뒤, 아래 질문에 답해본다.

• 결과가 기대한 형식(핸드오프 계약)대로 나왔는가? 그렇지 않다면 서브에이전트의 description이 애매했던 것은 아닌가?
• 2단계에서 정한 가드레일이 실제로 지켜졌는가? 혹시 tools를 필요 이상으로 넓게 준 곳은 없는가?
• 이 워크플로우를 정기적으로 반복해야 한다면, 11장에서 배운 것처럼 나중에 variant나 재사용 가능한 스킬로 승격할 가치가 있는가?

완료 체크리스트

수료 후 다음 단계

이 핸드북은 여기서 끝나지만, 실제 적용은 이제부터 시작이다. 오늘 설계한 워크플로우를 실제 업무에 적용해보고 나면 다음 세 방향 중 하나로 자연스럽게 이어진다.