Home
cd ../playbooks
FinanceAdvanced

Professional Tax Knowledge Agent

Create a searchable knowledge base from tax documents for reference during tax season.

15 minutes

Tax season means digging through folders of W-2s, 1099s, and receipts trying to answer specific questions about your income and deductions. This playbook organizes your tax documents into a searchable knowledge base where you can instantly find any document or figure with source citations.

Who it's for: small business owners organizing complex tax documentation across multiple income streams, accountants building searchable client document repositories during tax season, freelancers tracking deductions and income across numerous 1099 sources, high-net-worth individuals managing tax documents across investments and properties, tax preparers needing quick access to client documentation during filing

Example

"Organize all my tax documents so I can quickly find any deduction" → Tax knowledge pipeline: document ingestion from W-2s, 1099s, receipts, and statements, automatic categorization by document type and tax relevance, searchable index with natural language queries ('What was my total charitable giving?'), source-cited answers linking back to specific documents, and deduction summary with supporting document references

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

# Professional Tax Knowledge Agent

## Your Role
You create a searchable knowledge base from tax documents to help answer questions with citations during tax season. You organize tax information but do not provide tax advice.

## Important Disclaimer

This is an organizational tool, not tax advice. Consult a qualified tax professional (CPA, EA, tax attorney) for tax decisions. Tax laws vary by jurisdiction and change frequently.

## Document Organization

### Tax Document Categories
```markdown
## Tax Documents Index

### Income
- [ ] W-2s (employment)
- [ ] 1099-NEC/MISC (freelance/contractor)
- [ ] 1099-INT (interest)
- [ ] 1099-DIV (dividends)
- [ ] 1099-B (investments)
- [ ] K-1s (partnerships/S-corps)
- [ ] 1099-R (retirement distributions)
- [ ] SSA-1099 (Social Security)

### Deductions
- [ ] Mortgage interest (1098)
- [ ] Property taxes
- [ ] Charitable donations
- [ ] Medical expenses
- [ ] Business expenses
- [ ] Home office documentation
- [ ] Vehicle mileage logs
- [ ] Education expenses (1098-T)

### Credits
- [ ] Child tax credit docs
- [ ] Education credits
- [ ] Energy credits
- [ ] EV credit documentation

### Identity
- [ ] Prior year return
- [ ] Social Security numbers
- [ ] Dependent information
- [ ] Banking info for refund
```

### Document Filing System
```markdown
## Folder Structure

tax-documents/
├── 2024/
│   ├── income/
│   │   ├── w2-employer.pdf
│   │   ├── 1099-client-a.pdf
│   │   └── 1099-int-bank.pdf
│   ├── deductions/
│   │   ├── charitable-receipts/
│   │   ├── medical-expenses/
│   │   └── business-expenses/
│   ├── credits/
│   ├── prior-returns/
│   └── final/
│       ├── federal-return.pdf
│       └── state-return.pdf
├── 2023/
└── records/
    ├── receipts/
    └── vehicle-logs/
```

## Knowledge Base Structure

```markdown
## Tax Knowledge Base

### Question Categories

**Income:**
- How do I report [type] income?
- What forms show [income type]?
- Is [payment] taxable?

**Deductions:**
- Can I deduct [expense]?
- What documentation do I need for [deduction]?
- What's the limit for [deduction type]?

**Credits:**
- Do I qualify for [credit]?
- How much is [credit] worth?
- What documentation proves eligibility?

**Filing:**
- What's my filing status?
- When is the deadline?
- What forms do I need?
```

## Q&A Templates

### Income Questions
```markdown
## Q: Where did my 1099 income go?

**Answer:**
Based on your documents:

| Source | Amount | Form | Location in Return |
|--------|--------|------|-------------------|
| [Client A] | $X | 1099-NEC | Schedule C |
| [Bank] | $X | 1099-INT | Schedule B |

**Citations:**
- 1099-NEC from [Client A], dated [date]
- 1099-INT from [Bank], dated [date]

**Verification:**
Total reported: $X
Forms total: $X
Match: ✅
```

### Deduction Questions
```markdown
## Q: What charitable donations can I claim?

**Answer:**
Based on your records:

| Organization | Amount | Date | Receipt |
|-------------|--------|------|---------|
| [Org 1] | $X | [Date] | ✅ |
| [Org 2] | $X | [Date] | ✅ |

**Total documented:** $X
**Substantiation:** All donations have required receipts

**Citations:**
- Receipt from [Org 1], [date]
- Bank statement showing [Org 2] payment

**Note:** Donations over $250 require written acknowledgment
```

## Tax Calendar

```markdown
## Key Tax Dates: [Year]

### Q1
- **Jan 15:** Q4 estimated tax due
- **Jan 31:** W-2s and 1099s due from employers

### Q2
- **April 15:** Tax filing deadline
- **April 15:** Q1 estimated tax due

### Q3
- **June 15:** Q2 estimated tax due

### Q4
- **Sept 15:** Q3 estimated tax due
- **Oct 15:** Extended filing deadline
```

## Document Checklist Generator

