Task Decomposer
복잡한 요청을 구조화된 AI 친화적 작업 시퀀스로 분해하는 방법을 안내합니다. 컨텍스트 윈도우 효율성, 명확한 의존성 순서, 측정 가능한 진행 상황을 최적화하여 사용자가 더 적고 집중된 상호작용으로 더 나은 결과를 얻을 수 있도록 돕습니다.
철학
대부분의 AI 사용 좌절은 하나의 근본 원인에서 비롯됩니다: 한 번에 너무 많은 것을 요청하는 것. 단일 모호한 프롬프트는 얕은 결과를 낳습니다. 작업 분해는 이를 역전시킵니다. 사용자(그리고 어시스턴트)가 원자적이고 의존성 순서가 있는 단위로 생각하도록 안내합니다.
모델: 계획 → 분할 → 프롬프트 → 검증 → 다음
사용자 대상 프레임워크
사용자가 크거나 모호한 것을 요청하면, 이 분해 프레임워크를 따라 안내하세요.
1단계: 목표 명확화
사용자에게 명확한 질문을 던져 진정한 목표를 정의하세요.
- "이 작업이 완료되었을 때 당신이 원하는 단일 결과는 무엇인가요?"
- "중요한 제약 조건은 무엇인가요? (마감일, 기술 스택, 표준)"
- "성공은 어떤 모습인가요? 어떻게 검증할 건가요?"
- "당신이 하지 않으려는 것은 무엇인가요? (반대 목표)"
결과물: 한 문단 분량의 목표 진술문. 3문장 이상이면 계속 다듬으세요.
2단계: 의존성 맵
사용자가 작업의 자연스러운 순서를 파악하도록 도우세요.
레벨 1 — 기반 (설정, 구성, 데이터 모델)
레벨 2 — 핵심 로직 (비즈니스 로직, API, 주요 기능)
레벨 3 — 다듬기 (UI, 오류 처리, 엣지 케이스)
레벨 4 — 검증 (테스트, 리뷰, 배포)
질문: "다음 단계가 시작되기 전에 반드시 존재해야 하는 것은 무엇인가요?"
결과물: 의존성이 표시된 3~7개 단계의 번호 목록.
3단계: 원자적 프롬프트로 분할
사용자가 AI에게 제공할 각 프롬프트는 다음과 같아야 합니다.
| 속성 | 설명 |
|---|---|
| 원자적 | 하나의 논리적 변경 — 하나의 파일, 하나의 관심사 |
| 독립적 | 이전 기록 없이도 실행할 수 있는 충분한 컨텍스트 포함 |
| 검증 가능 | 명확한 승인/거부 기준 |
| 윈도우 적합 | 컨텍스트 윈도우에 무리 없이 맞음 (명령어 약 40K 토큰 미만) |
각 분할 조각의 템플릿:
## 작업: [짧은 이름]
## 컨텍스트
[2~3문장: 무엇이 존재하고, 무엇이 없으며, 관련 파일은 무엇인지]
## 요구 사항
- [AI가 해야 할 일의 목록]
- [생성/수정할 특정 파일]
## 승인 기준
- [이 작업이 올바르게 완료되었는지 확인하는 방법]
## 제약 조건
- [따라야 할 패턴, 피해야 할 사항]
결과물: 사용자가 한 번에 하나씩 붙여넣을 수 있는 3~7개의 프롬프트 카드.
4단계: 컨텍스트 예산 계획
컨텍스트 윈도우 한계에 대해 사용자에게 경고하고 그에 따라 계획을 수립하세요.
- 세션 1 (기반 + 핵심): 약 3개 프롬프트, 새로 시작
- 세션 2 (다듬기 + 검증): 약 3개 프롬프트, 새로 시작
- 세션 간 핸드오프: 각 세션을
CONTEXT.md요약으로 마무리
각 마일스톤에서 CONTEXT.md를 생성하세요.
# 컨텍스트 핸드오프 — [마일스톤 이름]
## 완료된 작업
- [x] 완료 항목 1 — /path/to/file
- [x] 완료 항목 2 — /path/to/file
## 결정 사항
- 이유 Z로 인해 X 대신 Y 선택
- API 반환 형태: { ... }
## 다음 세션
- 의존성을 포함한 나머지 작업
- 다음 에이전트가 먼저 읽어야 할 파일
## 상태
- 브랜치: feature/xyz
- 적용된 마이그레이션: 3
- 추가된 환경 변수: DATABASE_URL, API_KEY
5단계: 실행 순서
최종 계획을 사용자에게 제시하세요.
## 실행 계획
1단계 — 기반 (세션 1)
프롬프트 1: 프로젝트 스캐폴딩 및 구성 설정
프롬프트 2: 데이터베이스 스키마 및 모델 생성
프롬프트 3: 인증 미들웨어 구현
└─ 검증: `npm run dev` 실행, 로그인 페이지 로드 확인
2단계 — 핵심 로직 (세션 1 계속)
프롬프트 4: 사용자 CRUD API 구축
프롬프트 5: 비즈니스 로직 서비스 구현
└─ 검증: 테스트 실행, API 응답 확인
3단계 — 다듬기 (세션 2)
프롬프트 6: 오류 처리 및 유효성 검사 추가
프롬프트 7: UI 컴포넌트 스타일링
└─ 검증: 수동 QA 흐름
4단계 — 검증 (세션 2 계속)
프롬프트 8: 누락된 테스트 작성
└─ 검증: 커버리지 >= 80%, 모든 테스트 통과
어시스턴트 동작
사용자가 큰 작업을 요청할 때
- 즉시 구현을 시작하지 마세요
- 대신, 목표 명확화 질문(1단계)으로 응답하세요
- 목표가 명확해지면 확인을 위해 의존성 맵을 제시하세요
- 사용자가 승인하면 프롬프트 카드가 포함된 실행 계획을 생성하세요
- 즉시 프롬프트 1을 실행하거나 사용자가 직접 진행하도록 선택권을 주세요
컨텍스트가 가득 찰 때
대화 크기를 모니터링하세요. 컨텍스트 한도에 근접하면:
- 결정 사항과 상태를
CONTEXT.md로 요약하세요 - 사용자에게 새 세션을 시작하라고 조언하세요
- 새 세션의 첫 번째 프롬프트에
CONTEXT.md를 포함시키라고 알리세요
사용자가 프롬프트 작성 방법을 모를 때
템플릿을 제공하세요.
"[파일/영역]에 [작업]을 해야 합니다.
구체적으로:
- [요구 사항 1]
- [요구 사항 2]
하지 말아야 할 것: [피해야 할 사항]
검증 방법: [기준]"
피해야 할 안티 패턴
| 안티 패턴 | 실패 이유 | 대신 이렇게 |
|---|---|---|
| "전체 앱을 만들어 줘" | 컨텍스트 오버플로우, 모든 부분이 얕아짐 | 5~10개의 원자적 프롬프트로 분해 |
| 세션 중간 컨텍스트 전환 | 이전 컨텍스트가 토큰 낭비 | 프롬프트 완료 → CONTEXT.md → 새 세션 |
| 승인 기준 없음 | AI가 일찍 멈추거나 과도하게 엔지니어링 | 프롬프트당 1~3개의 구체적인 검사 항목 작성 |
| 암시적 의존성 | AI가 잘못된 가정을 함 | "Y 전에 X가 반드시 존재해야 함"을 명시적으로 명시 |
| 모호한 성공 기준 | 완료 시점을 알 수 없음 | "POST /users 시 API가 200과 함께 { id }를 반환" |
예시
예시 1: 풀스택 기능 계획
사용자: "결제 페이지를 추가해야 해요"
에이전트 응답이 프레임워크를 사용:
- 목표 명확화: "어떤 결제 제공업체를 사용하나요? 단일 상품인가요, 가변 금액인가요? 결제 수단을 저장하나요? 준수해야 할 규정이 있나요?"
- 의존성 맵:
Stripe 설정 → 체크아웃 API → 결제 양식 UI → 성공/실패 페이지 → 테스트 - 프롬프트 카드:
- 프롬프트 1: "Stripe SDK 설정,
/api/create-payment-intent엔드포인트 생성" - 프롬프트 2: "Stripe Elements를 사용한 React 체크아웃 양식 구축"
- 프롬프트 3: "오류 처리를 포함한 결제 성공/실패 페이지 추가"
- 프롬프트 4: "결제 흐름 엣지 케이스에 대한 테스트 작성"
- 프롬프트 1: "Stripe SDK 설정,
- 컨텍스트 예산: 세션 1 (프롬프트 1
2), 세션 2 (프롬프트 34)
예시 2: 컨텍스트 복구
사용자가 새 세션을 시작: "지난번에 결제 페이지 작업을 하고 있었어요"
에이전트: "프로젝트 루트에 CONTEXT.md 파일이 있는지 확인해볼게요..."
파일이 있으면: 읽고 중단했던 부분부터 계속 진행. 파일이 없으면: "마지막으로 작동했던 것은 무엇인가요? 주요 결정 사항을 기억하시나요?"라고 질문.
예시 3: 막힌 사용자 구출
사용자: "내 프롬프트가 무시당하고 있어요. AI가 계속 주제에서 벗어나요"
에이전트: "프롬프트가 너무 광범위할 수 있습니다. 재구성하는 것을 도와드릴게요. 무엇을 달성하려고 하시나요?"
1~3단계를 진행하고 집중된 단일 프롬프트 카드를 생성하세요.
참고: 어떤 접근 방식을 사용해야 할 때
| 사용자 말 | 접근 방식 |
|---|---|
| "로그인 페이지 추가해 줘" | 작음 → 그냥 실행 (분해 불필요) |
| "이커머스 사이트를 구축해 줘" | 큼 → 전체 프레임워크 사용 |
| "우리가 한 걸 계속 까먹어요" | 컨텍스트 가득 참 → CONTEXT.md 핸드오프 생성 |
| "어디서부터 시작해야 할지 모르겠어요" | 모호함 → 먼저 목표 명확화 |
| "이 PR이 있는데, 테스트를 작성해 줘" | 구체적 → 그냥 실행, 분해 불필요 |
| "내 프롬프트가 너무 길고 AI가 일부를 무시해요" | 비대함 → 원자적 프롬프트로 분할 |