모터사이클 엔진을 분해 가능한 페이지로 바꿔주는 Claude 스킬

이 프로젝트의 지시문은 한 문장이다. 분해할 수 있는 4행정 모터사이클 엔진 시뮬레이터를 만들어 달라고 Claude Code에 말하면 만든다. 기계식 시계는 어떻게 시간을 맞추는지 물으면 그것도 만든다. 유압 굴착기 암의 분해와 그 20초짜리 영상을 함께 요청하면 둘 다 나온다.
프로젝트 이름은 teardown, 스타 3,497개에 MIT 라이선스이고, 앱이 아니라 스킬이다. 설치는 한 줄이다. `npx skills add elvarofficial/teardown -g -a claude-code`를 실행하고, 폴더 안에서 `npm install && npx playwright install chromium`을 돌린다. Node 20 이상, 영상이 필요하면 ffmpeg, 소리가 필요하면 Python 3.
결과물
기계 하나당 HTML 파일 하나, 완전히 오프라인이고 three.js와 폰트가 인라인으로 박혀 있다. 이 제약이 곧 설계다. 서버도 CDN도 없고, 읽는 사람에게 빌드 단계도 없다. 메일로 보내면 그냥 열린다.
페이지 안에서 기계는 한가운데 앉아 있다. 주변의 HUD 패널은 스펙 시트의 인용문이 아니라 시뮬레이션에서 뽑은 실제 수치를 읽는다. 샤프트 회전수, 밸브 타이밍, 압력. 버튼을 누르면 그 순간 일을 하고 있는 어셈블리가 열려서, 지금 움직임을 담당하는 부품이 보인다. 한동안 아무도 건드리지 않으면 페이지가 스스로 투어를 시작해 정해진 순서로 카메라를 옮기고 부품을 연다.

