strucmod

Structural Modeling for Economists

An AI-agent pipeline that turns one-line research questions into publication-grade economics papers.

DSGE, CGE, heterogeneous-agent, dynamic-programming — model spec → calibration → solve → simulate → write a real academic paper (introduction, model, calibration, solution, results, robustness, conclusion, references) → compile to PDF.

Output of UIBE 2025 Graduate Education Reform Project · AI Multi-Tool Coordinated Empowerment of Graduate Structural Modeling and Dynamic Simulation Research and Practice · 贾宁远.

---

What's inside

• 30+ skills — setup-dsge, setup-cge-gtap, setup-ha-bewley, calibrate-from-moments, solve-perturbation, solve-vfi, simulate-irf, counterfactual-run, plus 8 paper-composition skills (paper-structure, write-introduction, write-model-section, write-calibration-section, write-solution-section, write-results-section, write-conclusion, manage-bibliography, render-paper).
• 7 review subagents — model-reviewer, math-reviewer, numerics-reviewer, code-reviewer, pedagogy-reviewer, paper-reviewer, verifier.
• 6 cross-cutting rules — orchestrator-protocol, plan-first-modeling, numerical-validation-protocol, replication-protocol, modeling-coding-conventions, academic-writing-style (zero implementation leak, formal voice, citation discipline).
• Paper templates — main.tex + 7 section skeletons + appendix + a starter references.bib pre-filled with canonical citations.
• Adapter shims — one for every supported agent (see install section below).

What it produces: a self-contained research project (paper/, code/, data/, results/, slides/, references/) and a publication-grade paper/paper.pdf — 8–15 pages with full academic structure, zero implementation leakage.

---

Install — choose your agent

Option 1 · Claude Code (recommended)

1A. Global install via marketplace — one-time setup, then works in any project

Inside Claude Code:

/plugin marketplace add https://github.com/ALLBLUEUK/structural-modeling-for-economists
/plugin install strucmod

That's it. Every Claude Code session in any directory knows the pipeline. No per-project setup.

1B. Project-level install — plugin scoped to one project's .claude/

cd ~/my-research-project
git clone https://github.com/ALLBLUEUK/structural-modeling-for-economists.git \
          .claude/plugins/strucmod

Restart Claude Code in the project; the plugin auto-loads.

1C. User-level install (manual) — equivalent to 1A without going through the marketplace

git clone https://github.com/ALLBLUEUK/structural-modeling-for-economists.git \
          ~/.claude/plugins/strucmod

---

Option 2 · Codex CLI

Codex natively reads AGENTS.md (agents.md spec). The plugin ships an AGENTS.md template that tells Codex where to find skills and rules.

# 1) Install plugin once (global recommended):
git clone https://github.com/ALLBLUEUK/structural-modeling-for-economists.git \
          ~/.claude/plugins/strucmod

# 2) In each research project, drop AGENTS.md into the project root:
cd ~/my-research-project
cp ~/.claude/plugins/strucmod/templates/adapters/AGENTS.md ./AGENTS.md

# 3) Start Codex:
codex

Codex automatically reads AGENTS.md and follows the pipeline's procedures.

---

Option 3 · Cursor

Cursor uses .cursor/rules/*.mdc for project rules.

cd ~/my-research-project

git clone https://github.com/ALLBLUEUK/structural-modeling-for-economists.git \
          ~/.claude/plugins/strucmod

mkdir -p .cursor/rules
cp ~/.claude/plugins/strucmod/templates/adapters/cursor/rules/strucmod.mdc \
   .cursor/rules/strucmod.mdc
cp ~/.claude/plugins/strucmod/templates/adapters/AGENTS.md ./AGENTS.md

Open the project in Cursor; the rule auto-loads.

---

Option 4 · Aider

cd ~/my-research-project

git clone https://github.com/ALLBLUEUK/structural-modeling-for-economists.git \
          .claude/plugins/strucmod

cp .claude/plugins/strucmod/templates/adapters/.aider.conf.yml ./.aider.conf.yml
cp .claude/plugins/strucmod/templates/adapters/AGENTS.md ./AGENTS.md

aider

---

Option 5 · Windsurf

cd ~/my-research-project

git clone https://github.com/ALLBLUEUK/structural-modeling-for-economists.git \
          ~/.claude/plugins/strucmod

cp ~/.claude/plugins/strucmod/templates/adapters/.windsurfrules ./.windsurfrules
cp ~/.claude/plugins/strucmod/templates/adapters/AGENTS.md ./AGENTS.md