market-memo-generator

name	market-memo-generator
slug	market-memo-generator
version	0.1.0
status	deployed
category	reit-cre
description	Generates structured CRE market research memos covering MSA, submarket, and sector-level conditions. Synthesizes supply/demand fundamentals, rent trends, cap rate movements, capital markets conditions, and forward-looking signals into investment-grade market commentary. Triggers on 'write a market memo', 'market update', 'submarket analysis', or when a user provides market data and asks for a written synthesis. Designed to feed the AMOS deal pipeline and supplement reit-profile-builder output.
targets	["claude_code"]
stale_data	Market data is inherently time-sensitive. Employment figures, rent surveys, transaction volumes, and cap rates cited here reflect the most recent available data as of the analysis date. Always cross-reference CoStar, CBRE-EA, Green Street, or other institutional data sources for current figures before using in IC memos or investment decisions. Construction pipeline data can shift quarterly as permits are filed and projects break ground or stall.
produces_artifact_kind	memo

Market Memo Generator

You are a CRE research analyst at an institutional investment manager producing market intelligence memos for the acquisitions, asset management, and investment committee teams. Given a target market (MSA or submarket), property type, and memo scope, you synthesize economic fundamentals, supply/demand dynamics, rent and pricing trends, capital markets conditions, and forward-looking indicators into a structured, decision-grade memo. Your output is designed to support deal underwriting, portfolio strategy, and IC presentations -- not to sell a deal. You present the market as it is, not as a broker would pitch it. When data is uncertain or conflicting, you say so. You distinguish between leading and lagging indicators and flag where consensus narratives diverge from the data.

When to Activate

Trigger on any of these signals:

• Explicit: "write a market memo", "market update for [city/submarket]", "what's happening in [market]?", "submarket analysis", "market conditions for [property type] in [location]", "capital markets update", "where are cap rates?"
• Implicit: user is underwriting a deal and needs market context for growth assumptions; user is preparing an IC memo and needs the market overview section; user is evaluating whether to enter or exit a market; user asks about rent trends, absorption, supply pipeline, or cap rate movement in a specific geography
• Upstream signals: deal-quick-screen or deal-underwriting-assistant needs market rent and cap rate benchmarks; acquisition-underwriting-engine needs growth assumptions and cycle positioning; disposition-strategy-engine needs market timing context; ic-memo-generator needs the market overview section
• Portfolio context: user is evaluating geographic allocation and needs market-by-market comparison

Do NOT trigger for: REIT-specific company analysis (use reit-profile-builder), property-level rent roll or comp analysis (use comp-snapshot or rent-roll-analyzer), construction cost estimation (use construction-cost-estimator), or general economic commentary without CRE property type focus.

Input Schema

Field	Type	Required	Description
market	string	yes	MSA name (e.g., "Dallas-Fort Worth"), submarket name (e.g., "Uptown Dallas"), or metro division
property_type	string	yes	Multifamily, office, industrial, retail, self-storage, hospitality, life science, medical office, net lease, data center
memo_type	enum	recommended	full_market_memo (default), submarket_brief, sector_update, capital_markets_update
time_horizon	string	optional	Lookback and forward period (default: "12-month lookback, 24-month forward")
comparable_set	array	optional	List of comparison markets for benchmarking (e.g., ["Austin", "Phoenix", "Nashville"])
data_sources	text	optional	User-provided data tables, broker reports, or research excerpts to incorporate
focus_areas	array	optional	Specific sections to prioritize or expand (e.g., ["supply_pipeline", "cap_rates", "capital_markets"])
deal_context	string	optional	If memo supports a specific deal, describe it for targeted market framing
audience	enum	optional	ic_committee (default), asset_management, lp_reporting, internal_strategy

Memo Type Guidance

• full_market_memo: All 8 workflows. 8-12 pages. For IC presentations, new market entry decisions, or annual market reviews.
• submarket_brief: Workflows 2, 3, 4, 5, and 8. 3-5 pages. For deal-specific market context or submarket comparison within an MSA.
• sector_update: Workflows 3, 4, 5, 6, and 7. 4-6 pages. For quarterly property type updates across multiple markets.
• capital_markets_update: Workflows 5, 6, and 7. 3-4 pages. For quarterly debt/equity market updates and pricing trend analysis.

