Skip to content

AGENTS.md

Latest commit

 

History

History
37 lines (27 loc) · 1.85 KB

AGENTS.md

File metadata and controls

37 lines (27 loc) · 1.85 KB
Raw

AGENTS.md

This repository is a collection of NYCU computer graphics assignments and a MuJoCo final project. Follow these rules when changing files under this directory.

Repository Layout

  • Render a 3D Mesh/: Visual Studio mesh rendering assignment.
  • Texture a mesh/: OpenGL/CMake textured mesh assignment.
  • Textured Campus Scene Animation/: OpenGL/CMake campus animation assignment.
  • Final Project/: standalone copy of the final project editor and assets.
  • MujoCo/Final Project/: preferred active workspace for final project improvements.
  • MujoCo/sample/, MujoCo/simulate/, MujoCo/model/, MujoCo/mujoco.framework/, MujoCo/MuJoCo.app/: MuJoCo vendor/reference files. Avoid changing these unless the task explicitly targets MuJoCo itself.
  • docs/: repository-level project notes and maps.

Editing Guidance

  • Prefer editing MujoCo/Final Project/ for final project work.
  • Do not move or rename asset directories unless all MJCF/XML references are updated and verified.
  • Quote paths in shell commands because several project directories contain spaces.
  • Keep generated files out of source changes: build directories, logs, _combined.xml, demo output XML, caches, archives, and .DS_Store.
  • For C++ OpenGL projects, keep changes scoped to src/, shaders/, assets/, CMakeLists.txt, or README files unless build-system changes are required.
  • For MuJoCo editor work, validate with mjpython when available; otherwise at least run Python syntax checks with a writable PYTHONPYCACHEPREFIX.

Common Commands

From the repository root:

cd "MujoCo/Final Project"
mjpython src/editor.py --base assets/venice/venice_exploded.xml --list-bodies

Python syntax check that avoids writing caches outside the workspace:

PYTHONPYCACHEPREFIX=/private/tmp/codex_pycache python3 -m py_compile "MujoCo/Final Project/src/editor.py"