scientific-writing-story

サイエンティフィックライティング — ステージ 1：ストーリーを見つける

概要

研究リポジトリには、並行して進められた実験や中断された実験が蓄積されます。アウトラインや文章を書く前に、論旨、論旨を支える実験、そして採用しなかった内容の明確な記録から成る、一本筋の通ったストーリーを確立します。出力先：利用側のリポジトリの docs/writing/<story-slug>/story.md。

自分の思い込みに基づいてストーリーを書かないでください。まずリポジトリを調査し、その後ユーザーとすり合わせます。

手法の基盤 — ステップ 1〜2

このステージは、15 ステップのうちステップ 1〜2 です（詳細：scientific-writing/fifteen-steps.md）。

• ステップ 1 — 主旨。 論旨は、現象の範囲を定め、焦点を与える 短い平叙文 1 文（主語＋動詞）です。後に続くすべての段落は、この主旨を明らかにするものでなければなりません。最終的なタイトルにする必要はありません。
• ステップ 2 — 物語の流れ。 物語の流れでは、何を知りたかったのか、なぜか、何を行ったのか、今何がわかっているのかに答え、重要な展開（問い→答え、理論→証拠、データ→解釈）をたどります。2 部構成を優先してください — 最も記憶に残り、論文として発表しやすい形です。ユーザーとのすり合わせの際に、どの 2 部構成が適しているか確認してください（例：実験 1 ＋ 実験 2、単純なモデル ＋ 複雑なモデル、実験 ＋ その説明モデル、検証のためのモデル ＋ 実験、観察されたパターン ＋ その説明モデル）。

プロセス

1. 研究全体をマッピングする。 Explore サブエージェント（読み取り専用）を起動し、実験／スクリプト、results/、figures/、ノートブック、Git ログ、CLAUDE.md を調査します。 独立した領域がある場合は superpowers:dispatching-parallel-agents を使用します。 目標：すべての実験／結果の流れを列挙し、それぞれに 主軸候補 または 除外候補 のタグを付けます。
2. 一度に 1 つの質問で、ユーザーとすり合わせる。 仮のタイトル、1 つの論旨、採用する流れ、除外する流れを確認します。選択肢を複数提示する形式を優先します。ユーザーが論旨と採用／除外の区分を確認するまで、執筆に進まないでください。
3. story.md を書く（以下のテンプレート）。

story.md テンプレート

# <Working title>
slug: <kebab-case-slug>

## Thesis
<one or two sentences — the single claim the paper makes>

## Narrative arc (linear)
Two-part scheme: <which Step-2 scheme, e.g. "experiment + model to explain it">
1. <beat> 2. <beat> 3. <beat> …  (the logical order the paper will argue in)

## Beat → artifacts
| Beat | Supporting artifacts (scripts / results / plots / notebooks) |
|------|------|
| <beat> | `path/to/script.py`, `results/x.csv`, `figures/y.svg` |

## Dropped / out of scope
- <thread> — why dropped (user-confirmed)

注意すべき兆候 — 進行を止める

• リポジトリをマッピングする前に story.md を書く → 先にマッピングします。
• ユーザーが確認していない論旨を断定する → 質問します。
• 裏付けとなる成果物のない展開 → 見つけるか、展開として扱わないようにします。
• 中断された実験を黙って含める → 「除外」に入れます。

次のステージ

ユーザーが story.md を承認したら、scientific-writing-outline を呼び出します。