NodeKit Present
검증된 개발 산출물을 살아있는 프레젠테이션으로 변환합니다. 데크는 변경 기록의 투영으로 취급하며, 독립적인 주장의 출처로 절대 사용하지 마세요.
프레젠테이션 산출물을 생성하거나 업데이트하기 전에 변경-스토리-계약을 읽으세요.
워크플로우
- 변경 계층 분류하기. 사소한 작업에는 데크를 건너뛰고, 좁은 범위의 수정에는 변경 카드를, 주요 기능에는 3-5슬라이드 미니 데크를, 릴리스 또는 해커톤에는 전체 데크와 부록을 사용합니다.
changes/<change-id>/change.yaml생성 또는 업데이트. 대상 청중, 문제, 이전 상태, 결정, 대안, 영향받는 시스템, 사용자 워크플로우, 증명 요구사항, 제한 사항, 프레젠테이션 계층을 기록합니다.- 작업 중 증거 캡처하기: 기준 및 이후 스크린샷, 정확한 커밋, 배포 ID, 테스트, 벤치마크, 트레이스, 산출물, 내보내기, 알려진 실패 등을 기록합니다. 원시 영수증(원본 증거)을 보존합니다.
- 증거 인덱스 구축하기. 모든 실질적인 주장에 상태와 증거 ID를 할당합니다. 계획된 주장, 추론된 주장, 사용자 주장, 측정된 주장을 명확히 구분하여 레이블을 지정합니다.
- 렌더링 전 각 슬라이드 계획하기. 슬라이드의 역할, 대상 청중의 질문, 핵심 요점, 내러티브 역할, 주요 시각 자료, 증거 ID, 밀도 예산, 발표자 노트의 목표를 명시합니다.
- 설치된 NodeSlide 전송 방식을 다음 순서로 사용하기: 저장소 네이티브 어댑터, NodeSlide CLI, NodeSlide MCP, 또는 패키지 API. 먼저 기능을 검사하고 호스팅된 쓰기, 내보내기, 승인이 가능하다고 절대 가정하지 마세요.
- 고정된 데크 버전에 대해 데크 변경 제안하기. 호스트 정책을 통해 검증, 비교, 적용하며, 편의를 위해 NodeSlide 거버넌스를 우회하지 마세요.
- 모든 실질적 주장을 현재 커밋 또는 배포에 대해 검증하기. 오래된 스크린샷과 메트릭을 갱신하고, 제한 사항을 계속 표시합니다.
- 요청된 편집 가능한 형식으로 내보내고 다시 열기. 렌더링된 데크, 발표자 노트, 소스 바인딩, 그리고 모든 PPTX 라운드 트립을 검증합니다.
- 데모 스크립트, README 섹션, 릴리스 노트, 제출 카피를 동일한 변경 스토리와 증거 인덱스로부터 도출하기.
데모 클립은 렌더링된 워크스루이며, 화면 녹화가 아닙니다
이 섹션은 측정된 실패 때문에 존재합니다. 프로덕션 배포가 11/11에 녹화된 클립으로 검증되었는데, 그 클립은 원시 Playwright 캡처였습니다: 초점 프레이밍도, 자막도, 보이는 스트리밍이나 도구 호출도, 슬라이드도 없었습니다. 이 모든 것을 위한 도구는 이미 존재했지만 이 스킬이 그중 어느 것도 명명하지 않았기 때문에, 잘 구동되지 않고 수작업으로 엉성하게 처리되었습니다.
FeatureClipStudio (feature-walkthrough-gif/)는 캡처-투-렌더 파이프라인이며, 원시 캡처에는 절대 없는 네 가지를 다룹니다:
| 원시 캡처에 없는 것 | 파이프라인이 하는 일 |
|---|---|
| 중요한 것에 초점 맞추기 | 줌-투-포커스 카메라, 각 클릭 지점으로 애니메이션 커서가 잔물결과 함께 이동 |
| 설명 | 상태별 단계 자막 |
| 작업 자체가 보이는 것 | 실시간 로딩 및 스트리밍 캡처 — 스피너가 돌고, 결과가 도착하는 모습 |
| 주장이 의존하는 내부 요소 | 원시 JSON/상태 증거 패널 |
npm run capture # Playwright가 라이브 흐름을 구동하고 모든 UI 상태를 기록합니다
npm run studio # 캡처된 상태를 스토리보드로 구성합니다
npm run render # Remotion이 워크스루를 렌더링합니다
npm run judge # Gemini가 RENDER를 보고 점수를 매깁니다
judge-video.mjs가 게이트이며, 클립이 완료되었다고 판단하기 전에 실행해야 하는 것입니다. 렌더링된 MP4를 안티-히어로-샷 루브릭(평가 기준)에 따라 평가하고 P0/P1/P2 수준의 타임스탬프가 찍힌 결함을 반환합니다 — P0는 게시를 차단합니다. 헤더 자체에 요점이 명시되어 있습니다: 최종 컷은 더 이상 인간의 눈만이 확인하는 단계가 아닙니다. GIF보다는 MP4를 평가하세요; GIF는 지원되는 비디오 MIME이 아닙니다.
판사가 이미 통과시킨 P2에 대해 재렌더링-폴리시 루프에 들어가지 마세요.
두 가지 축, 그리고 두 번째 축이 실패하는 축입니다
judge-video.mjs는 CRAFT(커서 진실성, 페이싱, 가독성, 모션)를 점수화하고, 별도로 COMPREHENSION을 점수화합니다. COMPREHENSION은 시청자가 실제로 얻어가야 하는 열 가지 항목입니다:
persona(페르소나) · purpose(목적) · use_case(사용 사례) · feature_clarity(기능 명확성) · full_interaction(전체 상호작용)
responsiveness(응답성) · flow(흐름) · result(결과) · non_expert_sense(비전문가 이해도) · transfer(전이 가능성)
이 두 축은 직교하며, 잘 만들어진 컷도 이해하기 어려울 수 있습니다. 실제 렌더링에서 측정된 결과: CRAFT는 publish 판정으로 통과했지만, COMPREHENSION은 10개 항목 모두에서 1점을 기록했습니다 — 부재한 것도, 명시적인 것도 없고 모든 것이 단지 암시되었을 뿐이며, 판사는 0:06을 비전문가가 길을 잃는 순간으로 지목했습니다(