로드맵 + Shrimp Task Manager 워크플로우
AI에게 “쇼핑몰 만들어줘”, “인스타그램 같은 SNS 만들어줘” 한마디로 통째로 던져본 사람이라면 결과가 만족스럽지 않았을 것이다. 똑똑한 작업 관리 도구를 붙여도 마찬가지다. 큰 단위는 사람이 직접 로드맵으로 쪼개고, 세부 작업만 Shrimp Task Manager에 위임하는 분업이 가장 안정적이다. 이 글은 그 워크플로우를 설치부터 실전 사용까지 정리한다
큰 프로젝트를 한 번에 위임하면 두 가지 문제가 생긴다
첫째, 작업을 효과적으로 분리하지 못한다. 작업 관리 도구는 입력의 구체성에 비례해 동작한다. 추상적인 요청은 분해 결과도 추상적이다
둘째, 작업 순서가 비효율적이다. AI는 종종 기능별 순차 개발을 제안한다. 로그인 → 게시판 → 결제 식이다. 현업 경험이 있다면 알 텐데, 효율적인 순서는 기능별이 아니다. 전체 구조 정의 → 레이아웃 → 공통 UI·공통 기능 → 개별 기능 순서로 진행해야 중복 작업이 줄고 일관성이 유지된다
해결책은 단순하다. 큰 단위는 사람이 방향성에 맞게 나누고, 그 결과로 나온 단계별 작업을 Shrimp Task Manager에 넘긴다. AI는 복잡성이 낮은 작업을 받았을 때 결과 품질이 가장 좋다
Shrimp Task Manager는 무엇을 해주는가
Shrimp Task Manager는 AI 에이전트를 위한 개발 워크플로우 프레임워크다. 단순한 태스크 트래커가 아니라 chain-of-thought, reflection, style consistency를 자동으로 적용하는 MCP 서버다. 별도의 프롬프트 엔지니어링 지식이 없어도 다음 세 가지를 얻는다.
- 복잡한 요구사항을 단계별 실행 가능한 작업으로 분해
- 분해된 작업의 의존성 추적과 순차 실행
- 세션이 끊겨도 유지되는 작업·메모리 컨텍스트
라이선스는 MIT, 무료다!
로드맵부터 만든다 – development-planner 서브 에이전트
로드맵은 PRD를 분석해 단계별 개발 계획으로 변환한 문서다. 직접 작성해도 되지만 Claude Code 서브 에이전트로 자동화하면 재사용성이 크다
development-planner라는 서브 에이전트를 만든다. 핵심 시스템 프롬프트는 다음과 같다
당신은 최고의 프로젝트 매니저이자 기술 아키텍트입니다. 제공된 Product Requirements Document(PRD)를 면밀히 분석하여 개발팀이 실제로 사용할 수 있는 ROADMAP.md 파일을 생성해야 합니다.
이 서브 에이전트는 구조 우선 접근법을 따른다. 결과물인 ROADMAP.md는 보통 네 단계로 나뉜다
| 단계 | 작업 | 목적 |
|---|---|---|
| 1 | 애플리케이션 골격 구축 | 초기 설정, 레이아웃, 페이지·타입·데이터 모델 정의 |
| 2 | UI 목업 작성 | 기능 없는 정적 페이지로 기획·UX 다듬기 |
| 3 | 핵심 기능 구현 | API 연동, 비즈니스 로직, Playwright MCP로 테스트 |
| 4 | 최적화 | 성능·안정성 보강 |
Claude Code에서 다음과 같이 호출한다
@development-planner PRD 문서를 분석해서 docs/ROADMAP.md 파일을 생성해줘
서브 에이전트는 한 번에 완성되지 않는다. 결과물을 보고 수정하고 다시 사용해보고 다시 수정하는 반복을 거쳐야 한다. Anthropic 프롬프트 엔지니어링 가이드 역시 프롬프트는 지속 개선해야 한다고 명시한다
로드맵도 살아있는 문서다. 예를 들어 “핵심 기능 구현 시 Playwright MCP로 테스트를 꼼꼼히 진행한다”는 규칙을 추가하고 싶다면 서브 에이전트와 ROADMAP.md를 함께 수정한다. 컨텍스트는 한 번 만들고 끝나는 자산이 아니다
Shrimp Task Manager 설치
설치 전제는 다음과 같다
- Node.js 18+
- MCP 호환 AI 클라이언트 (Claude Code, 커서 AI, Cline 등)
저장소를 클론하고 빌드한다
git clone https://github.com/cjo4m06/mcp-shrimp-task-manager.git cd mcp-shrimp-task-manager npm install npm run build
Claude Code에서 사용하기
프로젝트 루트에 .mcp.json 파일을 만든다
{
"mcpServers": {
"shrimp-task-manager": {
"command": "node",
"args": ["/절대경로/mcp-shrimp-task-manager/dist/index.js"],
"env": {
"DATA_DIR": "/절대경로/현재프로젝트/shrimp_data",
"TEMPLATES_USE": "en",
"ENABLE_GUI": "true"
}
}
}
}
설정값의 의미는 다음과 같다
args: 빌드 결과물인dist/index.js를 가리켜야 한다. 빌드를 건너뛰면 동작하지 않는다.DATA_DIR: 작업 목록·메모리·태스크 데이터가 저장되는 경로다. 프로젝트마다 분리하면 컨텍스트가 섞이지 않는다.TEMPLATES_USE: 내부 프롬프트 템플릿 언어다.en(영어)과zh(중국어 번체)가 기본 제공된다. 한국어 커스터마이징은 저장소의src/prompts/templates_ko/디렉토리를 만들고templates_en내용을 번역해 넣으면 된다. 도구 내부 프롬프트라 영어로 둬도 무방하다.ENABLE_GUI:true로 두면 작업 목록을 시각화하는 웹 GUI가 활성화된다.
설치 검증은 다음 명령으로 한다
claude mcp list
shrimp-task-manager가 Connected로 표시되면 정상이다
주요 기능 한눈에
| 기능 | 역할 |
|---|---|
| Init Project Rules | 코드베이스를 스캔해 프로젝트 규칙 파일(shrimp-rules.md) 생성 |
| Plan Task | 큰 요청을 단계별 작업으로 분해 |
| Analyze Task | 기술적 요구사항·리스크 심층 분석 |
| Reflect Task | 계획에서 놓친 부분, 더 나은 방법 검토 |
| Execute Task | 분해된 작업을 단계별로 실행 |
| List Tasks | 대기·완료 작업 현황 확인 |
| Research Mode | 기술 학습·조사가 필요할 때 사용 |
| Task Delete / Update | 마음에 들지 않는 작업 삭제·수정 |
Plan Task는 내부적으로 Analyze Task와 Reflect Task를 함께 호출한다. 분석과 검토를 거친 결과물이 나오기 때문에 별도 프롬프트 엔지니어링 없이도 chain-of-thought, reflection이 자동 적용된다
실전 워크플로우
전체 흐름은 다음과 같다
PRD 작성 ↓ development-planner 서브 에이전트로 ROADMAP.md 생성 ↓ init project rules 실행 → shrimp-rules.md 생성 ↓ ROADMAP의 1단계 → plan task로 세부 작업 분해 ↓ list tasks → execute task → 완료 → 다음 task ↓ ROADMAP의 2, 3, 4단계 반복
init project rules로 프로젝트 규칙 만들기
Claude Code에 다음 한 줄을 입력한다
init project rules
결과물인 shrimp-rules.md에는 프로젝트 개요, 디렉토리 구조, 기술 스택, 컨벤션 등이 담긴다. Shrimp Task Manager가 작업을 분해할 때 이 파일을 참조한다. 룰이나 기술 스택이 바뀌면 다시 실행해 갱신한다
plan task로 세부 작업 분해
ROADMAP의 한 단계를 Plan Task에 넘긴다
plan task @docs/ROADMAP.md 의 1단계 "애플리케이션 골격 구축"을 세부 작업으로 분해해줘
분해된 작업이 너무 거칠면 같은 단계를 더 잘게 쪼개달라고 다시 요청한다. 분해 단위가 작을수록 전체 시간은 늘지만 결과 품질은 올라간다
list tasks와 execute task
list tasks
현재 계획된 작업 목록과 진행 상황이 출력된다. 작업 ID나 작업명으로 실행 대상을 지정한다
execute task 프로젝트 초기 설정 및 환경 구성
작업이 끝나면 list tasks로 남은 작업을 확인하고 다음 task를 실행한다. 오류가 발생하면 메시지를 그대로 복사해 해결을 요청한 뒤 다음 단계로 넘어간다
자동 승인이 필요하면 클라이언트별로 다음 옵션을 사용한다
| 환경 | 자동 실행 옵션 |
|---|---|
| Claude Code (외부 터미널) | claude --permission-mode auto 또는 claude --dangerously-skip-permissions |
| JetBrains 통합 터미널 | 위 옵션을 통합 터미널에서 동일하게 사용 |
continuous mode로 끝까지 자동 실행
continuous mode로 모든 작업을 실행해줘
수동 개입 없이 전체 작업을 순차 실행한다. “모든 작업을 자동으로 실행해줘” 같은 자연어로도 같은 결과가 나온다
Plan Task의 다른 활용
Plan Task는 기능 개발에만 쓰는 도구가 아니다
- 버그 수정: “다음 오류를 처리할 작업 계획을 세워줘”라고 요청하면 수정용 단계별 계획이 나온다.
- 기술 학습·조사: Research Mode로 특정 토픽을 분석한 뒤 결과를 Plan Task에 넘겨 구현 계획을 만든다.
WebGUI로 작업 목록 시각화
ENABLE_GUI를 true로 두면 DATA_DIR/WebGUI.md 파일이 생성된다. 그 안의 로컬 서버 주소를 클릭하면 작업 목록을 GUI로 확인할 수 있다. 각 작업을 클릭하면 상세 설명을 볼 수 있고, 마음에 들지 않는 작업은 자연어로 수정 요청을 보낸다
컨텍스트는 살아있는 문서로 관리한다
이 워크플로우의 핵심 자산은 세 종류다
ROADMAP.md: 프로젝트의 큰 단위 방향성shrimp-rules.md: 코드베이스 규칙development-planner같은 서브 에이전트: 재사용 가능한 자동화 컴포넌트
세 가지 모두 한 번 만들고 끝이 아니다. 프로젝트가 진행될수록 룰이 변하고, 새 도구가 도입되고, 결정이 바뀐다. 변경이 생기면 즉시 문서를 업데이트하고, 필요하면 init project rules를 다시 돌려 shrimp-rules.md를 재생성한다. AI는 컨텍스트만큼만 똑똑해진다
정리
큰 프로젝트는 사람이 로드맵으로 쪼개고, 세부 작업은 Shrimp Task Manager에 맡긴다. 이 한 가지 분업만 지켜도 AI 개발 워크플로우의 결과 품질이 눈에 띄게 달라진다