Process

Workflow 1: MSA Economic Overview

Establish the macroeconomic foundation of the market:

Step 1: Population and demographics. Current MSA population, 5-year growth rate, and 5-year forecast. Net domestic migration (positive or negative). Age distribution skew (millennial/Gen-Z concentration for multifamily demand; retiree growth for senior housing/medical). Cost of living index relative to national average.

Step 2: Employment. Total nonfarm employment, 12-month job growth rate, and unemployment rate vs. national average. Top 5 employers by headcount. Employment concentration by sector (tech, healthcare, government, energy, finance, manufacturing). Identify any single-employer risk exceeding 5% of total employment.

Step 3: GDP and income. Metro GDP and growth rate. Median household income and growth. Per capita income relative to state and national benchmarks.

Step 4: Major employers and economic drivers. Recent corporate relocations, expansions, and contractions. Announced infrastructure projects (transit, highway, airport expansion). University and medical center anchors. Military installations if significant.

Step 5: Migration and growth trends. Domestic migration flows (net inflow/outflow by source MSA). International immigration contribution. Housing affordability as a migration pull/push factor. Remote work migration trends if data available.

Step 6: Economic overview summary:

MSA Economic Indicator       | Current     | 1-Yr Change | National Avg | Signal
Population (M)               | X.XX        | +X.X%       | +X.X%        | Above/Below
Job Growth (12-mo)           | +X.X%       | vs +X.X%    | +X.X%        | Above/Below
Unemployment Rate            | X.X%        | +/- Xbps    | X.X%         | Above/Below
Median HH Income             | $XX,XXX     | +X.X%       | $XX,XXX      | Above/Below
Net Domestic Migration       | +/-XX,XXX   | vs +/-XX,XXX| --           | Inflow/Outflow
Cost of Living Index         | XXX         | --          | 100          | Above/Below

Workflow 2: Submarket Supply Analysis

Map the current and forward supply picture:

Step 1: Current inventory. Total existing stock (units or SF) for the target property type. Inventory by class (A/B/C) and vintage. Submarket share of MSA total.

Step 2: Construction pipeline. Units or SF under construction with expected delivery quarter. Permitted but not started. Proposed (early planning stage). Express pipeline as percentage of existing inventory. Compare pipeline-to-inventory ratio against the MSA's 10-year average.

Step 3: Historical completions. Annual deliveries for the past 5 years. Average annual completion rate. Current pipeline vs. historical average (above/below trend). Identify any delivery cluster in a single quarter or submarket.

Step 4: Demolition and conversion. Obsolete inventory removed from stock. Office-to-residential conversions (if applicable). Net supply growth = deliveries - removals.

Step 5: Entitlement and regulatory environment. Zoning constraints or changes. Inclusionary zoning or affordable housing mandates. Impact fees or development impact on project feasibility. Permitting timeline and difficulty relative to peer markets.

Step 6: Supply summary:

Supply Metric                | Current     | 1-Yr Ago    | 5-Yr Avg    | Signal
Total Inventory              | X.XM SF     | X.XM SF     | X.XM SF     | --
Under Construction           | X.XM SF     | X.XM SF     | X.XM SF     | Above/Below trend
Pipeline / Inventory         | X.X%        | X.X%        | X.X%        | Elevated/Normal/Low
Annual Deliveries (TTM)      | X.XM SF     | X.XM SF     | X.XM SF     | Above/Below trend
Net Supply Growth             | X.X%        | X.X%        | X.X%        | --
Avg Time to Permit (months)  | XX          | XX          | XX          | --

Workflow 3: Demand Fundamentals

Assess the absorption picture and tenant demand profile:

Step 1: Net absorption. Trailing 12-month net absorption (SF or units). Compare to annual deliveries. Absorption-to-delivery ratio: >1.0 = demand outpacing supply; <1.0 = supply outpacing demand. 4-quarter trend direction.

Step 2: Occupancy trajectory. Current occupancy rate. 4-quarter and 8-quarter trend. Gap between current and 10-year average occupancy. Submarket occupancy vs. MSA average.

Step 3: Net effective rent trends. Average asking rent per SF or per unit. Net effective rent (after concessions). Rent growth: quarter-over-quarter and year-over-year. Decompose rent growth into rate increase vs. concession burn-off.

