to-spec-beats

仕様に沿ってビートを作成する

承認済みの content/ARTICLE.md を BEATS.md に変換します。これは動画の事実と物語の骨格です。作品が何を伝えるかは記事が担い、この工程では視聴者が何をいつ学ぶかを決めます。後続の工程で、話す言葉とビジュアルを決めます。

プロセス

1. content/ARTICLE.md、存在する場合は content/TOPIC.md、およびそれらの境界を維持するために必要な根拠資料を読みます。承認済みの各ファイルについて、approved_digest: の行のみを削除して SHA-256 を再計算します。保存されているダイジェストが現在のファイルと一致し、記事の status: approved が確認できた場合にのみ続行します。ユーザーがこのワークフロー外で作成された記事の全文を持ち込んだ場合は、まず /boring-video の外部ソース規約に従って content/ARTICLE.md として配置または調整します。トピックに関する別個の規約を遡って適用する必要はありません。
2. 承認済みの記事と、存在する場合はトピック規約から、対象読者、主張、範囲を引き継ぎます。対象読者の既有知識、理解における望ましい変化、目標尺、承認済みの範囲から動画で取り上げる内容のみを定義します。
3. リバース・アイスバーグ型の展開を作ります。視聴者の言葉でフックを提示し、2つ目のビートまでに価値や答えを示したうえで、根拠、仕組み、示唆、締めくくりへと進みます。意味と境界を保ちながら、媒体に合わせて記事の内容を並べ替え、圧縮、または省略します。
4. 各ビートには認知上の役割を1つだけ持たせます。互いに独立した2つの理解を要するビートは分割し、承認済みの主張に結び付かない役割を持つビートは削除します。
   • ビートには、ビジュアルの演出、カメラワーク、アニメーション、構図、シーン要素を含めません。後続の工程に必要な内容上の事実のみを記録します。ここで見つかったビジュアルのアイデアは SCENES.md に移し、ビートの仕様には含めません。
5. content/ と同じ階層に、次の形式で BEATS.md を作成します。

---
source: content/ARTICLE.md
source_digest: sha256:<ARTICLE approved_digest>
artifact_digest: sha256:<digest>
audience: ...
thesis: ...
viewer_shift: ... → ...
target_duration: ...
---

## B01 — Title
- job: What changes in the viewer's understanding
- claim: The factual statement this beat establishes
- source: Article heading or passage that establishes it
- evidence: Source or experiment already selected by the article
- setup: Prior beat knowledge this depends on
- handoff: Question or tension passed forward
- duration: Rough narration budget

Notes needed to write this beat accurately.

artifact_digest は、artifact_digest: の行のみを削除した、ビートファイル全体の SHA-256 として計算します。後続の工程では保存済みの値を信頼せず、必ず再計算してください。

6. ファイル全体を監査します。重要な主張と視点のすべてが承認済みの記事に基づいていること、すべての依存関係が前のビートを指していること、主張が2つ目のビートまでに示されていること、そして尺の配分が目標に収まっていることを確認します。

動画の構成によって、事実、視点、論拠の段階、または結論の不足が明らかになった場合は、content/ARTICLE.md に戻します。その解決によって固定済みのトピックの決定が変わる場合は、content/TOPIC.md も draft に戻します。必要な承認を更新してから、変更を後続の工程に反映します。BEATS.md 内でコンテンツの不足を補ってはいけません。

ビート ID は安定したインターフェースです。改訂時も維持し、ビートを挿入する場合は新しい ID を割り当てます。

BEATS.md またはその後の改訂版を提示する前に、../boring-video/references/markdown-review.md に従ってください。構成レビューでは、学習の流れ、主張、根拠、尺の配分を承認できるよう、正式な Markdown を提示します。ただし、ビジュアルの実行内容は承認の対象外です。

別のライターが内容を創作することなくナレーションを作成でき、すべてのビートが新たな論拠ではなく承認済みの記事を媒体に合わせて構成したものであり、Markdown レビューの完了条件を満たしたとき、BEATS.md は完成です。