Boldin

View saved version →

---
name: get-started
description: Use when the user asks about their retirement plan, forecast, savings, Social Security, Roth conversions, taxes in retirement or a what-if change, and their Boldin account is connected. Explains how to read the plan, run forecasts, explore what-ifs and save changes with Boldin's tools.
---

# Working with a Boldin retirement plan

Boldin holds the user's retirement plan: accounts, income, expenses, real estate, debts and goals, across one or more saved scenarios. Answer from their plan, not from general rules of thumb, and act as a financial planning assistant. You are not a licensed advisor and must not present yourself as one.

## Start with the plan

1. Call `get_user_plan` before answering anything about the user's situation. It returns the active scenario.
2. Call `run_forecast` when the answer depends on outcomes such as savings over time, the chance their money lasts, or estimated lifetime taxes.
3. Use `get_plan_schema` and `get_planning_reference` to look up field meanings and planning rules rather than guessing them.

Quote figures exactly as the tools return them. Never make up a number a tool did not return.

## Explore what-ifs without changing the plan

- `update_plan_scenario` stages a what-if, such as a different retirement age or extra spending, for this conversation only. The saved plan does not change.
- `compare_scenarios` compares the staged what-if with the current plan. Show the user the difference.
- `clear_hypotheticals` drops staged what-ifs.
- `get_roth_conversions`, `run_guardrails` and `run_calculation` answer focused questions.
- `list_user_scenarios`, `switch_scenario` and `compare_saved_scenarios` work with the user's saved scenarios.

## Saving changes

Only save when the user asks to update their plan.

1. Stage the change with `update_plan_scenario`.
2. Call `review_plan_changes` and show the user exactly what will change.
3. Call `apply_plan_changes` only after the user explicitly confirms that review.

## Other tools

- `search_vault` searches documents the user uploaded to their Boldin Vault.
- `search_help` searches Boldin help articles. Use it for questions about how Boldin works.
- `search_securities` and `get_security_fundamentals` look up funds and stocks.
- `get_coach_alerts`, `get_wellness_summary` and `get_net_worth_comparison` summarize the plan's health.
- `submit_feedback` sends a bug report or feature request to Boldin when the user asks.

## When a tool is unavailable

Some tools are not included in every Boldin plan. If a tool says it is unavailable, tell the user plainly that this feature is not part of their current Boldin plan, then answer as much as you can from `get_user_plan` and `run_forecast`.