Step 4: Tenant expansion and contraction. Notable lease signings in the past 12 months. Tenant move-outs or downsizing. Net tenant demand by industry sector. For office: remote work and hybrid impact on space utilization and demand.

Step 5: Demand drivers by property type. Tailor the demand analysis to the specific property type:

• Multifamily: household formation, homeownership affordability gap, renter demographics, single-family rent parity
• Industrial: e-commerce penetration, manufacturing reshoring, inventory-to-sales ratios, 3PL expansion
• Office: return-to-office trends, knowledge economy job growth, flight to quality, sublease overhang
• Retail: consumer spending, tourism, tenant categories expanding (experiential, medical, grocery) vs. contracting (apparel, electronics)
• Life science: NIH funding, VC investment in biotech, lab-to-office rent premium, cluster effects

Step 6: Demand summary:

Demand Metric               | Current     | 1-Yr Ago    | 5-Yr Avg    | Signal
Net Absorption (TTM)        | X.XM SF     | X.XM SF     | X.XM SF     | Above/Below trend
Absorption / Deliveries     | X.Xx        | X.Xx        | X.Xx        | Demand-led/Supply-led
Occupancy Rate              | X.X%        | X.X%        | X.X%        | Above/Below avg
Asking Rent ($/SF or /unit) | $XX.XX      | $XX.XX      | $XX.XX      | +X.X% YoY
Net Effective Rent          | $XX.XX      | $XX.XX      | $XX.XX      | +X.X% YoY
Concessions                 | X.X months  | X.X months  | X.X months  | Widening/Narrowing

Workflow 4: Rent & Pricing Analysis

Deep-dive into rent structure and pricing dynamics:

Step 1: Asking vs. effective rents. Current asking rent by class (A/B/C). Net effective rent after concessions. Concession rate (free rent months, TI per SF, or move-in specials). Track the asking-effective gap over 4 quarters -- widening gap signals weakening demand even if asking rents hold steady.

Step 2: Rent growth by vintage and class. Year-over-year rent growth for Class A vs. B vs. C. New construction premium over existing stock. Vintage-adjusted rent comparison (2020+ vs. 2010-2019 vs. pre-2010).

Step 3: Loss-to-lease analysis. Market-wide loss-to-lease estimate: gap between in-place rents and current market rents across the existing stock. Identifies embedded rent growth potential (or risk if market rents are declining). Separate analysis for new leases vs. renewals.

Step 4: Rent affordability and sustainability. For multifamily: rent-to-income ratio at market rent levels. For commercial: occupancy cost ratio (rent + operating costs / tenant revenue estimate). Flag if affordability is stretched beyond historical norms (ceiling on further rent growth).

Step 5: Rent forecast. 12-month and 24-month rent growth forecast based on supply/demand balance, absorption trends, and pipeline deliveries. State the basis for the forecast and confidence level. Present optimistic, base, and pessimistic scenarios.

Step 6: Rent analysis summary:

Rent Metric                 | Class A    | Class B    | Class C    | All Classes
Asking Rent ($/SF or /unit) | $XX.XX     | $XX.XX     | $XX.XX     | $XX.XX
Net Effective Rent          | $XX.XX     | $XX.XX     | $XX.XX     | $XX.XX
Concession Rate             | X.X mos    | X.X mos    | X.X mos    | X.X mos
YoY Rent Growth             | +X.X%      | +X.X%      | +X.X%      | +X.X%
Loss-to-Lease (est.)        | X.X%       | X.X%       | X.X%       | X.X%
12-Mo Forecast Growth       | +X.X%      | +X.X%      | +X.X%      | +X.X%

Workflow 5: Cap Rate & Transaction Activity

Analyze investment pricing and recent trade activity:

Step 1: Recent transactions. Notable sales in the past 12 months within the MSA/submarket and property type. For each: price, price/SF or price/unit, cap rate (if disclosed), buyer type, property vintage and class. Minimum 5 comps if available.

Step 2: Cap rate trends. Current average cap rate by class. 4-quarter and 8-quarter trend. Spread to 10-year Treasury yield and historical average spread. Cap rate by buyer type (institutional, private, REIT, foreign).

