Tax Calculator — 세금 계산·절세 전략 풀 파이프라인
소득분석→공제항목최적화→세액계산→절세시뮬레이션→신고자료준비를 에이전트 팀이 협업하여 한 번에 생성한다.
실행 모드
에이전트 팀 — 4명이 SendMessage로 직접 통신하며 교차 검증한다.
에이전트 구성
| 에이전트 |
파일 |
역할 |
타입 |
| income-analyst |
.claude/agents/income-analyst.md |
소득 분류, 과세표준 산출 |
general-purpose |
| deduction-optimizer |
.claude/agents/deduction-optimizer.md |
소득공제·세액공제 최적화 |
general-purpose |
| tax-engine |
.claude/agents/tax-engine.md |
세액 계산, 납부/환급 산출 |
general-purpose |
| strategy-advisor |
.claude/agents/strategy-advisor.md |
절세 시뮬레이션, 신고 준비 |
general-purpose |
워크플로우
Phase 1: 준비 (오케스트레이터 직접 수행)
- 사용자 입력에서 추출한다:
- 소득 정보: 근로소득(총급여), 사업소득, 금융소득, 기타소득
- 가족 구성: 배우자, 부양가족 (인적공제용)
- 공제 항목 (선택): 보험료, 의료비, 교육비, 기부금, 연금저축 등
- 기납부세액 (선택): 원천징수세액, 중간예납
- 과세 연도: 귀속 연도
_workspace/ 디렉토리를 프로젝트 루트에 생성한다
- 입력을 정리하여
_workspace/00_input.md에 저장한다
- 요청 범위에 따라 실행 모드를 결정한다
Phase 2: 팀 구성 및 실행
| 순서 |
작업 |
담당 |
의존 |
산출물 |
| 1 |
소득 분석 |
analyst |
없음 |
_workspace/01_income_analysis.md |
| 2 |
공제 최적화 |
optimizer |
작업 1 |
_workspace/02_deduction_optimization.md |
| 3 |
세액 계산 |
engine |
작업 1, 2 |
_workspace/03_tax_calculation.md |
| 4 |
절세 전략 + 신고 준비 |
advisor |
작업 1, 2, 3 |
_workspace/04_tax_strategy.md, _workspace/05_filing_preparation.md |
이 워크플로우는 순차 실행이다 — 각 단계가 이전 단계에 의존한다.
팀원 간 소통 흐름:
- analyst 완료 → optimizer에게 종합소득금액·세율 구간 전달, engine에게 과세표준 기초 전달
- optimizer 완료 → engine에게 공제 합계 전달, advisor에게 미활용 공제 항목 전달
- engine 완료 → advisor에게 결정세액·실효세율·세율 구간 분석 전달
- advisor는 전체 결과를 종합하여 절세 전략 수립 + 신고 가이드 생성
Phase 3: 통합 및 최종 산출물
_workspace/ 내 모든 파일을 확인한다
- 계산 수치의 일관성을 검증한다 (소득금액→공제→세액의 연쇄 계산 정확성)
- 최종 요약을 사용자에게 보고한다:
- 소득 분석 —
01_income_analysis.md
- 공제 최적화 —
02_deduction_optimization.md
- 세액 계산서 —
03_tax_calculation.md
- 절세 전략 —
04_tax_strategy.md
- 신고 준비 —
05_filing_preparation.md
작업 규모별 모드
| 사용자 요청 패턴 |
실행 모드 |
투입 에이전트 |
| "세금 전체 계산하고 절세 방법 알려줘" |
풀 파이프라인 |
4명 전원 |
| "연봉 5000만원이면 세금 얼마야" |
간편 계산 모드 |
analyst + engine |
| "공제 항목 최적화해줘" |
공제 모드 |
analyst + optimizer |
| "절세 방법만 알려줘" |
전략 모드 |
advisor (기존 세액 정보 활용) |
| "연말정산 준비 뭐 해야 해" |
신고 준비 모드 |
advisor 단독 |
기존 파일 활용: 사용자가 기존 원천징수영수증 등을 제공하면, 해당 데이터를 추출하여 _workspace/에 반영한다.
데이터 전달 프로토콜
| 전략 |
방식 |
용도 |
| 파일 기반 |
_workspace/ 디렉토리 |
주요 산출물 저장 및 공유 |
| 메시지 기반 |
SendMessage |
실시간 핵심 정보 전달, 수정 요청 |
| 태스크 기반 |
TaskCreate/TaskUpdate |
진행 상황 추적, 의존 관계 관리 |
파일명 컨벤션: {순번}_{에이전트}_{산출물}.{확장자}
에러 핸들링
| 에러 유형 |
전략 |
| 소득 정보 부족 |
제공된 정보만으로 계산, "추가 소득 확인 필요" 명시 |
| 세법 연도 불명확 |
최신 세법 기준 적용, "귀속 연도 확인 필요" 명시 |
| 계산 수치 불일치 |
전 단계 재검증 요청 (최대 2회) |
| 에이전트 실패 |
1회 재시도 → 실패 시 해당 산출물 없이 진행, 보고서에 누락 명시 |
| 복잡한 세무 구조 |
"세무사 상담 권고" 명시 + 기본 분석만 제공 |
테스트 시나리오
정상 흐름
프롬프트: "연봉 7000만원 직장인이고, 배우자 1명, 자녀 2명이야. 연금저축 400만원, 신용카드 2000만원 썼어. 세금 계산하고 절세 방법 알려줘"
기대 결과:
- 소득 분석: 총급여 7000만원 → 근로소득공제 → 근로소득금액 산출
- 공제 최적화: 인적공제(4인), 연금저축세액공제, 신용카드공제 등 최적 조합
- 세액 계산: 과세표준→산출세액→결정세액→납부/환급액 전 과정
- 절세 전략: IRP 추가 납입, 의료비 공제 활용 등 3개+ 시뮬레이션
- 신고 준비: 필요 증빙 체크리스트, 홈택스 신고 가이드
기존 파일 활용 흐름
프롬프트: "작년 원천징수영수증인데 이걸로 분석해줘" + 파일 첨부
기대 결과:
- 원천징수영수증에서 소득·공제·세액 데이터 추출
- 현재 공제 상태 분석 + 추가 절세 가능 항목 안내
에러 흐름
프롬프트: "프리랜서인데 연 수입 1억이야, 세금 얼마나 내야 해?"
기대 결과:
- 사업소득으로 분류, 필요경비율(단순경비율/기준경비율) 적용
- 경비 증빙 방법에 따른 세액 차이 시뮬레이션
- 사업자 등록 유무에 따른 차이 안내
- 4대 보험 지역가입자 부담 안내
에이전트별 확장 스킬
| 에이전트 |
확장 스킬 |
용도 |
| deduction-optimizer |
deduction-optimizer-engine |
공제 한도표, 최적화 알고리즘, 신용카드 배분 |
| tax-engine, strategy-advisor |
tax-bracket-simulator |
세율 구간 분석, 세액 시뮬레이션, 한계세율 계산 |
1---2name: tax-calculator-23description: 세금 계산과 절세 전략 수립의 전 과정을 에이전트 팀이 협업하여 생성하는 풀 파이프라인. '세금 계산해줘', '연말정산 시뮬레이션', '종합소득세 얼마나 나와', '절세 방법', '세액공제 최적화', '연금저축 세액공제', '사업소득 세금', '프리랜서 세금', '양도소득세 계산', '실효세율 분석' 등 세금 계산·절세·세무신고 관련 요청에 이 스킬을 사용한다. 기존 세금 자료가 있으면 분석이나 최적화를 지원한다. 단, 세무사·공인회계사 업무 대체, 세무 대리·신고 대행, 조세불복·심판 대리는 이 스킬의 범위가 아니다.4---56# Tax Calculator — 세금 계산·절세 전략 풀 파이프라인78소득분석→공제항목최적화→세액계산→절세시뮬레이션→신고자료준비를 에이전트 팀이 협업하여 한 번에 생성한다.910## 실행 모드1112**에이전트 팀** — 4명이 SendMessage로 직접 통신하며 교차 검증한다.1314## 에이전트 구성1516| 에이전트 | 파일 | 역할 | 타입 |17|---------|------|------|------|18| income-analyst | `.claude/agents/income-analyst.md` | 소득 분류, 과세표준 산출 | general-purpose |19| deduction-optimizer | `.claude/agents/deduction-optimizer.md` | 소득공제·세액공제 최적화 | general-purpose |20| tax-engine | `.claude/agents/tax-engine.md` | 세액 계산, 납부/환급 산출 | general-purpose |21| strategy-advisor | `.claude/agents/strategy-advisor.md` | 절세 시뮬레이션, 신고 준비 | general-purpose |2223## 워크플로우2425### Phase 1: 준비 (오케스트레이터 직접 수행)26271. 사용자 입력에서 추출한다:28 - **소득 정보**: 근로소득(총급여), 사업소득, 금융소득, 기타소득29 - **가족 구성**: 배우자, 부양가족 (인적공제용)30 - **공제 항목** (선택): 보험료, 의료비, 교육비, 기부금, 연금저축 등31 - **기납부세액** (선택): 원천징수세액, 중간예납32 - **과세 연도**: 귀속 연도332. `_workspace/` 디렉토리를 프로젝트 루트에 생성한다343. 입력을 정리하여 `_workspace/00_input.md`에 저장한다354. 요청 범위에 따라 **실행 모드를 결정**한다3637### Phase 2: 팀 구성 및 실행3839| 순서 | 작업 | 담당 | 의존 | 산출물 |40|------|------|------|------|--------|41| 1 | 소득 분석 | analyst | 없음 | `_workspace/01_income_analysis.md` |42| 2 | 공제 최적화 | optimizer | 작업 1 | `_workspace/02_deduction_optimization.md` |43| 3 | 세액 계산 | engine | 작업 1, 2 | `_workspace/03_tax_calculation.md` |44| 4 | 절세 전략 + 신고 준비 | advisor | 작업 1, 2, 3 | `_workspace/04_tax_strategy.md`, `_workspace/05_filing_preparation.md` |4546이 워크플로우는 **순차 실행**이다 — 각 단계가 이전 단계에 의존한다.4748**팀원 간 소통 흐름:**49- analyst 완료 → optimizer에게 종합소득금액·세율 구간 전달, engine에게 과세표준 기초 전달50- optimizer 완료 → engine에게 공제 합계 전달, advisor에게 미활용 공제 항목 전달51- engine 완료 → advisor에게 결정세액·실효세율·세율 구간 분석 전달52- advisor는 전체 결과를 종합하여 절세 전략 수립 + 신고 가이드 생성5354### Phase 3: 통합 및 최종 산출물55561. `_workspace/` 내 모든 파일을 확인한다572. 계산 수치의 일관성을 검증한다 (소득금액→공제→세액의 연쇄 계산 정확성)583. 최종 요약을 사용자에게 보고한다:59 - 소득 분석 — `01_income_analysis.md`60 - 공제 최적화 — `02_deduction_optimization.md`61 - 세액 계산서 — `03_tax_calculation.md`62 - 절세 전략 — `04_tax_strategy.md`63 - 신고 준비 — `05_filing_preparation.md`6465## 작업 규모별 모드6667| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |68|----------------|----------|-------------|69| "세금 전체 계산하고 절세 방법 알려줘" | **풀 파이프라인** | 4명 전원 |70| "연봉 5000만원이면 세금 얼마야" | **간편 계산 모드** | analyst + engine |71| "공제 항목 최적화해줘" | **공제 모드** | analyst + optimizer |72| "절세 방법만 알려줘" | **전략 모드** | advisor (기존 세액 정보 활용) |73| "연말정산 준비 뭐 해야 해" | **신고 준비 모드** | advisor 단독 |7475**기존 파일 활용**: 사용자가 기존 원천징수영수증 등을 제공하면, 해당 데이터를 추출하여 `_workspace/`에 반영한다.7677## 데이터 전달 프로토콜7879| 전략 | 방식 | 용도 |80|------|------|------|81| 파일 기반 | `_workspace/` 디렉토리 | 주요 산출물 저장 및 공유 |82| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |83| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |8485파일명 컨벤션: `{순번}_{에이전트}_{산출물}.{확장자}`8687## 에러 핸들링8889| 에러 유형 | 전략 |90|----------|------|91| 소득 정보 부족 | 제공된 정보만으로 계산, "추가 소득 확인 필요" 명시 |92| 세법 연도 불명확 | 최신 세법 기준 적용, "귀속 연도 확인 필요" 명시 |93| 계산 수치 불일치 | 전 단계 재검증 요청 (최대 2회) |94| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 보고서에 누락 명시 |95| 복잡한 세무 구조 | "세무사 상담 권고" 명시 + 기본 분석만 제공 |9697## 테스트 시나리오9899### 정상 흐름100**프롬프트**: "연봉 7000만원 직장인이고, 배우자 1명, 자녀 2명이야. 연금저축 400만원, 신용카드 2000만원 썼어. 세금 계산하고 절세 방법 알려줘"101**기대 결과**:102- 소득 분석: 총급여 7000만원 → 근로소득공제 → 근로소득금액 산출103- 공제 최적화: 인적공제(4인), 연금저축세액공제, 신용카드공제 등 최적 조합104- 세액 계산: 과세표준→산출세액→결정세액→납부/환급액 전 과정105- 절세 전략: IRP 추가 납입, 의료비 공제 활용 등 3개+ 시뮬레이션106- 신고 준비: 필요 증빙 체크리스트, 홈택스 신고 가이드107108### 기존 파일 활용 흐름109**프롬프트**: "작년 원천징수영수증인데 이걸로 분석해줘" + 파일 첨부110**기대 결과**:111- 원천징수영수증에서 소득·공제·세액 데이터 추출112- 현재 공제 상태 분석 + 추가 절세 가능 항목 안내113114### 에러 흐름115**프롬프트**: "프리랜서인데 연 수입 1억이야, 세금 얼마나 내야 해?"116**기대 결과**:117- 사업소득으로 분류, 필요경비율(단순경비율/기준경비율) 적용118- 경비 증빙 방법에 따른 세액 차이 시뮬레이션119- 사업자 등록 유무에 따른 차이 안내120- 4대 보험 지역가입자 부담 안내121122## 에이전트별 확장 스킬123124| 에이전트 | 확장 스킬 | 용도 |125|---------|----------|------|126| deduction-optimizer | `deduction-optimizer-engine` | 공제 한도표, 최적화 알고리즘, 신용카드 배분 |127| tax-engine, strategy-advisor | `tax-bracket-simulator` | 세율 구간 분석, 세액 시뮬레이션, 한계세율 계산 |