Cinewright

플러그인 설치

Codex와 Claude Code는 같은 skills/cinewright 진입점과 실행 도구를 사용한다. Node.js 22 이상, FFmpeg/FFprobe와 Chromium이 필요하다. 플러그인을 설치한 뒤 설치된 플러그인 루트에서 npm ci를 실행해 의존성을 준비한다. 플러그인 캐시가 갱신되면 새 설치 위치에서도 의존성을 준비해야 한다.

• Codex: 이 저장소의 .agents/plugins/marketplace.json은 현재 저장소용 로컬 마켓플레이스를 제공한다. Codex 데스크톱 앱을 다시 시작하고 플러그인 목록에서 Cinewright를 설치한다. 새 채팅에서 $cinewright를 사용한다.
• Claude Code: /plugin marketplace add oozoofrog/cinewright로 마켓플레이스를 추가하고 /plugin install cinewright@cinewright-marketplace로 설치한다. 새 세션에서 /cinewright:cinewright를 사용한다.

설치된 플러그인 루트의 scripts/direction.mjs를 절대 경로로 실행한다. 사용자 작업 경로에서 실행하면 기본 .direction/ 기록이 그 작업 경로에 생성된다.

독립 개발 경로는 /Volumes/eyedisk/develop/cinewright다. 이 디렉터리가 Git 저장소 루트다.

SKILL.md에서 제작을 시작한다. 작품의 시간, 자산, 개별 표현과 선택적 교환 값을 작성하면 같은 개정본으로 대화형 재생, 프레임 추출, 구간·전체 렌더와 MP4 비교를 할 수 있다.

미완성 의뢰는 제작 전 협의에서 목적·필수 행동·대안·위임으로 구체화한다. 여섯 분야의 작법은 출처 내용과 애니메이션 적용을 구분한다. 스틸컷 지침은 원화 선택·시간·배치와 두 재사용 helper의 계약을 다룬다.

하루를 내려놓는 자리는 같은 가상 의뢰를 넓은 구도의 긴 hold와 세부에서 방으로 확장하는 컷으로 구성한 8초·7초 예제다. 두 프로젝트는 같은 자체 SVG 3개와 복사한 helper를 쓴다. node examples/stillcuts/build.mjs로 다시 생성한다. 수정본 영상·기술 검증·제한된 성능 기록과 구간별 독립 검토 종합에서 확인 범위와 남은 감상 판단을 구분한다.

전역 설치

전역 스킬은 /Users/oozoofrog/.codex/skills/cinewright에 설치했다. 개발 저장소와 분리된 복사본이며, 실행 코드·참조 문서·예제·테스트와 잠금 파일 기준 의존성을 포함한다. 개발 소스의 변경은 설치본에 자동으로 반영되지 않는다.

프로젝트 작업 경로에서 전역 도구를 실행하면 .direction/ 기록도 해당 작업 경로에 저장한다. 다른 기록 경로가 필요하면 --store를 지정한다.

node /Users/oozoofrog/.codex/skills/cinewright/scripts/direction.mjs doctor
node /Users/oozoofrog/.codex/skills/cinewright/scripts/direction.mjs init ./my-film
node /Users/oozoofrog/.codex/skills/cinewright/scripts/direction.mjs preview ./my-film

설치 및 실행 검증

실행

이 디렉터리에서 실행한다. Node.js 22 이상, FFmpeg/FFprobe, Chromium이 필요하다. 기존 의존성이 준비되어 있으면 재설치하지 않는다. 준비되지 않은 체크아웃에서만 npm ci를 먼저 실행한다.

npm test
node scripts/direction.mjs doctor
node scripts/direction.mjs play examples/harbor-landfall
node scripts/direction.mjs frame examples/harbor-landfall return
node scripts/direction.mjs render examples/harbor-landfall --span '연결 검토'
node scripts/direction.mjs render examples/harbor-landfall

play가 출력한 로컬 주소에서 재생·일시 정지·탐색과 이름 붙인 구간 반복을 쓸 수 있다. 전체 또는 구간 렌더가 출력한 작업 ID로 review JOB_ID OTHER_JOB_ID를 실행하면 개별 재생과 같은 시각 비교를 할 수 있다.

항로에 다른 방향을 시험하려면 examples/harbor-landfall/work.json의 channels.steering.data.keys를 수정한다. 같은 명령으로 새 개정본을 만들고 방위계와 귀환 뒤 항로를 함께 확인한다. freeze에서 받은 해시를 프로젝트 경로 대신 넘기면 이전 개정본으로 재실행할 수 있다.

도구와 복구 · 입력과 모듈 · 제작 및 기술 검토 · 별도 창작 의뢰 재현

《밤의 통로》의 창작 입력은 스타일과 스토리 두 항목이다. 세부 연출과 구현은 제작 과정에서 도출했다. 검토와 재실행 · 스킬 수정 근거

저장소 구성

scripts/와 runtime/은 실행 도구, modules/는 프로젝트에 복사하는 컷·원화 helper, examples/는 제작 입력, tests/는 회귀 검사다. SKILL.md와 references/에 제작 지침을 둔다. outputs/와 evidence/에는 현재 검증 작품과 제작 근거를 함께 보관한다.

node_modules/와 .direction/은 로컬 실행 데이터다. 새 체크아웃에서는 npm ci를 실행하고 예제 경로로 렌더한다. 기존 개정본 해시와 작업 ID를 사용하는 명령은 해당 .direction/ 기록이 있는 환경에서 실행한다.

이전 제작 기록의 절대 경로는 당시 실행 환경을 가리킨다. 독립 경로 구성과 실행 검증은 설정 기록에 있다.