참조 구현으로 세 대가 들어 있다. V8 엔진, Cessna, Strandbeest. 로컬에서 `node sims/build.mjs v8-live`로 빌드해 결과를 열어볼 수 있는데, Claude에게 새 기계를 부탁할 생각이 없어도 해볼 만하다. 스킬이 겨냥하는 기준선이 거기 있다.
스킬이 품질을 유지하는 방법
흥미로운 엔지니어링은 3D가 아니라 리뷰 루프다. `SKILL.md`에는 기계를 어떻게 조립하는지, 무엇이 있어야 제대로 보이는지, 에이전트가 넘기기 전에 자기 출력을 어떻게 검사해야 하는지가 규칙으로 적혀 있다. `sims/kit/` 아래의 키트가 런타임과 스테이지, 셰이더 워밍업을 제공하므로 모델이 요청마다 렌더러를 처음부터 쓰지 않는다.
캡처는 별도이고 똑같이 계산된 부분이다. `sims/capture.mjs`는 프레임을 하나씩 렌더해 60fps MP4로 만들고, 리뷰용으로는 스틸 시트로 묶는다. `run_sfx.py`는 영상 타임라인에 맞춰 소리를 절차적으로 생성하고 -14 LUFS로 마스터링하는데, 스트리밍 플랫폼이 정규화 목표로 삼는 음량이다. 소리가 어긋난 생성 영상은 바로 티가 난다. 이 단계가 올릴 수 있는 것과 없는 것을 가른다.
계보는 명시돼 있다. 런타임, 프레임 캡처, 사운드 엔진, 리뷰 규칙은 whaleyxbt/claude-motion에서 왔고 이것도 MIT다. 사운드 샘플은 Freesound의 CC0이며 다른 저장소가 다듬었다. 남의 애니메이션 키트 위에 세우고 그렇게 밝히는 일은 멋있지 않다. 그래도 이게 몇 달이 아니라 몇 주 만에 나온 이유다.
분해되는 기계가 도해보다 잘 가르치는 이유
분해도는 한 세기 동안 정비 매뉴얼에 실려 왔고 이유가 있다. "안에 무엇이 있는가"에는 답하지만 "무엇이 무엇을 움직이는가"에는 답하지 않는다. 정지된 그림은 피스톤이 상사점에 닿기 직전에 캠이 밸브를 연다는 사실을 보여주지 못한다. 밸브 타이밍이 머리에 들어오게 하는 건 바로 그 한 가지다.
상호작용이 그걸 값싸게 해결한다. 슬라이더를 끌면 크랭크 각이 바뀌고 나머지가 따라온다. 사이클 중간에 하우징을 열면 어느 부품에 하중이 걸리는지 보인다. 패널의 숫자가 갱신되므로 외우는 대신 관계를 지켜볼 수 있다.
투어 모드는 들리는 것보다 중요하다. 대부분은 무엇을 먼저 눌러야 할지 모르고, 좋은 질문을 기다리며 가만히 있는 페이지는 닫히는 페이지다. 자동 투어는 시뮬레이션을 설명으로 바꾼다. 기술 콘텐츠 대부분이 실제로 필요로 하는 형식이 그것이다.
뻔한 실패 방식
언어 모델이 물리 시뮬레이션을 쓰면 물리를 틀릴 때가 있다. 그럴듯한 엔진을 만들어놓고 밸브 타이밍이 20도 어긋나 있거나, 기어비가 곱해져서 맞지 않는 변속기를 만든다. 파이프라인 어디에도 정확성 보장은 없다. 리뷰 규칙은 확률을 높일 뿐 인증하지 않는다.
이 말을 꺼내는 이유는 이런 페이지의 완성도가 설득력을 가질 만큼 높기 때문이다. 깔끔한 3D 모델에 실시간 숫자가 붙으면 권위적으로 읽힌다. 숫자가 지어낸 것이라면 그 페이지는 대단히 설득력 있는 잘못된 정보다. 그리고 움직이기 때문에 나쁜 도해보다 위험하다.
대응책은 어떤 에이전트 출력에도 적용되는 같은 것이다. 출처와 산수를 보여달라고 하면 된다. 제대로 만든 시뮬레이터는 파라미터를 코드에 드러내므로, 3,000 rpm에서 4행정 사이클이 분당 1,500번 폭발한다는 걸 확인할 수 있다. 패널이 다른 말을 하면 그 페이지는 틀린 것이고, 그게 눈에 보인다.
두 번째 한계는 범위다. 역학이 분명한 기계는 된다. 엔진, 시계, 링크 기구, 유압 암. 거동이 대부분 화학이나 전자기, 혹은 소프트웨어로 정의되는 기계는 회전하는 어셈블리로 환원되지 않는다. 배터리를 부탁하면 자신만만하고 쓸모없는 것이 나온다.
영상이 페이지보다 자주 납품물이 된다
한 번의 요청에서 나오는 두 출력을 분리해서 볼 필요가 있다. 인터랙티브 페이지는 이해하고 싶은 사람을 위한 것이다. 녹화된 영상은 나머지 모두를 위한 것이다. 피치 자료, 런칭 글, 교육 모듈, 컨퍼런스 루프 영상.
두 번째 출력이 캡처와 오디오 파이프라인이 존재하는 이유이고, 데모 기준이 아니라 방송에 가까운 기준으로 만들어진 이유이기도 하다. 60fps로 렌더하고 오디오를 -14 LUFS로 마스터링한 영상은 편집기에 그대로 들어간다. 누가 슬라이더를 끄는 화면 녹화는 그렇지 않다. AI가 만든 설명 콘텐츠 대부분은 그 두 결과물 사이의 간격에서 죽는다. 비전은 맞는데 마감이 없기 때문이다.
형식이 곧 이야기다
이걸 영리한 데모 이상으로 만드는 것은 출력 형식이다. HTML 파일 하나, 오프라인, 스스로 투어하고, 녹화 영상과 마스터링된 오디오까지. 이건 완성된 교육 자료다. 랜딩 페이지가 될 수도, 영업 설명이 될 수도, 박물관 키오스크가 될 수도, 하드웨어 매뉴얼의 부록이 될 수도 있다.
이 조합은 예전에 3D 아티스트, 모션 디자이너, 사운드 디자이너, 프런트엔드 개발자를 필요로 했다. 지금은 한 문장과 리뷰 한 번이면 된다. 그리고 리뷰가 바로 사람이 시간을 써야 할 지점이다. 모델은 조립과 카메라 워크를 아주 잘한다. 숫자에 대해서는 아직 믿을 수 없고, 페이지는 그 숫자를 위해 존재한다.
관련 글
중국산 안드로이드 시스템 UI의 광고를 끄는, 커뮤니티가 관리하는 탭 표
시스템을 건드리지 않고, 잠금 해제도, 플래싱도 하지 않는다. 제조사가 이미 열어 둔 스위치를 하나씩 뒤집을 뿐이다. 대가는 이 목록을 계속 써 줄 사람이 필요하다는 것이다.
GPT Image 2.6, 토큰 단가는 그대로 두고 청구서를 올렸다
GPT Image 2.6은 2.5의 토큰 단가를 하나도 바꾸지 않았는데 이미지 한 장 값은 올랐다. 작업의 상당 부분이 이제 출력 토큰에서 일어나기 때문이다. 출시 11일째, 가격 구조가 순위표보다 많은 것을 말한다.
IDM을 바깥에서 다시 만든 사람이 손대지 않은 부분을 적어 두었다
Mister Download Manager는 Internet Download Manager의 흐름을 Rust로 다시 구현해 5배 속도와 86개 언어를 내건다. 더 흥미로운 문서는 아무것도 복사하지 않고 어떻게 만들었는지 설명하는 문단이다.
Rune은 에이전트가 자기 작업을 검증할 수 있도록 만든 Rust UI 프레임워크
Rune은 헤드리스로 렌더링하고 요소 트리를 덤프하며 스크립트 입력을 받는다. 스크린샷으로는 얻을 수 없는, diff 가능한 신호를 코딩 에이전트에게 준다. 프레임워크는 프리릴리스이며 풀 리퀘스트를 받지 않는다.