개발·디자인·QA 세 관점 기획서 검토를 동시에, 클로드 코드 서브에이전트 만들기

이런 분께

기획서 공유 전에 개발·디자인·QA 질문을 미리 걸러 두고 싶은 기획자·PM께 맞아요. 클로드 코드(Claude Code)에 서브에이전트(한 역할만 맡는 보조 AI)를 셋 만들어 두면 세 관점 검토가 동시에 돌아요.

끝나면 이렇게 됩니다

예시 기획서("모임 신청 기능")를 세 검토 기준으로 돌려 본 결과예요. 겹친 지적은 합쳐 review.md로 저장돼요.

준비물

• 클로드 Pro 이상 요금제. 공식 문서 기준 무료 요금제에는 클로드 코드가 들어 있지 않아요(2026년 11월 기준).
• 클로드 코드 설치. 터미널(컴퓨터에 글자로 명령하는 창)을 열고 아래 한 줄을 붙여 넣어요.
  • 윈도우: 시작 메뉴에서 'PowerShell' 검색 후 실행, irm https://claude.ai/install.ps1 | iex
  • 맥: Spotlight에서 '터미널' 검색 후 실행, curl -fsSL https://claude.ai/install.sh | bash
  • 새 터미널 창에서 claude --version을 쳐서 숫자가 나오면 끝
• 검토할 기획서를 마크다운이나 텍스트 파일로(예: spec.md)

따라 하기

1. 바탕화면에 spec-review 폴더를 만들어 spec.md를 넣고, 그 안에 .claude\agents 폴더를 만들어요.
2. agents 폴더에 아래 파일 세 개를 메모장으로 만들어 저장해요. --- 사이가 이름·설명, 그 아래가 검토 기준이에요.
3. 터미널에서 폴더로 이동해 클로드 코드를 켜요: cd Desktop/spec-review 다음 claude. 처음이면 브라우저 로그인 안내를 따라요.
4. 아래 실행 문장을 붙여 넣어요. 셋이 동시에 검토하고 클로드가 결과를 모아 저장해요.
5. 한 명만 다시 부르고 싶으면 @"qa-reviewer (agent)" 4번 취소 규칙만 다시 봐 줘처럼 이름을 콕 집어요.

복사해서 쓰는 프롬프트

파일 1: .claude/agents/dev-reviewer.md

---
name: dev-reviewer
description: 기획서를 개발자 관점에서 검토한다. 기획서 검토를 요청받으면 쓴다.
tools: Read, Glob, Grep
---
너는 [서비스 종류] 개발 리드야. 기획서를 읽고 구현할 때 막힐 곳만 찾아.
- 동시에 일어나는 상황, 실패했을 때 처리, 외부 서비스 연동, 정해지지 않은 숫자
- 지적마다 기획서 위치(목차 번호)와 제안 한 줄
- 칭찬이나 요약은 쓰지 마

파일 2·3은 복사해서 name, 역할, 점검 줄만 바꿔요.

• design-reviewer: 프로덕트 디자이너 / 화면 상태(빈 화면·오류·마감), 버튼 문구, 헷갈리는 흐름
• qa-reviewer: QA 담당 / 기준이 애매한 말(전날·빠르게 등), 빠진 예외, 테스트할 수 없는 문장
• [서비스 종류] 예: 모임 신청 앱

실행 문장