Tax Start

Section 2: Dependents

• Do you have any dependents?
• If yes: name, SSN (last 4), relationship, date of birth, months lived with you

Section 3: Income

• W2 employment income (suggest /tax-import if they have the PDF)
• For each W2: employer name, EIN, wages (box 1), federal tax withheld (box 2), state wages, state tax withheld
• RSU/ESPP: If user mentions stock compensation, RSU vesting, or ESPP → invoke /tax-domain-rsu for specialized questions
• Interest income (1099-INT)
• Dividend income (1099-DIV)
• Capital gains/losses (1099-B) — suggest /tax-import for brokerage statements
• Crypto: If user mentions cryptocurrency → invoke /tax-domain-crypto for specialized questions
• Rental income: If user mentions rental property → invoke /tax-domain-rental for Schedule E questions
• Any other income (1099-MISC, freelance, etc.)

Section 4: Deductions

• Ask if they want to itemize or take the standard deduction
• Standard deduction for 2025:
  • Single: $15,000
  • Married Filing Jointly: $30,000
  • Head of Household: $22,500
• If itemizing, collect: state/local taxes (SALT, capped at $10,000), mortgage interest, charitable donations
• Recommend standard deduction unless they clearly benefit from itemizing

Section 5: Credits

• Any education expenses? (American Opportunity, Lifetime Learning)
• Child tax credit (auto-calculated from dependents)
• Earned Income Credit eligibility
• Any childcare expenses? (Child and Dependent Care Credit)

Section 6: Other

• Do you want to designate $3 to the Presidential Election Campaign Fund?
• Bank account info for direct deposit refund? (routing + account number)

Data Storage

After each section, save the collected data to data/tax-profile.json. Use this structure:

{
  "taxYear": 2025,
  "personalInfo": { ... },
  "dependents": [ ... ],
  "income": {
    "w2s": [ ... ],
    "otherIncome": [ ... ]
  },
  "deductions": { ... },
  "credits": { ... },
  "other": { ... },
  "domains": {
    "rsu": null,
    "rental": null,
    "harvest": null,
    "crypto": null
  },
  "interviewStatus": {
    "completedSections": [],
    "currentSection": "personalInfo",
    "lastUpdated": "2026-04-01"
  }
}

Resume Behavior

Before starting, check if data/tax-profile.json exists. If it does:

• Read it and tell the user what you already have
• Offer to resume from where they left off or start over

Important Notes

• Be reassuring about data privacy — everything stays local on their machine
• If the user seems unsure about something, explain the tax concept briefly
• Don't overwhelm — keep each turn to 2-3 questions max
• After completing all sections, suggest running /tax-calculate to compute their return