workspace-course-topics

Workflows index

Atomic, reusable in-class workflow steps. Each workflow is a standalone document that can be referenced by orchestrators.

---

⚠️ Before you start any workflow

1. Check your working directory — Most workflows require you to be in ~/GitHub/econ-ark/ballpark
2. Complete verification steps — Each workflow has a “Verify first” section at the top
3. Windows users: Ensure you’re in WSL/Ubuntu, not Windows

Quick check:

cd ~/GitHub/econ-ark/ballpark && pwd

---

Reference documents

These are not workflows, but reference material for common issues:

• Verify terminal context — Ensures correct filesystem and directory
• Pre-class verification checklist — Complete before each class
• Paths with spaces — How to handle paths containing spaces or special characters
• WSL Google Drive access — Windows: accessing Google Drive files from WSL

---

Git

• Git fetch/pull on ballpark — Working dir: ballpark/
• Git add, commit, and PR — Working dir: ballpark/

PaperPile & LitMaps

• PaperPile setup and sharing — Browser-based
• Google Drive sync for PaperPile — Browser + filesystem ⚠️ Includes BibTeX Export
• LitMaps import and visualize — Browser-based

Cursor & environment

• Launch Cursor in ballpark — Working dir: ballpark/ ⚠️ Critical
• Install the environment (via Cursor) — Working dir: ballpark/

Jupyter notebooks

• Open Jupyter notebook in Cursor — Cursor root: ballpark/ ⚠️ Critical
• Add yourself as coauthor

MyST

• Ask Cursor about a MyST extension
• Install MyST-Markdown extension
• Install MyST (CLI)
• Verify MyST tools
• Convert notebook to MyST — replaced by the four-notebook MyST assembly

Bibliography

• Set up bibliography files for MyST — Working dir: ballpark/
• Add a citation to the paper
• Add LitMap image and subsequent-literature bib

AI-assisted

• Add “Subsequent Literature” section (AI-assisted)