세금 계산과 절세 전략 수립의 전 과정을 에이전트 팀이 협업하여 생성하는 풀 파이프라인. '세금 계산해줘', '연말정산 시뮬레이션', '종합소득세 얼마나 나와', '절세 방법', '세액공제 최적화', '연금저축 세액공제', '사업소득 세금', '프리랜서 세금', '양도소득세 계산', '실효세율 분석' 등 세금 계산·절세·세무신고 관련 요청에 이 스킬을 사용한다. 기존 세금 자료가 있으면 분석이나 최적화를 지원한다. 단, 세무사·공인회계사 업무 대체, 세무 대리·신고 대행, 조세불복·심판 대리는 이 스킬의 범위가 아니다.
소득분석→공제항목최적화→세액계산→절세시뮬레이션→신고자료준비를 에이전트 팀이 협업하여 한 번에 생성한다.
에이전트 팀 — 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 |
_workspace/ 디렉토리를 프로젝트 루트에 생성한다_workspace/00_input.md에 저장한다| 순서 | 작업 | 담당 | 의존 | 산출물 |
|---|---|---|---|---|
| 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 |
이 워크플로우는 순차 실행이다 — 각 단계가 이전 단계에 의존한다.
팀원 간 소통 흐름:
_workspace/ 내 모든 파일을 확인한다01_income_analysis.md02_deduction_optimization.md03_tax_calculation.md04_tax_strategy.md05_filing_preparation.md| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |
|---|---|---|
| "세금 전체 계산하고 절세 방법 알려줘" | 풀 파이프라인 | 4명 전원 |
| "연봉 5000만원이면 세금 얼마야" | 간편 계산 모드 | analyst + engine |
| "공제 항목 최적화해줘" | 공제 모드 | analyst + optimizer |
| "절세 방법만 알려줘" | 전략 모드 | advisor (기존 세액 정보 활용) |
| "연말정산 준비 뭐 해야 해" | 신고 준비 모드 | advisor 단독 |
기존 파일 활용: 사용자가 기존 원천징수영수증 등을 제공하면, 해당 데이터를 추출하여 _workspace/에 반영한다.
| 전략 | 방식 | 용도 |
|---|---|---|
| 파일 기반 | _workspace/ 디렉토리 | 주요 산출물 저장 및 공유 |
| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |
| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |
파일명 컨벤션: {순번}_{에이전트}_{산출물}.{확장자}
| 에러 유형 | 전략 |
|---|---|
| 소득 정보 부족 | 제공된 정보만으로 계산, "추가 소득 확인 필요" 명시 |
| 세법 연도 불명확 | 최신 세법 기준 적용, "귀속 연도 확인 필요" 명시 |
| 계산 수치 불일치 | 전 단계 재검증 요청 (최대 2회) |
| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 보고서에 누락 명시 |
| 복잡한 세무 구조 | "세무사 상담 권고" 명시 + 기본 분석만 제공 |
프롬프트: "연봉 7000만원 직장인이고, 배우자 1명, 자녀 2명이야. 연금저축 400만원, 신용카드 2000만원 썼어. 세금 계산하고 절세 방법 알려줘" 기대 결과:
프롬프트: "작년 원천징수영수증인데 이걸로 분석해줘" + 파일 첨부 기대 결과:
프롬프트: "프리랜서인데 연 수입 1억이야, 세금 얼마나 내야 해?" 기대 결과:
| 에이전트 | 확장 스킬 | 용도 |
|---|---|---|
| deduction-optimizer | deduction-optimizer-engine | 공제 한도표, 최적화 알고리즘, 신용카드 배분 |
| tax-engine, strategy-advisor | tax-bracket-simulator | 세율 구간 분석, 세액 시뮬레이션, 한계세율 계산 |