{"id":88068,"plugin_id":"plugin_asdk_app_6abcebba386c81918f046d4b6af3c4d0","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-10T00:09:03.699Z","digest":"6226495d1cd64cdabd1fa7fa237102451409b23e4ce760d2adbece25276b0eac","against":null,"payload":{"description":"Scenarios and cash in Layerz: a base, upside and downside case, a fundraise or a delayed hire, runway, a cash-flow forecast, \"what if\", switching between actuals and forecast at the cutover. Creates scenario branches, writes scenario values without touching the base, reads branch versus base, and builds the cash balance and the runway the right way.","included_files":[{"relative_path":"references/04-stock-flow-rolling-balances.md","size_in_bytes":906},{"relative_path":"references/07-branches-scenarios-and-actuals.md","size_in_bytes":4265}],"name":"scenarios-and-cash","skill_md_contents":"---\nname: scenarios-and-cash\ndescription: \"Scenarios and cash in Layerz: a base, upside and downside case, a fundraise or a delayed hire, runway, a cash-flow forecast, \\\"what if\\\", switching between actuals and forecast at the cutover. Creates scenario branches, writes scenario values without touching the base, reads branch versus base, and builds the cash balance and the runway the right way.\"\nlicense: MIT\nmetadata:\n  layerz_version: \"1.1.0\"\n  generated_by: \"layerzlabs/layerz scripts/build-plugin-skills.ts, from the modeling guide\"\n---\n\n# Layerz: Scenarios and cash\n\n**Instruction priority.** Explicit instructions from the user in the conversation come first. Then the model's FINANCE.md and the workspace conventions: both come back as `conventions` in the results of `layerz_get_model`, `layerz_create_model`, `layerz_build_from_blueprint`, an unfiltered `layerz_read` and `layerz_get_conventions`. They describe this workspace and this model (currency, units, signs, depth, structure, who reads it) and override the defaults below. Your own skills and instructions keep their priority on how you work. This skill describes how the Layerz tools work and in which order; it states no fact about any business.\n\n## When this applies\n\nScenarios (base, upside, downside, a fundraise, a hire delayed), runway, a cash-flow forecast, \"what if\", actuals versus forecast.\n\n## Sequence\n\n1. `layerz_get_conventions { model_id }` and a `layerz_read` of the base: which assumptions drive cash, where the cash `balance` is, where `actuals_through` stands.\n2. A scenario is a branch; no data source is involved. `layerz_update_branch` with `patch.display_name` creates it; the same name again updates it.\n3. Scenario values: `layerz_patch { model_id, branch_id, ops }` with `update` ops carrying `value` / `values` / `timeline_values` on assumptions. Only the cells that differ from the base are stored; structure and non-value fields apply model-wide. The base is never overwritten to test a case.\n4. Read the scenario with `layerz_read { branch_id }` (`v` the branch, `vv` branch minus base); without `branch_id`, reads and writes are the base plan.\n5. Cash forecast: cash is a `balance` fed by callups of the operating, investing and financing flows; a fundraise is one assumption (amount and month) that moves cash, equity and runway together; runway is a formula on the cash balance and the monthly burn. With actuals in the model, `IF(IS_ACTUAL, actual_line, forecast_line)` switches at the cutover, pinned with `layerz_update_branch` and `patch.actuals_through`.\n6. Dashboard: KPIs read the branch checked out; `period_mode: \"ytd\"` for year-to-date tiles; `meta.default_branch` opens the model on the scenario the user reads first.\n7. Hand over the comparison in words: what moves, by how much, under which assumption.\n\n## References\n\nFrom the Layerz modeling guide (version 1.1.0; the whole guide: `layerz_get_conventions { include_guide: true }` or the `modeling-guide://reference` resource):\n\n- [4. Stock-flow (rolling balances)](references/04-stock-flow-rolling-balances.md)\n- [7. Branches, scenarios and actuals](references/07-branches-scenarios-and-actuals.md)\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}