workspace-course-topics

Assignment: Create Subsequent-Literature Notebook

Due: Before next class

Prerequisites:

Throughout this document, {BALLPARK} stands for your paper’s folder name (e.g. OptimumDebt, HKMOHousingChannelMP). Always replace it with your actual folder name.


Objective

Create a subsequent-literature notebook that summarizes the papers that cite your ballpark paper, with MyST citations resolving against subsequent-literature.bib.

This step benefits from a premium AI model (Claude Opus 4.6 or ChatGPT 5.3), since it requires real knowledge of economics literature.


Where to work

Work in your fork, on the same branch:

cd ~/github/<your-username>/ballpark/models/We-Would-Like-In-Econ-ARK/{BALLPARK}/

Steps

1. Ensure subsequent-literature.bib is present

You should already have a .bib file from your earlier LitMaps assignment. Make sure it is in your paper folder and named subsequent-literature.bib:

ls *.bib

If it has a different name (e.g. litmaps-export.bib, citing-papers.bib), rename it:

mv <your-file>.bib subsequent-literature.bib

Don’t have a subsequent-literature .bib file at all? The AI can create one for you in the next steps — but the result will be significantly better with a premium model (Opus 4.6 or ChatGPT 5.3).


2. Create the notebook

Create {BALLPARK}_subsequent-literature.ipynb (e.g. if the summary notebook is OptimumDebt_summary.ipynb, create OptimumDebt_subsequent-literature.ipynb).


3. Transfer your subsequent-literature analysis

If you have a subsequent-literature-analysis.md working document from earlier work, copy its content into markdown cells. If you don’t have one, the AI can generate the content — use a premium model for better results.

Organize into sections:


4. Insert MyST citations

Where you mention subsequent papers, add MyST citations using the same syntax:

Citation keys must match entries in subsequent-literature.bib or self.bib. (self.bib contains the subject paper’s own entry — use it when referring to the paper this ballpark summarizes.) See MyST Citations.


5. Optional: Add LitMap visualization

If you have a LitMap screenshot or export, add it as an image in the notebook to show the citation network visually.


6. Commit

git add subsequent-literature.bib {BALLPARK}_subsequent-literature.ipynb
git commit -m "Add subsequent-literature notebook with citations"

Deliverable

{BALLPARK}_subsequent-literature.ipynb with MyST citations resolving against subsequent-literature.bib.

What to check:

If citations don’t resolve: Check that the citation key matches an entry in subsequent-literature.bib or self.bib, and that both .bib files are listed in myst.yml (configured in the MyST assembly assignment).


If You Get Stuck

Ask Cursor AI. If the “auto” model is inadequate, try Claude Opus 4.6 or ChatGPT 5.3.


Next Step

MyST Assembly and PR