Add AGENTS.md and fix LaTeX math rendering in paper#36
Merged
Conversation
Add AGENTS.md and .agents/ directory with project context for AI coding agents, covering architecture, estimation pipeline, economics domain knowledge, paper/docs system, and build/CI details. Fix LaTeX subscript rendering in content/paper/01-paper.md: throughout the math blocks, `*` had been used where `_` (subscript operator) should be, and `\_` (escaped underscore) where plain `_` is needed. This caused MyST to render literal asterisks instead of subscripts (e.g. `*c * t` instead of c_t). Fixed all 12 affected equation blocks. Made-with: Cursor
mnwhite
approved these changes
Mar 10, 2026
llorracc
added a commit
that referenced
this pull request
Mar 10, 2026
…ate validate-pyproject Three pre-existing CI failures addressed: 1. Exclude content/paper/*.md from prettier — prettier interprets LaTeX subscript operators (_) as Markdown emphasis and corrupts them to * or \_. This was the root cause of the math rendering bugs fixed in PR #36. 2. Apply ruff-format fixes to src/do_all.py and src/estimark/estimation.py (trailing whitespace on blank lines, spacing around ** operator). 3. Update validate-pyproject from v0.19 to v0.25 to fix the KeyError: 'https://json.schemastore.org/tox.json' crash in the schema-store plugin. Made-with: Cursor
3 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
AGENTS.mdand.agents/directory with project context for AI coding agents, covering code architecture, estimation pipeline, economics domain knowledge, paper/docs system, and build/CI details.content/paper/01-paper.md: throughout the math blocks,*had been used where_(subscript operator) should be, and\_(escaped underscore) where plain_was needed. This causedmyst startto render literal asterisks instead of proper subscripts (e.g.*c * tinstead ofDetails
AGENTS.md / .agents/
New files providing structured context for AI agents working on this codebase:
AGENTS.md.agents/architecture.md.agents/estimation-pipeline.md.agents/economics-context.md.agents/paper-and-docs.md.agents/build-and-ci.mdMath rendering fixes
Three types of errors were fixed across 12 equation blocks in
01-paper.md:*{→_{— e.g.\vFunc*{t}→\vFunc_{t},\max*{\cNrm*{t}}→\max_{\cNrm_{t}}\_→_— e.g.\max\_{\cNrm}→\max_{\cNrm},\aFunc\_{t}→\aFunc_{t}^_→^*— In the FOC equation, optimal-value superscripts were mangled (\cNrm^_→\cNrm^*)Test plan
myst startand verify all equations in the paper render with correct subscriptsAGENTS.mdand.agents/files are accessible and accurateMade with Cursor