KokiSatsukawa

AGENTS.md

Scope

Project-specific instructions for agents working in this repository.

Source Of Truth

• Publications/CV data must be edited in data/cv_source.yaml.
• Shared site chrome, home page, and contact page data must be edited in data/site_source.yaml.
• Treat output/cv.json, output/sections/cv.tex, and output/publications.bib as generated files.
• Treat index.html, CV.html, Publications.html, and Contact.html as generated by build.py unless an emergency temporary workaround is explicitly requested.
• Do not hand-edit generated files unless explicitly requested for a temporary emergency workaround.

Build Workflow

• Preferred command:
  • uv run --with PyYAML python build.py
• Reason:
  • uv is the current project workflow and provides PyYAML without relying on the old Conda environment.

Environment Notes

• build.py requires PyYAML.
• Quick checks:
  • uv run --with PyYAML python -c "import yaml; print(yaml.__version__)"

Expected Outputs After Build

• output/cv.json
• output/sections/cv.tex
• output/complete_cv.tex
• static HTML pages at repository root
• optionally output/publications.bib (if bibtex exists in source data)

Local Preview

• The publication list is embedded directly in the generated HTML, so pages render without JavaScript and without fetching output/cv.json.
• Do not rely on file:// preview; use a local server (e.g., VS Code Live Server).