after-effects-codex-agent

# After Effects Codex Agent After Effects를 실제로 읽고 수정하는 After Effects MCP와 Codex의 판단·검수 규칙을 결합하기 위한 독립 문서 저장소다. 실행 서버 자체의 소스가 아니라 작업 지침과 품질 참조를 제공하며, `src/`, `jsx/`, `tests/`, `package.json`을 복제하지 않는다. ## 구조 | 경로 | 역할 | |---|---| | `AGENTS.md` | Codex 진입점과 reference 선택 규칙 | | `SKILL.md` | 조사→계획→수정→시각 검수→저장 workflow | | `references/` | 합성, 매트, 색상, 애니메이션, 렌더, 문제 해결 기준 | | `templates/task-brief.md` | 실제 작업 지시 템플릿 | ## 사용 순서 Codex 프로젝트 지침 위치에 이 폴더를 배치한 뒤 `AGENTS.md`와 `SKILL.md`를 읽는다. 작업마다 `templates/task-brief.md`를 복사해 대상 컴포지션과 변경 범위를 채운다. AE에 연결된 MCP runtime이 제공하는 operation은 `ae_catalog`로 확인하며, 이 저장소는 특정 버전의 operation 목록을 고정하지 않는다. After Effects MCP 연결, Node.js, AE 버전, 네트워크·스크립트 권한은 실제 설치 환경의 공식 문서를 기준으로 확인한다. 이 저장소의 문서는 실행 서버를 대신하지 않는다. ## 안전 원칙 원본 `.aep`를 덮어쓰지 않고 새 버전 또는 새 프로젝트로 저장한다. 모든 mutation 전후에 AE 상태를 조회하고, 첫 프레임·중간 프레임·마지막 프레임을 렌더링해 확인한다. 요청하지 않은 소스 교체, 색감 변경, 타이밍 변경, 레이어 순서 변경은 하지 않는다. ## 파일별 역할 GitHub 파일 목록에서 각 항목을 빠르게 이해할 수 있도록 역할을 정리하면 다음과 같다. | 경로 | 설명 | |---|---| | `AGENTS.md` | Codex가 가장 먼저 읽는 진입점. 작업 유형별 reference 선택과 공통 안전 규칙을 정의한다. | | `SKILL.md` | AE 프로젝트 조사부터 계획, 실행, 프레임 검수, repair, 저장까지의 전체 작업 루프를 정의한다. | | `references/operations-and-safety.md` | After Effects MCP operation 탐색, stable layer ID, mutation 보호, 오류 중단 기준을 설명한다. | | `references/compositing.md` | 소스 정렬, 마스크, Perspective, Depth, Light Wrap, Shadow, Grain, Glow 합성 기준을 설명한다. | | `references/matte-roto.md` | Alpha/Luma/Mask/Track Matte, Straight/Premultiplied, 로토와 edge 품질 기준을 설명한다. | | `references/color.md` | 색상 공간, 노출, 화이트밸런스, Curves, DI 룩, 피부톤, Glow 순서를 설명한다. | | `references/animation.md` | fps, 시간코드, 키프레임, Linear/Ease/Hold, Graph Editor, Motion Blur 기준을 설명한다. | | `references/qc-render.md` | 실제 프레임 렌더링, 전환 구간, 매트, 컬러, 출력 결과의 검수 gate를 정의한다. | | `references/troubleshooting.md` | MCP timeout, offline footage, 검은 화면, halo, timing, render mismatch의 진단 순서를 제공한다. | | `templates/task-brief.md` | 매 작업에서 환경, 대상, 타이밍, 변경 허용·금지, 납품 조건을 빠짐없이 작성하는 양식이다. | | `manifest.json` | 저장소의 진입점, skill, reference 목록과 기본 저장 정책을 기계적으로 기록한다. | ## 커밋 메시지 해석 GitHub 파일 목록의 오른쪽에 표시되는 문장은 해당 파일의 **마지막 커밋 메시지**다. 파일 자체의 설명은 위 표와 각 문서의 본문에서 확인할 수 있다. 이후 수정할 때는 `Add ...`처럼 포괄적인 문장보다 `Define matte and roto edge quality rules` 또는 `Add render verification gates`처럼 변경 목적이 드러나는 커밋 메시지를 사용한다. ## 문서 범위 이 저장소는 After Effects 편집을 위한 운영 규칙, 합성·매트·색상·애니메이션·렌더·문제 해결 참조를 제공한다. 실행 환경의 설치·연결·권한은 사용 중인 After Effects MCP runtime과 각 소프트웨어의 공식 문서를 기준으로 확인한다.