이 문서는 개인사업자와 프리랜서를 대상으로 홈택스 세무 업무를 효율적으로 보조하는 AI 에이전트용 무료 스킬 모음인 '홈택스 도움(hometax-doum)' 프로젝트를 소개하고 있습니다.

1. 주요 개요 및 목적

본 프로젝트는 사용자가 세무 지식이 부족하더라도 홈택스의 3대 핵심 업무(부가가치세, 종합소득세, 전자세금계산서 발행)를 제출 직전 단계까지 안전하게 수행할 수 있도록 지원합니다. AI는 홈택스 화면 내 입력 순서, 확인해야 할 숫자, 공제 항목 등을 가이드하며, 최종 제출·발급 버튼은 반드시 사용자가 직접 누르게 하여 안정성을 확보합니다.

2. 핵심 기능 및 방법론

• 제공 스킬 구성:
  • hometax-tax-hub: 세무 업무 전반 가이드.
  • tax-prep-kr: 신고 전 서류 준비 및 일정 관리.
  • receipt-classify-kr: 영수증 및 카드 내역의 공제/불공제 분류.
  • tax-invoice-hometax: 전자세금계산서 발급·수정 및 자릿수 확인.
  • vat-hometax: 부가가치세(일반/간이) 신고 안내 및 누락 공제 체크.
  • income-tax-hometax: 종합소득세 신고 지원 및 경비율 선택 도움.

• 기술적 설계 및 안전 규칙:
  • 비침해 원칙: AI는 비밀번호를 수집하지 않으며, 홈택스 화면에 없는 임의의 숫자를 생성하지 않습니다.
  • 입력 무결성: 입력 값(예: 세금계산서 금액)과 사용자의 요구사항을 대조하여 자릿수 오류(예: 2,000,000 vs 20,000,000)를 사전에 방지합니다.
  • 검증 엔진: Pro 모델의 경우, 다음과 같은 논리 기반 계산을 수행합니다.
    • 종소세 예상세액: $2026$년 정부 세율 체계를 반영하여 근로소득공제 및 세액공제를 포함한 예상 세액을 계산.
    • 원천세 계산: 국세청 근로소득 간이세액표를 기준으로 소득 종류별(일용직 $6\%$, 프리랜서 $3.3\%$ 등) 원천징수액을 도출.

3. 세무 실무 가이드라인

• 법적 준거성: 본 도구는 「세무사법」 제2조 및 제20조 제3항에 따라 세무대리나 세무상담이 아닌 '신고 준비를 돕는 소프트웨어'로 규정됩니다. 모든 결과물은 홈택스 화면을 최종 근거로 삼아야 합니다.
• 간이과세 판정 로직: 직전 연도 공급대가($§61$) 및 당해 연도 납부면제 기준($§69$)을 분리하여 적용함으로써 오판정을 방지합니다.
• 공제 점검: 전자신고 세액공제(5,000원)와 전자세금계산서 발급세액 공제(건당 200원, 연 100만원 한도) 등을 자동으로 확인하여 절세 기회를 놓치지 않도록 설계되었습니다.

4. 확장성 및 배포

• 설치 환경: Claude Code, Codex, Aside와 같은 AI 에이전트 도구에서 플러그인 형태로 설치 가능하며, 로컬 환경(ZIP 배포)에서의 수동 설치도 지원합니다.
• Pro 엔진: 무료 버전의 화면 안내 기능을 넘어, 연중 상시 예상 세액 계산 및 급여 대장 대조 기능이 필요한 사용자를 위해 별도의 엔진을 제공하여 실무 자동화 범위를 확장했습니다.