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.
• Treat output/cv.json, output/sections/cv.tex, and output/publications.bib as generated files.
• Do not hand-edit generated files unless explicitly requested for a temporary emergency workaround.

Build Workflow

• Preferred command in non-interactive shells:
  • conda run -n MyEnv python build.py
• Reason:
  • conda activate MyEnv often fails in non-interactive executions.
• If working in an interactive zsh session:
  • eval "$(conda shell.zsh hook)"
  • conda activate MyEnv
  • python build.py

Environment Notes

• MyEnv is the standard environment for this project.
• build.py requires PyYAML.
• Quick checks:
  • conda env list
  • conda run -n MyEnv python -c "import yaml; print(yaml.__version__)"

Expected Outputs After Build

• output/cv.json
• output/sections/cv.tex
• output/complete_cv.tex
• optionally output/publications.bib (if bibtex exists in source data)

Local Preview

• Publications.html fetches output/cv.json.
• Do not rely on file:// preview; use a local server (e.g., VS Code Live Server).