investment-committee-prep

name	Investment Committee Prep
slug	investment_committee_prep
version	0.1.0
status	draft
category	residential_multifamily
subsystem	residential_multifamily
pack_type	workflow
targets	["claude_code"]
stale_data	IC cadence, docket capacity bands, memo-template sections, condition-tracking deadlines, sensitivity-test materiality bands, and comp-evidence freshness policy are all overlay-driven. The IC-member roster and LP capital-availability posture drift cycle-to-cycle; IC-condition deadlines are per-deal and drift with any approved extension. Rent-comp and sale-comp reference inventories refresh on reference-library cadence; stale comps surface through confidence banner.
applies_to	{"segment":["middle_market","luxury","affordable"],"form_factor":["garden","walk_up","wrap","suburban_mid_rise","urban_mid_rise","high_rise"],"lifecycle":["development","construction","lease_up","stabilized","renovation","recap_support"],"management_mode":["self_managed","third_party_managed","owner_oversight"],"role":["investments_lead","asset_management_director","executive","ic_members"],"output_types":["memo","kpi_review","dashboard","checklist"],"decision_severity_max":"action_requires_approval"}
references	{"reads":["reference/connectors/adapters/dealpath_deal_pipeline/normalized_contract.yaml","reference/connectors/adapters/dealpath_deal_pipeline/dq_rules.yaml","reference/connectors/deal_pipeline/schema.yaml","reference/connectors/master_data/asset_crosswalk.yaml","reference/connectors/master_data/market_crosswalk.yaml","reference/derived/role_kpi_targets.csv","reference/normalized/approval_threshold_defaults.csv","reference/normalized/market_rents__{market}_mf.csv","reference/normalized/rent_comp_evidence__{market}_mf.csv","reference/normalized/sale_comp_evidence__{market}_mf.csv"],"writes":[]}
metrics_used	["ic_approval_rate","ic_deferral_rate","ic_decline_rate","ic_condition_completion_rate","ic_condition_aging_days","ic_docket_load_count","sensitivity_test_pass_rate","comp_evidence_freshness_days","lp_capital_coverage_ratio","ic_cycle_time_days"]
escalation_paths	[{"kind":"ic_condition_past_deadline","to":"deal_team_lead -> investments_lead -> asset_management_director -> approval_request(row per matrix)"},{"kind":"sensitivity_test_material_failure","to":"investments_lead -> executive"},{"kind":"comp_evidence_stale_beyond_policy","to":"investments_lead -> data_platform_team"},{"kind":"lp_capital_shortfall","to":"investments_lead -> cfo_finance_leader -> executive"},{"kind":"dq_blocker_from_dealpath","to":"data_platform_team -> investments_lead; affected deals paused from docket"}]
approvals_required	["ic_committee_approval"]
description	Pre-IC packet assembly for each IC cycle. Assembles the docket, pulls each deal's memo and cross-references, tracks IC conditions from prior decisions through to completion, consumes the sensitivity / stress-test output, surfaces comp evidence with freshness flags, and runs an LP capital availability check. The pack is the IC committee's input; the committee owns the decision. The workflow refuses to publish a deal's packet if blocking Dealpath DQ rules are open (`dp_completeness_ic_record`) or if required sensitivity tests are missing. Outputs include the IC packet, the condition-tracking rollup (from prior cycles), and the post-IC condition-log draft ready for minute-keeping.

Investment Committee Prep

Workflow purpose

Deliver a clean, auditable IC packet that lets the committee make the decision. Compose the docket, cross-reference each deal memo, track conditions from prior decisions to closure, verify the sensitivity / stress-test battery ran and published, surface comp evidence with freshness flags, and confirm LP capital availability against the capital call required for approvals on this docket. The workflow does not make the IC decision; it assembles the input and records the minute-ready artifact.

Trigger conditions

• Explicit: "prep the IC packet", "IC agenda for next cycle", "draft the IC memo cross-references", "condition-tracking rollup", "sensitivity posture for tomorrow's IC".
• Implicit: an IC meeting is within overlay-defined prep window (typically 5-10 business days); any deal enters ic_review in Dealpath; workflows/pipeline_review flags an IC-load approaching capacity band; an IC condition deadline approaches within overlay band; a sensitivity test is requested by the investments_lead.
• Recurring: bi-weekly per the overlay IC cadence, or event-driven per IC meeting. Condition-tracking sweep runs daily.

Inputs (required / optional)

Input	Type	Required	Notes
Dealpath normalized deal records	table	required	scope: deals at ic_review, ic_approved, or under_dd for pre-IC advisory
Dealpath normalized deal_milestone records	table	required	covers prior IC decisions and condition history
Dealpath normalized investment_committee_review records	table	required	per-cycle IC review state
Canonical asset records	table	required	resolved via master_data/asset_crosswalk.yaml
Dealpath dq outcomes	table	required	dq_rules.yaml evaluation; dp_completeness_ic_record blocks any IC-approved roll-up
IC calendar + docket policy overlay