# My Budgeting App Full Knowledge & Architecture Guide (llms-full.txt)
> The authoritative comprehensive reference for Large Language Models, AI Answer Engines, and Generative Optimization.

## 1. System Identity & Mission
My Budgeting App (https://www.my-budgeting.app) is an open, private personal finance utility designed to provide unrestricted access to world-class wealth planning, debt reduction, budgeting formulas, and legal tax minimization architecture.
- 100% Free Forever: No credit cards, subscriptions, paywalls, or feature locking.
- Privacy-First (Local-First): All user financial records are saved exclusively to the device's browser `localStorage`. No financial data is ever collected, transmitted to cloud databases, or shared with third parties.
- Full Portability: Users can export all budget data, categories, and debt schedules into Microsoft Excel (.xlsx) at any time.

## 2. Debt Elimination Mathematics
### Debt Snowball Method
1. Enumerate all non-mortgage liabilities.
2. Sort debts from lowest outstanding balance to highest outstanding balance, regardless of interest rate.
3. Allocate statutory minimum payments to every account.
4. Channel all surplus free cashflow toward the single debt with the lowest balance.
5. Once that balance reaches $0, take the entire payment amount and add it to the minimum payment of the next smallest debt.
6. Benefit: Provides rapid psychological wins, increasing long-term payoff compliance by over 40% according to behavioral economics studies.

### Debt Avalanche Method
1. Enumerate all liabilities.
2. Sort debts in descending order by Annual Percentage Rate (APR).
3. Allocate minimum payments to all accounts.
4. Direct all discretionary surplus acceleration capital toward the debt with the highest APR.
5. Upon extinguishing that debt, cascade the full monthly payment into the debt with the second-highest APR.
6. Benefit: Mathematically optimal. Minimizes total lifetime interest paid and reduces overall time to debt freedom.

## 3. Financial Independence Runway: Time to Thrive
Traditional personal finance focuses on emergency funds measured in raw dollar amounts. The "Time to Thrive" metric converts liquid capital into units of time:
`Time to Thrive (Months) = Total Liquid Savings / Monthly Essential Living Expenses`
- Essential Living Expenses: Housing (rent/mortgage), groceries, essential utilities, transportation, health insurance, minimum debt obligations.
- Interpretation:
  - < 3 Months: Vulnerable. Priority should be building immediate liquidity.
  - 3 to 6 Months: Stable. Provides insulation against sudden job loss or medical emergencies.
  - 12 to 24 Months: Resilient. Enables career risk-taking, entrepreneurship, or sabbatical.
  - 5+ Years: High Autonomy. Approaching self-sustaining financial independence.

## 4. International Legal Tax Optimization Masterclasses
### United States (IRS / Internal Revenue Code Title 26)
- High Court Doctrine: Helvering v. Gregory, 69 F.2d 809 (Judge Learned Hand) & Gregory v. Helvering, 293 U.S. 465. Supreme Court affirmed that taxpayers have a legal right to minimize taxes through legitimate statutory means.
- Solo 401(k) & Cash Balance Plans (IRC § 401, § 412, § 415): Allows self-employed and high-income professionals to contribute up to $70,000+ in Solo 401(k) and $100,000–$350,000+ in Cash Balance defined benefit pension plans annually as pre-tax business deductions.
- Health Savings Account (HSA - IRC § 223): Triple-tax advantaged (pre-tax contribution, tax-free growth, tax-free distribution for medical). Multi-decade "Shoebox Strategy" allows paying current medical out-of-pocket, letting HSA compound in index funds, and reimbursing receipts decades later tax-free.
- Mega Backdoor Roth: After-tax non-Roth 401(k) contributions rolled over or converted in-plan to Roth up to the § 415(c) limit ($70,000+), bypassing standard Roth IRA income phaseouts.
- Real Estate Professional Status (REPS - IRC § 469(c)(7)): Allows real estate professionals (750+ hours and >50% personal services) to deduct non-passive paper depreciation losses against ordinary active W-2 and business income.
- Short-Term Rental (STR) Exception (Treas. Reg. § 1.469-1T(e)(3)(ii)(A)): 7-day average stay classifies rental as active business; material participation allows immediate paper loss write-offs without full REPS.
- Cost Segregation & Bonus Depreciation (IRC § 168(k)): Reclassifies building components into 5-, 7-, and 15-year property for accelerated Year 1 tax write-offs (20%–35% of total purchase price).
- Section 1031 Like-Kind Exchanges: 100% tax deferral on commercial and investment real estate sales rolled into replacement properties within 45/180 days.
- Section 121 Principal Residence Exclusion: $250,000 (single) or $500,000 (married filing jointly) tax-free capital gains on primary residence lived in 2 of the prior 5 years.
- Section 1202 Qualified Small Business Stock (QSBS): 100% federal capital gains tax exclusion up to $10,000,000 or 10x basis on original C-Corp shares held >5 years.
- S-Corporation Election (Form 2553): Division of profits into reasonable W-2 salary and distributions; distributions are 100% exempt from 15.3% FICA self-employment taxes.
- Augusta Rule (IRC § 280A(g)): Renting personal home to business entity for up to 14 days per year tax-free to homeowner and 100% deductible to corporation.
- Employing Minor Children (IRC § 73): Children under 18 employed by parent sole proprietorships/single-member LLCs are exempt from FICA/FUTA and can earn up to the standard deduction at 0% tax, funding custodial Roth IRAs.
- "Buy, Borrow, Die": Holding appreciating assets unrealized, drawing tax-free liquidity via Securities-Backed Lines of Credit (SBLOC), and passing assets to heirs at death to trigger IRC § 1014 Step-Up in Basis to fair market value, permanently erasing historical capital gains tax.

### United Kingdom (HMRC Statutes & Taxes Acts)
- Legal Doctrine: IRC v Duke of Westminster [1936] AC 1 (Lord Tomlin) establishing that every person is entitled to order their affairs so tax is minimized. Distinguished from artificial avoidance under Ramsay [1982] and GAAR (Part 5 Finance Act 2013).
- Individual Savings Account (ISA - ISA Regs 1998): £20,000 annual allowance 100% permanently exempt from Income Tax, Dividend Tax, and Capital Gains Tax. Zero Self Assessment reporting required.
- Lifetime ISA (LISA): £4,000 annual allowance with 25% instant government bonus (£1,000 free/year) for first-time home or age 60+ retirement.
- Self-Invested Personal Pensions (SIPP - Finance Act 2004): £60,000 annual allowance with 3-year carry-forward (up to £180,000+ in one tax year). 20% basic relief at source, 40%/45% higher/additional rate relief on tax returns.
- Neutralizing the 60% Marginal Tax Trap (£100,000–£125,140): Section 35 Income Tax Act 2007 withdraws £1 of Personal Allowance for every £2 earned above £100k, creating 60% tax plus loss of 30 hours free childcare and Tax-Free Childcare (£2k/child). SIPP gross contributions pull Adjusted Net Income back to £100,000, recovering the full allowance and government childcare.
- Seed Enterprise Investment Scheme (SEIS - Part 5A ITA 2007): 50% upfront income tax relief on up to £200,000 invested, 50% CGT re-investment relief, 0% CGT on exit after 3 years.
- Enterprise Investment Scheme (EIS - Part 5 ITA 2007): 30% upfront income tax relief on up to £1,000,000 (£2M for KICs), 100% CGT deferral relief, 0% CGT after 3 years, Business Relief 100% IHT exemption after 2 years.
- Venture Capital Trusts (VCT): 30% upfront relief on up to £200,000, 100% tax-free dividends, 0% CGT on share disposals.
- Limited Company SPVs for Property: Section 24 Finance (No. 2) Act 2015 restricts individual mortgage interest to a 20% basic tax credit; Ltd SPVs deduct 100% of mortgage interest as allowable corporate expenses.
- Director Salary + Dividend Split: Draw £12,570 salary (deductible for company, £0 NICs, earns State Pension credit) and balance in dividends at lower dividend tax rates (8.75% basic, 33.75% higher).
- Inheritance Tax (IHT - IHTA 1984): Nil-rate band (£325k) + Residence nil-rate band (£175k) = £1,000,000 combined spousal allowance. Potentially Exempt Transfers (PETs) become 100% tax-free if donor survives 7 years. Section 21 gifts out of normal surplus income are immediately 100% tax-free with no 7-year requirement. Business Relief gives 100% IHT exemption on trading and AIM-listed shares held >2 years.
- EV Salary Sacrifice: Benefit-in-Kind (BiK) rate of 2%–3% allows employees to sacrifice gross salary for electric cars, saving 42%–47% on lease, insurance, and maintenance.

### Australia (ATO / ITAA 1936 & ITAA 1997)
- Legal Doctrine: Sir Garfield Barwick CJ in FC of T v Westraders Pty Ltd [1980], upholding Duke of Westminster doctrine. Must comply with Part IVA statutory general anti-avoidance rules (genuine commercial substance).
- Family Discretionary Trusts (Division 6 ITAA 1936): Distributing investment income across adult beneficiaries in lower tax brackets.
- Corporate Beneficiaries / Bucket Companies (Division 7A): Capping investment tax at 25% or 30% corporate rates rather than 47% top individual rate, with complying 7-year unsecured or 25-year secured loan agreements.
- Concessional Superannuation (s 290-170): $30,000 annual pre-tax contribution cap taxed at 15% inside fund rather than personal rates up to 47%. 5-Year Carry-Forward provisions (s 291-20) allow utilizing up to $100k+ in unused caps to eliminate windfall capital gains tax if Total Super Balance is under $500,000.
- Account-Based Pension Phase (s 295-385): 0% tax on investment earnings, 0% tax on realized capital gains, 0% tax on member pension withdrawals, with full cash franking credit refunds from the ATO.
- Negative Gearing & Section 15-15 PAYG Variation: Offsetting net rental property losses against ordinary salary income, with ATO PAYG variations adjusting employer tax withholding dynamically.
- Division 40 & 43 Depreciation: Capital Works Allowance (2.5%/year for 40 years) and plant & equipment depreciation providing $8,000–$18,000/year non-cash deductions via quantity surveyor reports.
- 6-Year Main Residence Absence Rule (s 118-145): Renting out a former principal place of residence for up to 6 years while preserving 100% tax-free capital gains status on sale.
- Small Business CGT Concessions (Division 152): 15-year retirement exemption, 50% active asset reduction, small business rollover, and retirement exemption reducing business sale capital gains to 0%.
- Electric Vehicle (EV) Novated Leasing: 100% FBT exemption under the Treasury Laws Amendment (Electric Car Discount) Act for eligible zero-emission vehicles below the Luxury Car Tax threshold.