# Econ-ARK Ballpark

> A curated catalog of economics papers we would welcome into the Econ-ARK
> ecosystem as replications ([REMARK](https://github.com/econ-ark/REMARK))
> or demonstrations ([DemARK](https://github.com/econ-ark/DemARK)). Each
> entry provides a paper's recursive-problem formulation in explicit form,
> and where available a modular dynamic-programming (dolo-plus) draft
> suitable for AI-assisted formalization.

Target audience: graduate students, course instructors, structural-macro
researchers, and agent systems doing scholarly retrieval. Ballpark entries
are designed to be the natural starting point for turning a published paper
into a reproducible, citable Econ-ARK contribution.

## Workflow documents

- [CONTRIBUTING.md](CONTRIBUTING.md): Canonical structure for a ballpark entry — exposition, formalization, and asset layers, plus machine-readable metadata.
- [README.md](README.md): Project framing and the promotion path from ballpark → REMARK / DemARK → HARK tool.
- [models.md](models.md): Pointer into the catalog.

## Items

Each item lives at `models/We-Would-Like-In-Econ-ARK/<citekey>/index.md`. Tiers (see [CONTRIBUTING.md](CONTRIBUTING.md#ballpark-tiers)):
- **Draft** — paper claimed, minimal cataloging.
- **Primer** — four-notebook exposition layer + explicit recursive model statement.
- **Formalized** — bellman excerpt, dolo-plus YAML draft, verification, `AGENTS.md`. (Ready for a coder to promote to REMARK/DemARK.)

Most items are currently Draft (legacy slideware format pre-dates the tier system). Refactoring a Draft item to Primer is an explicitly welcome PR and is scoped for ≤2 weekly PhD-course assignments with AI assistance.

- [Benhabib_et_al_2019](models/We-Would-Like-In-Econ-ARK/Benhabib_et_al_2019/): Lifecycle wealth distribution with heterogeneous returns and warm-glow bequests. Topic: wealth-distribution, lifecycle. Tier: Primer.
- [AHLifeCycleExpenditure](models/We-Would-Like-In-Econ-ARK/AHLifeCycleExpenditure/): Lifecycle expenditure profiles. Topic: lifecycle. Tier: Draft.
- [ARMonetaryPolicyHABC](models/We-Would-Like-In-Econ-ARK/ARMonetaryPolicyHABC/): Algan–Ragot heterogeneous-agent monetary policy with money in utility. Topic: HA-macro, monetary. Tier: Draft.
- [clMonetary](models/We-Would-Like-In-Econ-ARK/clMonetary/): Monetary-policy model. Topic: monetary. Tier: Draft.
- [Fujiwara_Teranishi](models/We-Would-Like-In-Econ-ARK/Fujiwara_Teranishi/): Monetary policy with heterogeneous agents. Topic: HA-macro, monetary. Tier: Draft.
- [GKKOCWealthTax](models/We-Would-Like-In-Econ-ARK/GKKOCWealthTax/): Optimal wealth taxation with heterogeneous agents. Topic: optimal-taxation, wealth-distribution. Tier: Draft.
- [GKNMonetaryPolicyHA](models/We-Would-Like-In-Econ-ARK/GKNMonetaryPolicyHA/): Gornemann–Kuester–Nakajima monetary policy with heterogeneous agents. Topic: HA-macro, monetary. Tier: Draft.
- [Guerrieri_Lorenzoni2017](models/We-Would-Like-In-Econ-ARK/Guerrieri_Lorenzoni2017/): Credit crises, precautionary savings, and the liquidity trap. Topic: HA-macro, liquidity-trap. Tier: Draft.
- [HKMOHousingChannelMP](models/We-Would-Like-In-Econ-ARK/HKMOHousingChannelMP/): Housing channel of monetary policy with heterogeneous agents. Topic: HA-macro, housing, monetary. Tier: Draft.
- [HKSWealthDistribution](models/We-Would-Like-In-Econ-ARK/HKSWealthDistribution/): Hubmer–Krusell–Smith quantitative theory of the U.S. wealth distribution. Topic: wealth-distribution, HA-macro. Tier: Draft.
- [KMVBoomBust](models/We-Would-Like-In-Econ-ARK/KMVBoomBust/): Boom-bust dynamics. Topic: HA-macro, business-cycles. Tier: Draft.
- [Kumhof_et_al_2015](models/We-Would-Like-In-Econ-ARK/Kumhof_et_al_2015/): Inequality, leverage, and crises. Topic: inequality, financial-crisis. Tier: Draft.
- [MK3TagTax](models/We-Would-Like-In-Econ-ARK/MK3TagTax/): Optimal tagged taxation. Topic: optimal-taxation. Tier: Draft.
- [OpenHA](models/We-Would-Like-In-Econ-ARK/OpenHA/): Open-economy heterogeneous-agent model. Topic: HA-macro, open-economy. Tier: Draft.
- [OptimalTaxHeight](models/We-Would-Like-In-Econ-ARK/OptimalTaxHeight/): Optimal taxation with height as a tag. Topic: optimal-taxation. Tier: Draft.
- [OptimumDebt](models/We-Would-Like-In-Econ-ARK/OptimumDebt/): Aiyagari–McGrattan optimum quantity of public debt. Topic: HA-macro, fiscal-policy. Tier: Draft.
- [PopAgingMPtransmission](models/We-Would-Like-In-Econ-ARK/PopAgingMPtransmission/): Population aging and monetary-policy transmission. Topic: demographics, monetary. Tier: Draft.
- [Ravn_Sterk_2021](models/We-Would-Like-In-Econ-ARK/Ravn_Sterk_2021/): Macroeconomic fluctuations with heterogeneous agents. Topic: HA-macro. Tier: Draft.
- [Reiter_2009](models/We-Would-Like-In-Econ-ARK/Reiter_2009/): Solving heterogeneous-agent models by projection and perturbation. Topic: computational-methods. Tier: Draft.
- [SSJ_2021](models/We-Would-Like-In-Econ-ARK/SSJ_2021/): Sequence-space Jacobian methods for heterogeneous-agent models. Topic: HA-macro, computational-methods. Tier: Draft.
- [TaxingWomen](models/We-Would-Like-In-Econ-ARK/TaxingWomen/): Guner–Kaygusuz–Ventura taxation and female labor supply. Topic: lifecycle, optimal-taxation, labor. Tier: Draft.

## Already in Econ-ARK

- [tools/Already-Partway-In-Econ-ARK](tools/Already-Partway-In-Econ-ARK/): Papers whose methods are partly implemented in HARK.

## Optional

- [models/We-Would-Like-In-Econ-ARK.ipynb](models/We-Would-Like-In-Econ-ARK.ipynb): Legacy notebook surveying housing-and-heterogeneity papers.