# Compile Timeline

> Compiles a video editing timeline from blueprint and candidate files, generating timeline and preview manifests, with optional review patch application.

- Skill: `mocchalera/compile-timeline` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mocchalera/compile-timeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mocchalera/compile-timeline/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools, Dev Tooling
- Tags: Npx, Timeline, Tsx, Typescript, Video Editing
- Author: mocchalera (https://skillmd.com/u/mocchalera)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/mocchalera/compile-timeline

---

# compile-timeline
## いつ使うか
- 「コンパイルして」「タイムラインを生成して」と言われたとき。
- `creative_brief.yaml`, `selects_candidates.yaml`, `edit_blueprint.yaml` が揃っているとき。

## 前提条件
- `scripts/compile-timeline.ts` は compile 前後で `scripts/validate-schemas.ts` 相当の gate を見る。
- `01_intent/unresolved_blockers.yaml` に `status: blocker` があると compile gate が落ちる。
- fps を 24 以外にしたい場合は `--fps <num>` を明示する。

## やること（ステップ）
1. 必要 artifact が存在することを確認する。
2. compile を実行する。

```bash
npx tsx scripts/compile-timeline.ts projects/<project> --fps 30
```

3. review patch を適用したい場合は patch mode を使う。

```bash
npx tsx scripts/compile-timeline.ts projects/<project> --patch projects/<project>/06_review/review_patch.json --fps 30
```

4. 出力された `timeline.json`、`preview-manifest.json`、必要なら `adjacency_analysis.json` を確認する。
5. 既存preview/finalがある状態でtimelineを更新した場合、それらをfreshとみなさない。Studio確認前にrenderを再実行し、`playback-contract-status` が `exact` であることを確認する。

## 出力 artifact
- `05_timeline/timeline.json`
- `05_timeline/preview-manifest.json`
- `05_timeline/adjacency_analysis.json` ただし active editing skills による transition 解析が走った場合

## 注意事項
- `scripts/compile-timeline.ts` の `createdAt` は `01_intent/creative_brief.yaml.created_at` から決まる。
- patch mode は `timeline.json` を上書きし、同時に `preview-manifest.json` も再生成する。
- manifest hashだけを手編集して古いpreviewをfresh扱いにしない。
- `adjacency_analysis.json` は debug / explanation 用 artifact。常に生成されるわけではない。