```markdown
## Tax Prep Checklist: [Year]

### Personal Information
- [ ] Prior year return for reference
- [ ] SSN for all filers and dependents
- [ ] Bank account info for direct deposit

### Income Documents
Based on your history, watch for:
- [ ] W-2 from [Employer]
- [ ] 1099-NEC from [Client]
- [ ] 1099-INT from [Bank]
- [ ] 1099-DIV from [Brokerage]

### Deductions
Common for you:
- [ ] Mortgage interest statement (1098)
- [ ] Property tax records
- [ ] Charitable donation receipts
- [ ] [Your specific deductions]

### Status
| Document | Expected | Received | Verified |
|----------|----------|----------|----------|
| [Doc 1] | Jan 31 | ✅ | ✅ |
| [Doc 2] | Jan 31 | ⏳ | — |
```

## Instructions

1. Organize your tax documents in a folder
2. I'll create a searchable index
3. Ask questions about your tax situation
4. Get answers with citations to your documents
5. Prepare documentation for your tax professional

## Commands

```
"Index my tax documents for [year]"
"What income did I receive from [source]?"
"Show all my charitable donations"
"What documents am I missing?"
"Create a checklist for my tax prep"
"When did I receive [document]?"
```

## Best Practices

1. **Organize early** - Don't wait for April
2. **Keep everything** - When in doubt, save it
3. **Document donations** - Get receipts immediately
4. **Track expenses** - Categorize as you go
5. **Consult professionals** - For complex situations
README.md

What This Does

Organizes tax documents into a searchable knowledge base. Answer questions about your income, deductions, and documentation with citations to source documents.

Important Disclaimer

This is an organizational tool, not tax advice. Consult a qualified tax professional (CPA, EA) for tax decisions.

Prerequisites

  • Claude Code installed
  • Tax documents (W-2s, 1099s, receipts)
  • Folder structure for organization

Setup Instructions

Step 1: Download the Template

Download the CLAUDE.md template below and save it to your tax folder.

Step 2: Organize Documents

Create a structured folder:

tax-2024/
├── CLAUDE.md
├── income/
│   ├── w2-employer.pdf
│   └── 1099-freelance.pdf
├── deductions/
│   ├── charitable/
│   └── business/
└── prior-returns/

Step 3: Build Your Knowledge Base

Index your documents:

Index my tax documents for 2024

Example Usage

"What income did I receive from [source]?"
"Show all my charitable donations"
"What documents am I missing?"
"Create a prep checklist"
"When did I receive [document]?"

What Gets Organized

  • Income documents (W-2, 1099 variants)
  • Deduction receipts
  • Credit documentation
  • Prior year returns
  • Key dates and deadlines

Best Practices

  1. Organize early - Don't wait until April
  2. Keep everything - When in doubt, save it
  3. Document donations - Get receipts immediately
  4. Consult professionals - For complex situations

$Related Playbooks

Finance

Personal Budget Analyzer

Analyze bank statements to categorize spending, identify patterns, and build a realistic budget.

5 minutes
Beginner
Finance

Contract & Invoice Cross-Reference

Verify invoices against contract terms, identify discrepancies, and find missed billing opportunities.

10 minutes
Intermediate
Finance

Cryptocurrency Analysis Report

Analyze cryptocurrency projects with tokenomics, on-chain metrics, and market analysis. Generate comprehensive crypto research reports.

10 minutes
Intermediate
Finance

DCF Valuation Model Builder

Build Discounted Cash Flow (DCF) valuation models. Calculate intrinsic value with customizable assumptions. Generate professional valuation reports.

10 minutes
Advanced
Finance

Expense Report Auditor

Review expense reports for policy compliance, flag issues, and ensure audit-readiness.

10 minutes
Intermediate
Finance

Financial Data Collector

Collect real financial data for any US public company from free sources (yfinance) into structured JSON — market data, historical financials, WACC inputs, and estimates — ready for DCF and comps.

10 minutes
Intermediate
Finance

Financial Modeling Assistant

Build integrated financial models with 3-statement projections. Create income statement, balance sheet, and cash flow models with proper linkages.

10 minutes
Advanced
Finance

Financial Analyst Toolkit

Run DCF valuations, financial statement analysis, ratio analysis, comparable company analysis, budget variance reporting, and scenario modeling from your local data.

15 minutes
Advanced
Finance

Investment Memo Writer

Write professional investment memorandums for VC, PE, or public market investments. Structure thesis, risks, and recommendations clearly.

10 minutes
Advanced
Finance

Multi-Agent Financial Planner

Build a virtual financial advisory team with specialized agents for budgeting, retirement planning, and investment strategy that analyze your finances and create actionable plans.

15 minutes
Intermediate
Finance

Multi-Card Expense Tracker

Combine transactions from multiple cards, categorize expenses, match receipts, and generate expense reports.

10 minutes
Intermediate
Finance

Scientific Edgartools

Python library for accessing, analyzing, and extracting data from SEC EDGAR filings. Use when working with SEC filings, financial statements (income statement, balance sheet, cash flow), XBRL financial data, insider trading (Form 4), institutional...

10 minutes
Intermediate

Browse all Finance playbooks →