Home
cd ../playbooks
FinanceAdvanced

Professional Tax Knowledge Agent

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

15 minutes
CLAUDE.md Template

Download this file and place it in your project folder to get started.

# 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