# Content Layout

このリポジトリでは、`docs/` と `out/` を次のルールで使い分けます。

## 基本ルール

- `docs/`: 人が読む正本。手で編集する文章、公開用の原稿、プロンプト、設計メモ、参照資料を置く
- `out/`: ツールや生成処理の出力先。画像、候補案、エクスポート、比較用の派生物を置く

迷ったときは、この基準で決めます。

1. 人があとで読み返して再利用する文章か
   - はい: `docs/`
2. 再生成できる生成物か
   - はい: `out/`

## Social / X 運用

- `docs/social/`
  - 投稿文の正本
  - 画像生成プロンプト
  - alt テキスト
  - 投稿メモ、構成案
- `out/social/`
  - 生成された画像
  - 候補カード
  - ツールが吐いた下書き
  - 比較用の一時成果物

つまり、`docs/social/` が「何を投稿するか」、`out/social/` が「何が生成されたか」です。

過去の運用で `out/x-post/`、`out/x-posts/`、`out/x-promo/`、`out/x-release/` も存在します。これらは当面そのまま残しますが、**今後の新規 social 系出力は `out/social/` に寄せる**方針とします。

## Slides / Media 運用

- `docs/slides/`
  - スライド原稿、仕様、YAML ソース
- `out/slides/`
  - 書き出し画像、選定済み画像、品質レポート

## 追加時のルール

- 新しい投稿文を保存するときは、まず `docs/social/` に保存する
- 画像生成や書き出しを回した結果は `out/social/` に保存する
- `docs/` に生成画像を増やさない
- `out/` に正本の説明文を増やさない

## 今回の整理方針

- X 投稿の原稿ソースは `docs/social/` に集約していく
- 既存の `out/social/` は生成済み成果物として維持する
- 将来の追加も同じルールに従う