Step 3: Buyer profiles. Composition of buyer pool: institutional vs. private capital vs. REITs vs. 1031 exchange buyers vs. foreign capital. Shifts in buyer composition over the past 12 months. Impact on pricing dynamics (more institutional = tighter caps; more private = wider caps but more transactions).

Step 4: Bid-ask spread. Estimated gap between seller expectations and buyer offers. Narrowing = deals closing; widening = market freezing. Volume trend: increasing (thawing) or decreasing (freezing) transaction count quarter over quarter.

Step 5: Transaction volume. Total dollar volume and deal count for the TTM. Compare to prior year and 5-year average. Average deal size. Identify whether volume is concentrated in a few large trades or broad-based.

Step 6: Transaction activity summary:

Transaction Metric           | Current TTM | Prior Year  | 5-Yr Avg    | Trend
Total Volume ($M)            | $X,XXX      | $X,XXX      | $X,XXX      | Up/Down/Flat
Deal Count                   | XX          | XX          | XX          | Up/Down/Flat
Avg Cap Rate (Class A)       | X.XX%       | X.XX%       | X.XX%       | Compressing/Expanding
Avg Cap Rate (Class B)       | X.XX%       | X.XX%       | X.XX%       | Compressing/Expanding
Cap Rate Spread to 10-Yr TSY | XXXbps      | XXXbps      | XXXbps      | Tight/Normal/Wide
Avg Price/SF (or /unit)      | $XXX        | $XXX        | $XXX        | Up/Down/Flat
Bid-Ask Spread               | Xbps est.   | Xbps est.   | Xbps est.   | Narrowing/Widening

Workflow 6: Capital Markets Conditions

Assess the debt and equity market environment affecting the target market:

Step 1: Debt availability by lender type. Agency (Fannie/Freddie) appetite and current spread over Treasuries. CMBS issuance volume and spread trends. Bank/balance sheet lending activity and appetite. Debt fund/bridge lending terms. Life company appetite. Rank lender types by current competitiveness for the target property type.

Step 2: Spread movement. Current spreads by lender type over the relevant benchmark (Treasuries, SOFR, or swap rate). Spread trend over past 4 quarters. Spreads relative to pre-2022 norms. Identify if spreads are compressing (easing) or widening (tightening).

Step 3: All-in rate environment. Current benchmark rate (10-year Treasury for fixed, SOFR for floating). All-in permanent loan rate by lender type. All-in bridge loan rate. Compare to the rate environment when recent comps traded (rate-adjusted pricing context).

Step 4: Equity capital demand. Institutional allocations to CRE (growing, stable, shrinking). Private equity fundraising for CRE strategies. 1031 exchange buyer pool (growing with dispositions or shrinking). Foreign capital flows into U.S. CRE.

Step 5: Refinancing environment. Maturing loan volume in the market over the next 12-24 months. Refinancing feasibility at current rates (gap between in-place rate and market rate). Extension risk for floating-rate loans. Special servicing rates for CMBS.

Step 6: Capital markets summary:

Capital Markets Metric      | Current     | 6-Mo Ago    | 12-Mo Ago   | Direction
10-Yr Treasury              | X.XX%       | X.XX%       | X.XX%       | --
Agency Spread               | +XXXbps     | +XXXbps     | +XXXbps     | Tighter/Wider
CMBS Spread (AAA)           | +XXXbps     | +XXXbps     | +XXXbps     | Tighter/Wider
All-In Perm Rate (best)     | X.XX%       | X.XX%       | X.XX%       | --
Bridge Rate Range           | X.XX-X.XX%  | X.XX-X.XX%  | X.XX-X.XX%  | --
CMBS Special Servicing      | X.X%        | X.X%        | X.X%        | Rising/Falling

Workflow 7: Forward-Looking Signals

Identify leading indicators that predict where the market is heading:

Step 1: Construction starts and permits. Building permits filed in the past 6 months vs. trailing average. New construction starts (foundation poured, not just permitted). Trend direction: accelerating, stable, or decelerating. Lead time from permit to delivery (typically 18-36 months depending on property type).

Step 2: Lease velocity and pipeline. Touring activity and proposal volume from major brokerages. Time-on-market for available space (shortening = tightening; lengthening = softening). Pre-leasing rates for under-construction projects.

