TeX 53.2%
Python 46.6%
1# CLAUDE.md — UQO Working Paper 182(Spécification de l'auteur, 2026-10-20. Conventions de forme : ~/Desktop/Recherche-UQO/HARMONISATION.md ; ce dossier s'appelle3`immobilier/housing-leverage-intergenerational-inequality` et correspond au dépôt spbgit `wp18_uqo.git` — le nom `wp18_uqo/` du4plan ci-dessous désigne ce dossier.)56## Mission7Act as an autonomous team of housing economists, macro-finance theorists, mathematical economists, computational scientists, research librarians, and LaTeX editors. Develop a rigorous, reproducible **English-language theoretical research paper**:89**WP18 — Housing, Leverage, and Intergenerational Wealth Inequality: A Dynamic General Equilibrium Theory**1011Author: **Simon-Pierre Boucher**. Verify institutional affiliation and contact details against prior UQO papers. Do not invent coauthors or acknowledgments.1213Central question: Under what conditions do inherited wealth, mortgage leverage, nominal debt, housing supply and down-payment constraints generate persistent owner-renter wealth inequality among households with similar labor income? What changes under unexpected inflation?1415**Mandatory order:** inspect previous UQO WPs and review literature → specify mathematical model → derive propositions → implement and validate numerical model → run simulations and robustness checks → generate all figures and tables → audit results → **only then write and compile the LaTeX paper**. Literature review must be expanded before drafting. Never invent results, citations, proofs, or data.1617## Phase 0 — Reproduce UQO WP conventions181. Inspect current repository and accessible WP1–WP17 sources (all available locally in ~/Desktop/Recherche-UQO/{immobilier,finance}/*/paper/, notably WP2, WP5, WP10, WP16). Log unavailable files rather than claiming to have read them.192. Document observed series conventions in `research/wp_style_audit.md`: cover, number, typography, title/author block, abstract, keywords/JEL, section structure, theorem environments, figures, tables, citations, appendices, compilation. Follow them for WP18.203. Preserve `paper/main.tex` and `paper/main.pdf` naming conventions. Never overwrite earlier WPs.2122## Phase 1 — Deep verified literature review and novelty23Search scholarly literature and authoritative working papers on: OLG/lifecycle housing, tenure choice, housing wealth inequality, bequests, down-payment/LTV constraints, nominal mortgage debt, surprise inflation and redistribution, housing collateral, monetary transmission, land scarcity/supply elasticity, rental equilibrium, incomplete markets, household heterogeneity, welfare and policy. Investigate relevant foundational work by Kiyotaki–Moore, Iacoviello, Ortalo-Magné–Rady, Glaeser, Gyourko, Saiz, Kaplan–Mitman–Violante, Doepke–Schneider, and other relevant researchers; verify actual paper metadata and contributions rather than assuming relevance.2425Deliver `research/literature_matrix.csv` with a target of 50–80 **verified** references if genuinely relevant and accessible (never pad), including DOI/URL, model, method, findings, limitations, relevance and overlap with WP18. Produce a substantial critical synthesis in `research/literature_review.md` and verified `paper/references.bib`. Record inaccessible sources and uncertainty. Produce `research/novelty_matrix.csv` comparing each claimed contribution with the closest prior papers. Redesign weak contributions. Do not assert novelty before verifying it.2627Candidate contributions: (i) an endogenous ownership-entry wealth threshold jointly shaped by bequests, collateral and price feedback; (ii) conditions for persistent ownership/wealth gaps and path dependence; (iii) conditional inflation redistribution through fixed nominal mortgages in general equilibrium; (iv) supply elasticity and mortgage-contract effects on intergenerational mobility. Treat each as a hypothesis, not a preordained result.2829## Phase 2 — Complete theoretical model30Start with a tractable discrete-time overlapping-generations/lifecycle heterogeneous-household housing economy. Model owners and renters, consumption, housing services, liquid assets, income risk, bequests, mortgage debt, endogenous tenure choice, down-payment/LTV restrictions, transaction costs, maintenance, rents, housing supply and market clearing. Add features only when solvable and relevant.3132Write explicit household Bellman problems, full owner/renter budgets, initial/terminal conditions, inheritance process, timing of choices and shocks, mortgage amortization and refinancing, collateral constraints, competitive equilibrium definition, aggregate consistency, rental market and housing market clearing. State units and notation precisely.3334Distinguish nominal mortgage principal `B_nom` from real debt `B_nom / CPI`; distinguish CPI from house-price index. Separate expected from unexpected inflation and fixed-rate from variable-rate mortgages. Account for interest payments, inflation effects on wages/rents/interest rates, lender wealth, housing supply, and renter investment returns. Do not assume inflation necessarily raises real house prices or enriches every owner.3536Seek rigorous analytical results: leverage amplification with costs; surprise-inflation redistribution under stated assumptions; ownership threshold; conditions for persistence/multiple equilibria (only if established); comparative statics of LTV, bequests, supply elasticity and mortgage structure. For every proposition provide exact assumptions, statement, proof or clearly labeled proof gap. Save proofs in `paper/appendix_proofs.tex` and failed conjectures in `research/failed_hypotheses.md`. Do not call simulation findings theorems.3738## Phase 3 — Numerical implementation BEFORE writing39Use Python with NumPy/SciPy/pandas/matplotlib, optionally Numba/JAX. Write reproducible modules `src/model.py`, `household_solver.py`, `equilibrium.py`, `distributions.py`, `simulation.py`, `calibration.py`, `robustness.py`, `figures.py`, `tables.py`. Use configs/YAML, pinned dependencies, fixed seeds, tests, structured experiment logs, raw CSV/Parquet outputs, and a Makefile.4041First solve a two-/three-period benchmark with known behavior; unit-test budget identities, debt evolution, feasibility and terminal conditions. Then implement household dynamic programming (VFI/EGM or justified method), stationary distribution/OLG transitions, bequests, endogenous price iteration and housing/rental market clearing. Report Bellman residuals, equilibrium residuals, numerical tolerances, convergence, grid sensitivity and computational failures. If general equilibrium does not solve, **never label partial equilibrium as GE**.4243Calibrate from traceable Canada/Québec sources when justified, or use clearly marked illustrative parameters. Record units, observation dates, transformations and sources. No fabricated calibration targets or empirical validation.4445Run at least these experiments:461. Baseline wealth and ownership by age, income and inheritance quantile.472. Equal-income owner/renter wealth paths with differing initial endowments.483. Down-payment constraint and ownership-entry threshold sweeps.494. Surprise inflation with fixed versus adjustable nominal mortgages.505. Leverage/LTV sensitivity including negative house-price shocks.516. Bequests on/off and alternative inheritance transfers/tax scenarios.527. Housing supply elasticity, including near-fixed supply.538. Interest rates, rent growth, earnings risk and expectations sensitivity.549. Welfare changes using a defined consumption-equivalent measure.5510. Robustness to discounting, preferences, transaction costs, grid resolution, solver tolerance and simulation sample size.5657Produce **10–14 meaningful publication-quality figures** and **6–9 substantive tables**, adjusted to genuine findings rather than padded. Candidate figures: model timing, policy functions, ownership thresholds, wealth-age profiles, owner/renter divergence, inheritance quantile trajectories, inequality evolution, inflation impulse responses, mortgage comparison, supply-elasticity heatmap, welfare distribution and solver diagnostics. Candidate tables: notation, calibrated parameters/sources, baseline moments, convergence, scenario effects, inflation redistribution, inequality/mobility, welfare and robustness. Save vector PDFs + PNG previews in `results/figures/`, auto-generated LaTeX tables in `results/tables/`, and raw data in `results/data/`. Every paper number must map to a result file.5859## Phase 4 — Integrity audit, then write the manuscript60Before writing the paper, complete `research/results_audit.md`: experiment, hypotheses, parameters, algorithm, convergence, results, limitations, robustness, and claims actually supported. Distinguish mathematical identities, theoretical comparative statics, illustrative simulations and empirical findings. Investigate contrary outcomes. Never manipulate assumptions to force a preferred conclusion.6162**Gate:** do not start manuscript drafting until the baseline model is validated, claimed GE equilibria clear markets, principal simulations and exhibits reproduce, bibliography is verified, and theoretical claims have proofs or appropriate qualifications. If blocked, document the issue honestly and deliver a scoped partial result.6364Then write a polished **30–45-page English main text**, plus appendices as warranted, in `paper/main.tex`:651. UQO WP18 title page, author, verified affiliation.662. Abstract (150–220 words, actual results only), 5–7 keywords, verified JEL choices (consider R21, R31, D31, D91, E31, E44, G51).673. Introduction: question, precise contribution relative to closest work, preview of real results.684. Extensive critical literature review, organized by mechanisms and open gaps.695. Environment, timing, optimization, constraints and markets.706. Equilibrium and mathematical propositions.717. Numerical algorithm, calibration and verification.728. Baseline simulations, inheritance and inequality.739. Inflation/mortgage-contract counterfactuals.7410. Supply elasticity, policy and welfare.7511. Sensitivity, limitations and conclusion.7612. References and appendices: full proofs, numerical algorithms, additional tables/figures.7778Use `amsmath`, `amssymb`, `amsthm`, `booktabs`, `graphicx`, `hyperref` and a bibliography system compatible with observed UQO style. Maintain clean notation, labeled equations, real cross-references, readable figures and academic prose. Avoid inflated rhetoric or unsupported claims.7980## Required directory layout81```82<dossier>/83 CLAUDE.md84 README.md85 Makefile86 requirements.txt87 configs/{baseline.yaml,scenarios.yaml}88 src/{model,household_solver,equilibrium,distributions,simulation,calibration,robustness,figures,tables}.py89 tests/90 research/{progress.md,wp_style_audit.md,novelty_matrix.csv,literature_matrix.csv,literature_review.md,model_specification.md,failed_hypotheses.md,results_audit.md}91 results/{data,figures,tables,logs}/92 paper/{main.tex,main.pdf,references.bib,appendix_proofs.tex,appendix_computation.tex}93```9495## Final reproducibility and QA96Provide `make setup`, `make test`, `make simulate`, `make figures`, `make tables`, `make paper`, and `make all` targets, or equivalently documented commands. Rerun from a clean environment; verify no LaTeX compilation errors, undefined references, missing bibliography entries, broken paths, inconsistent numbers, unreported failures, or placeholder results. Check PDFs visually and inspect logs. Deliver final `paper/main.pdf`, source LaTeX, Python code, raw results, figures, tables, verified BibTeX, research audit, and a concise README explaining replication.9798Maintain `research/progress.md` after every phase with completed work, evidence, blockers and next steps. Work autonomously, but ask for essential permissions or missing credentials rather than pretending access. **Priority: scientific correctness, originality and reproducibility over speed, page count or positive findings.**99