| name | Market Rent Refresh |
| slug | market_rent_refresh |
| version | 0.1.0 |
| status | draft |
| category | residential_multifamily |
| subsystem | residential_multifamily |
| pack_type | workflow |
| targets | ["claude_code"] |
| stale_data | Market references drift constantly. Staleness threshold per category lives in overlays.
The refresh builds a bundle and hands off to `workflows/rent_comp_intake` for ingestion;
it does not directly author benchmarks without the intake workflow's normalization and
approval steps.
|
| applies_to | {"segment":["middle_market"],"form_factor":["garden","walk_up","wrap","suburban_mid_rise","urban_mid_rise"],"lifecycle":["stabilized","renovation","lease_up","recap_support"],"management_mode":["self_managed","third_party_managed","owner_oversight"],"role":["property_manager","leasing_manager","regional_manager","asset_manager"],"output_types":["checklist","memo","kpi_review"],"decision_severity_max":"recommendation"} |
| references | {"reads":["reference/normalized/market_rents__{market}_mf.csv","reference/normalized/concession_benchmarks__{market}_mf.csv","reference/normalized/comp_normalization_rules__middle_market.yaml"],"writes":[]} |
| metrics_used | ["market_to_lease_gap","loss_to_lease","rent_growth_new_lease","rent_growth_renewal","concession_rate"] |
| escalation_paths | [{"kind":"stale_reference","to":"property_manager -> regional_manager (refresh responsibility)"},{"kind":"comp_magnitude_change","to":"regional_manager -> asset_manager (via rent_comp_intake)"}] |
| approvals_required | ["market_rent_reference_update_above_magnitude_delta"] |
| description | Checks freshness of market rent and concession references against overlay staleness
threshold; organizes a refresh plan (comp sources, shop list, 3rd-party export, submarket
coverage); produces the intake bundle for `workflows/rent_comp_intake` to process.
Outputs a current-state memo and a refreshed benchmark view on completion.
|
Market Rent Refresh
Workflow purpose
Keep market rent and concession benchmarks fresh. Detect staleness per overlay threshold, organize a refresh (shopped comps, 3rd-party export, operator-reported), and hand off the resulting bundle to workflows/rent_comp_intake. Output a current-state view for renewal and pricing decisions.
Trigger conditions
- Explicit: "refresh market rents for X market", "shop comps for submarket Y", "quarterly market survey".
- Implicit: reference
as_of_date older than overlay staleness threshold; renewal or funnel workflow cites stale benchmark; supply event (new delivery) in submarket.
- Recurring: quarterly per market; ad hoc when a trigger fires.
Inputs (required / optional)
| Input | Type | Required | Notes |
|---|
| Current benchmark files | csv | required | freshness check |
| Shop list | list | required | properties to survey |
| 3rd-party exports | table | optional | where available |
| Operator-reported inputs | list | optional | from PM/leasing |
| Submarket definitions | yaml | required | |
Outputs
| Output | Type | Shape |
|---|
| Freshness status | kpi_review | per market/submarket reference as_of_date |
| Refresh plan | checklist | sources, dates, owners |
| Current-state memo | memo | market and concession snapshot |
| Comp bundle | handoff | passed to workflows/rent_comp_intake |
Required context
Asset_class, segment, market, submarket.
Process
- Freshness check. Scan all benchmarks for the market; identify stale per overlay.
- Refresh plan. For each stale reference, define sources; assign owners and dates.