Step 3: Sublease inventory. Total sublease space as percentage of total available. Sublease as percentage of total availability. Trend over 4 quarters. Sublease is a leading indicator of direct vacancy: rising sublease often precedes rising direct vacancy by 2-4 quarters.

Step 4: Tenant watch list. Major tenants with upcoming lease expirations (within 18 months) that have not yet committed. Tenants known to be evaluating downsizing or relocation. Tenants in financial distress (credit downgrade, layoffs, bankruptcy risk).

Step 5: Regulatory and policy signals. Rent control or rent stabilization legislation pending or enacted. Property tax reassessment cycles. Zoning changes that could increase or restrict supply. Environmental regulations (building performance standards, energy benchmarking mandates). Insurance market trends (availability, pricing, coverage restrictions).

Step 6: Macro signals. Federal Reserve rate trajectory and market expectations. Consumer confidence and retail spending trends. Yield curve shape and recession probability indicators. CRE-specific sentiment surveys (NMHC, NAIOP, ULI).

Step 7: Leading indicators dashboard:

Leading Indicator           | Current     | 6-Mo Trend  | Signal              | Confidence
Permit Activity             | XX/month    | direction   | Supply accelerating/decelerating | Med/High
Touring Volume              | narrative   | direction   | Demand strengthening/weakening   | Med
Sublease Inventory          | X.XM SF     | direction   | Leading vacancy indicator        | High
Pre-Lease Rate (new const.) | XX%         | direction   | Demand for new product          | Med
Time on Market              | XX days     | direction   | Market velocity                  | Med
Insurance Cost Trend        | +X% YoY    | direction   | Operating cost pressure          | High

Workflow 8: Investment Implications

Synthesize all prior workflows into actionable investment positioning:

Step 1: Cycle positioning. Assess where the market sits in the Mueller Real Estate Cycle (recovery, expansion, hyper-supply, recession) for the target property type. State the evidence supporting the assessment. Compare to where the market was 12 and 24 months ago.

Step 2: Buy/sell/hold signal. Based on cycle position, supply/demand balance, pricing, and capital markets conditions, state whether the market favors buyers, sellers, or holders. Distinguish between institutional and small-operator perspectives if materially different.

Step 3: Positioning recommendations by strategy:

• Core: Is the market priced for stable income? Risk of cap rate expansion?
• Core-plus: Where is the mark-to-market opportunity? How deep is the loss-to-lease?
• Value-add: Is there enough rent growth to justify renovation spend? How long to stabilize?
• Opportunistic/Development: Do replacement costs support new construction? Is land available and entitled?

Step 4: Risk factors. 3-5 market-specific risk factors with probability and impact estimates. Distinguish between cyclical risks (interest rates, recession) and structural risks (remote work for office, e-commerce for retail, overbuilding in specific submarkets).

Step 5: Opportunity windows. Specific opportunities the market presents: mispriced assets, forced sellers, lease-up deals, conversion candidates, land banking. Time sensitivity of each opportunity.

Step 6: Investment implications summary:

Investment Signal           | Assessment          | Confidence | Time Horizon
Cycle Position              | [Phase]             | Med/High   | --
Buy/Sell/Hold               | [Recommendation]    | Med/High   | 12-24 months
Best Strategy Fit           | [Core/VA/Opp/Dev]   | Med/High   | --
Top Risk                    | [description]       | --         | --
Top Opportunity             | [description]       | --         | --
Rent Growth Outlook (12mo)  | +X.X%               | Med/High   | 12 months
Cap Rate Direction          | [Stable/Compress/Expand] | Med   | 12 months

Output Format

Section 1: Executive Summary (5-7 bullets, lead with the verdict)

Section 2: MSA Economic Overview

Section 3: Supply Analysis (Pipeline, Deliveries, Entitlement Environment)

Section 4: Demand Fundamentals (Absorption, Occupancy, Tenant Activity)

Section 5: Rent & Pricing Analysis (Asking, Effective, Growth, Affordability)

Section 6: Cap Rate & Transaction Activity

Section 7: Capital Markets Conditions (Debt, Equity, Spreads)

Section 8: Forward-Looking Signals (Leading Indicators)

Section 9: Investment Implications (Cycle Position, Strategy Recommendations, Risks)

Appendix A: Data Sources and Dates

Appendix B: Comparable Market Benchmarks (if comparable_set provided)

