トピック開発
候補となるトピックを承認済みのコンテンツ契約に変えます。この作業が完了していれば、後工程で主張、証拠、境界を新たに考案する必要がなくなった時点で、執筆準備が整ったと言えます。
スコープ
1つの候補トピック、または自然に境界が定まる小さなセットから開始します。複数の方向性が残っている場合は、オーディエンスにとっての価値、新規性、検証可能性、実証可能性、執筆者との適合性、過剰主張のリスクについて軽く比較し、深掘りリサーチの前にユーザーに選択を促します。オープンエンドなトレンド調査やアイデアバックログの管理は、このスキルの範囲外です。
証拠ワークスペース
動画プロジェクト内に content/ ディレクトリを作成します。
content/
|-- RESEARCH.md
|-- TOPIC.md
`-- experiments/
RESEARCH.md は、情報源のある事実、解釈、意見の相違、未知の事項、却下した方向性、一次資料へのリンクに使用します。収集と編集上の選択は分離したままにします。
ある主張が、その主題が機能するかどうかに影響する場合、オーディエンスにとって重要である場合、代替案と異なる場合、実証可能である場合、または明示されたスコープ内で有効である場合に、それを「重要な証拠」として扱います。その主張に対して十分に強力な情報源または実験で裏付け、弱い証拠には「暫定的」とラベル付けし、無理に権威付けしないでください。
主張に実行可能な証拠が必要な場合は、それを解決できる最小の実験を行い、content/experiments/<name>.md に、疑問点、方法、サンプル、環境、コマンド、結果、制限事項、および結果が裏付ける結論を記述します。コードと生データはそれらを所有するプロジェクトに残し、動画プロジェクトにコピーする代わりに、それらのパスとGitリビジョンを記録します。
コンテンツ契約
content/TOPIC.md を作成します。
---
status: draft
audience: ...
core_question: ...
thesis: ...
scope: ...
voice:
language: ...
skills: []
documents: []
unavailable: []
status: resolved | assumed
---
# 仮タイトル
## 読者への約束
## 主張
### A01 - 主張
- role: この主張が議論内で存在する理由
- claim: 正確な命題
- evidence: RESEARCH.md の見出しまたは実験レポートへのリンク
- confidence: established | provisional
- boundary: 証拠が確立しないこと
## スコープ外
## 未解決の質問
## 代替タイトル
音声（voice）の情報源は、次の順序で解決します。明示的なユーザー指示、プロジェクトまたはブランドのガイダンス、言語とコンテンツタイプに一致する利用可能なライティングスタイルスキル、可視のユーザー設定、ライティングサンプル、そして明確なデフォルト説明。実際に使用した情報源を記録し、要求されたが利用できなかった情報源は voice.unavailable の下に保持します。利用できないメモリや隠れたプロファイルを想定しないでください。
承認ゲート
作業タイトル、テーゼ、スコープ、議論、主要な証拠、境界、および重要な未解決の質問をレビューのために提示します。タイトルは変更が続く場合がありますが、オーディエンス、テーゼ、スコープ、議論、証拠、および結論の境界はロックされた決定事項です。
明示的なユーザー承認のみが、フロントマターを次のように変更します。
status: approved
approved_at: YYYY-MM-DD
approved_digest: sha256:<digest>
ダイジェストは、approved_digest: 行のみを削除した後の完全なファイルのSHA-256です。承認を信頼する前に再計算してください。不一致があると承認は古くなり、ファイルは draft に戻ります。非実質的なタイトルまたはコピー編集の後は、再承認なしでダイジェストを更新できます。新しいダイジェストをすべての依存アーティファクトに伝播します。
それまでは、すべての執筆を RESEARCH.md、実験レポート、およびドラフトの TOPIC.md 内に留めてください。ARTICLE.md や BEATS.md を作成しないでください。迅速に進めたいという要求やテーゼを選択する許可は、結果として得られる契約の承認に代わりません。
後でロックされた決定事項に重要な変更が加えられた場合、TOPIC.md は draft に戻り、下流の記事の承認は古くなります。意味を保持するコピー編集、例、およびタイトルの変更は承認を取り消しません。
content/TOPIC.md またはその後の改訂版を提示する前に、../boring-video/references/markdown-review.md に従ってください。正規のMarkdownパスを現在のバージョンとして保持し、レビューフィードバックをそこに適用します。
トピックは、TOPIC.md が承認され、すべての重要な主張が十分な証拠を指し示し、残っている未解決の質問が非ブロッキングかつ可視であり、記事の作成者が事実、実験、著者の立場、議論、またはスコープを発明することなくドラフトを作成でき、かつMarkdownレビューの完了基準が満たされたときに完了します。