Presentation First Tech Blog

調査済みの技術材料を短いナラティブ・デッキで構造化し、スピーカーノートで説明の欠落を検出してから、単体で理解できるWeb記事へ再設計する。プレゼンテーションを記事の縮小版ではなく、物語を安価に試すプロトタイプとして扱う。

手順

Step 1: 適用可否を判定する

1. 記事の目的を、問題提起、概念説明、設計判断、比較、導入判断、実測報告のいずれかへ分類する。
2. 問題から判断へ導く記事、新しい概念や設計判断を説明する記事、トークと記事を併用する企画、図解や比較を中心にする記事には、このワークフローを使う。
3. APIリファレンス、コマンド一覧、厳密なセットアップ手順、障害対応の時系列記録、網羅性を優先するチュートリアルには使わない。検索性、完全性、手順精度を優先する別の方法へ切り替える。
4. 技術材料、想定読者、公開目的が欠けている場合は、不足する項目だけを確認する。

Step 2: 単一のワークベンチを初期化する

1. assets/article-workbench-template.md をコピーし、作業用Markdownを1つ作る。
2. 企画、証拠、ナラティブ・デッキ、スピーカーノート、記事本文、監査結果を同じファイルで管理する。
3. 出力先が未指定なら outputs/<topic>-article-workbench.md を使う。
4. 生データや実験ログは別ファイルに保存してよいが、ユーザー向けの正本はワークベンチ1つに保つ。