evan-moon/firma

What's new

👤 User profile — 5 fields, all optional

firma already knows your portfolio, balance sheet, and cash flow. The one thing it can't infer is your goals. v0.15.0 adds the smallest possible profile to fill that gap:

• birth_year — your age and time horizon
• retirement_target_year — when you want to stop needing a paycheck
• target_net_worth_usd — your "enough" number
• risk_tolerance — conservative / moderate / aggressive
• notes — free-form preferences, constraints, tax situation

We deliberately don't ask for things firma can derive: external assets and liabilities come from your balance sheet, monthly expenses from cash flow, tax bracket roughly from income.

How analysis changes

With a profile, generic statements become anchored:

• "$441K net worth" → "$441K = 44% of $1M target, 12 years to FIRE, current pace gets you 75% there"
• "TSLA +60%" → "TSLA +60% = 80% of portfolio. You said risk tolerance is moderate — that's inconsistent"
• Notes like "ESG only" or "no leveraged products" are honored across every recommendation

How to set it up

• In Claude: `/setup-profile` — Claude asks conversationally and skips anything you don't want to share
• In the terminal: `firma profile` — interactive wizard, press Enter to skip any field
• View anytime: `firma show profile` or `show_profile` MCP tool

Internals

• New `profile` table (single-row), schema-migrated automatically on first run
• `setup_status` returns the profile object so Claude has it in every conversation start
• `analyst_context` includes new principles for anchoring to the profile and deriving the rest from balance/flow