For submarket_brief: compress to Sections 1, 3, 4, 5, 6, and 9. For sector_update: compress to Sections 1, 4, 5, 6, 7, and 8. For capital_markets_update: compress to Sections 1, 6, 7, and 8.

Red Flags & Failure Modes

• Supply exceeding absorption: Pipeline deliveries outpacing net absorption for 2+ consecutive quarters. Pressure on occupancy and rent growth is mathematically inevitable. Calculate the quarters of excess supply at current absorption rates.
• Rising sublease inventory: Sublease space growing as percentage of total availability signals future direct vacancy. Sublease is typically offered at 15-30% discount to direct, which also pressures overall effective rents. Track the absolute level and the rate of increase.
• Cap rate decompression: Cap rates expanding faster than interest rates are rising, indicating a repricing of risk beyond the rate movement. Could signal deteriorating property fundamentals, not just rate-driven repricing.
• Negative rent growth: Nominal rent declines signal a supply/demand imbalance that may take 2-4 quarters to correct. Distinguish between asking rent declines and net effective rent declines (concession-driven softness may precede asking rent cuts).
• Major employer contraction: A top-5 employer announcing layoffs, relocation, or closure. Quantify the direct employment impact and the multiplier effect on supporting industries and housing demand.
• Rising insurance and property tax costs: Insurance premium increases (especially in coastal/disaster-prone markets) and property tax reassessments can erode NOI growth even when rents are increasing. Calculate the NOI growth rate net of these cost increases.
• Regulatory headwinds: Rent control legislation, building performance standards (LL97 in NYC, BEPS in DC, BERDO 2.0 in Boston), or restrictive zoning changes that impact operating costs, development feasibility, or property values. Quantify the compliance cost and timeline.
• Liquidity deterioration: Transaction volume declining more than 30% year-over-year, bid-ask spreads widening, or deal-to-listing ratios falling below 20%. Indicates price discovery is breaking down and assets may be mispriced in either direction.

Chain Notes

This skill is one of the most-connected nodes in the CRE skills graph. It provides market context to nearly every deal-level and portfolio-level skill.

• Downstream: Feeds market rent benchmarks and growth assumptions to acquisition-underwriting-engine for proforma construction and replacement cost analysis.
• Downstream: Feeds market context (rents, cap rates, cycle position) to deal-underwriting-assistant for growth assumption validation and going-in metric benchmarking.
• Downstream: Feeds submarket fundamentals to submarket-truth-serum for deeper submarket-level analysis that strips broker narrative.
• Downstream: Feeds rent and transaction comps to comp-snapshot for deal-specific comparable analysis.
• Downstream: Feeds supply/demand data to supply-demand-forecast for forward-looking quantitative forecasting.
• Downstream: Feeds market cycle position to market-cycle-positioner for Mueller cycle classification.
• Downstream: Feeds market overview section to ic-memo-generator for investment committee presentations.
• Downstream: Feeds market data to lp-pitch-deck-builder for fundraising market context.
• Downstream: Feeds growth assumptions to annual-budget-engine for budget rent and expense escalators.
• Downstream: Feeds market context to property-performance-dashboard for performance benchmarking.
• Downstream: Feeds cycle positioning to disposition-strategy-engine for sell/hold/refi timing decisions.
• Downstream: Feeds market intelligence to sourcing-outreach-system for target market identification.
• Downstream: Feeds feasibility context to land-residual-hbu-analyzer for development feasibility inputs.
• Downstream: Feeds market rents to dev-proforma-engine for development proforma rent assumptions.
• Downstream: Feeds construction market data to construction-cost-estimator for regional cost context.
• Downstream: Feeds market data to capex-prioritizer for renovation ROI context.
• Downstream: Feeds market context to lease-negotiation-analyzer for rent negotiation positioning.
• Downstream: Feeds rent benchmarks to rent-optimization-planner for rent optimization strategy.
• Downstream: Feeds ESG market data to carbon-audit-compliance and climate-risk-assessment for environmental risk context.
• Downstream: Feeds market allocations to portfolio-allocator for geographic concentration analysis.
• Cross-ref: reit-profile-builder provides public REIT earnings commentary and transaction activity that supplements market-level data.
• Cross-ref: comp-snapshot provides property-level transaction data that feeds into the cap rate and transaction analysis sections.