Skip to content

AGENTS.md

Latest commit

 

History

History
44 lines (35 loc) · 2.6 KB

AGENTS.md

File metadata and controls

44 lines (35 loc) · 2.6 KB
Raw

Codex Routing Rules For This Repo

1) Skill-First Operation

Use REPO skills in .codex/skills instead of project command files.

Project skills for previous command workflows:

  • python-setup: initial setup, including Python and both local video assets by default
  • video-assets-setup: install/update or validate local video references and icons
  • book-serve: local Jupyter Book server
  • git-commit: change analysis and commit workflow
  • git-pr: pull request workflow

2) Claude Skill Bridge

When request intent matches below topics, use .claude/skills/* as the operational source:

  • manim-video-pipeline: scene design/script/render/audio mux/full concat
  • pip-install: install package in .venv and sync requirements.txt
  • skill-creator: create/update project skill package
  • deep-research: 심층 조사, deep research, 종합 분석, in-depth report → outputs/ 에 저장
  • literature-review: 문헌 조사, lit review, 논문 survey, state of the art
  • peer-review: 동료 검토 시뮬레이션, 논문/노트북/분석 결과 리뷰
  • source-comparison: 여러 소스·방법론·도구 비교 매트릭스

How to execute:

  1. Read the target SKILL.md.
  2. Resolve relative paths from the skill directory first.
  3. Prefer bundled scripts in scripts/ over re-implementing logic.
  4. Load only required files in references/.

Priority:

  • In this repository, REPO scope skills (.codex/skills/*) take precedence over USER/ADMIN/SYSTEM skills when names overlap.

Project Working Rules

  • Treat .codex/skills/* and .claude/skills/* as the default operating procedures for recurring tasks.
  • For initial environment setup (including "Python 환경 세팅"), run bash scripts/setup_environment.sh. Only use --book-only when the user explicitly requests a Book-only environment. Require dependency/import checks and both asset checks before reporting full setup complete; report partial completion when a step fails. Keep setup execution in the shared scripts/setup_*.sh files and have all skill copies delegate to them.
  • Keep dependency scopes separated:
    • requirements.txt for full local book + video work
    • requirements-book.txt for book, Binder, and deploy runtime
    • binder/apt.txt for Binder system packages
  • When editing notebooks under book/, use Binder-safe paths and do not assume the current working directory is the notebook folder.
  • Do not commit local machine artifacts such as .env, local settings, generated caches, or render outputs unless the user explicitly asks for that.
  • Prefer small, task-coherent commits that include related config/dependency updates together.