FBC Press シリーズで共有する、書籍の企画・執筆・調査・図版・技術基盤・レビュー・公開のルールです。
このリポジトリは特定の 1 冊の原稿や、章を量産するためのひな型集ではありません。背景、思想、仕組み、実務判断を一続きで説明し、読者が暗記ではなく判断できる書籍を作るための編集基盤です。
- AI エージェント: AGENTS.md
- 編集工程を確認する人: EDITORIAL_WORKFLOW.md
- 本や章を企画・執筆する人: STYLE_GUIDE.md
- 章の密度を具体例で確認する人: SAMPLE_CHAPTER.md
- 公開前の確認をする人: REVIEW_CHECKLIST.md
- 今回の作業について人間が明示した指示
- このリポジトリにある FBC Press 共通ルール
- 対象書籍のリポジトリにある固有ルール
- テンプレート、持ち運び用プロンプト、例
対象書籍の固有ルールは、共通ルールをその本の技術・読者・構成へ具体化するために使います。共通ルールから外れる必要がある場合は、人間の承認と理由を対象書籍の作業記録へ残します。
| 作業 | 最初に読む文書 | 必要に応じて読む文書 |
|---|---|---|
| 本全体の企画・構成 | STYLE_GUIDE.md | BOOK_OUTLINE_TEMPLATE.md、AI_MODEL_POLICY.md |
| 章の設計・執筆・改稿 | STYLE_GUIDE.md | SAMPLE_CHAPTER.md、CHAPTER_TEMPLATE.md、TERMS.md |
| 付録・演習 | APPENDIX_TEMPLATE.md | STYLE_GUIDE.md、対象書籍のアウトライン |
| 調査・根拠集め | RESEARCH_RULES.md | REFERENCE_CHECK.md、AI_MODEL_POLICY.md |
| 図版の企画・制作 | FIGURE_GUIDE.md | ASSET_RULES.md、TERMS.md |
| リポジトリの新設・整理 | REPOSITORY_STRUCTURE.md | CI_RULES.md、THEME_CUSTOMIZATION.md |
| mdBook、テーマ、共通フッター | THEME_CUSTOMIZATION.md | BUILD_AND_PUBLISH.md、PROMOTION_POLICY.md |
| CI、ビルド、公開 | BUILD_AND_PUBLISH.md | CI_RULES.md、REVIEW_CHECKLIST.md |
| 宣伝導線 | PROMOTION_POLICY.md | THEME_CUSTOMIZATION.md |
| AI の選択・利用 | AI_MODEL_POLICY.md | CONTEXT_MANAGEMENT.md、作業内容に対応する正本文書 |
| 章・書籍のレビュー | REVIEW_CHECKLIST.md | 問題の種類に対応する各正本文書 |
| 長期作業の引き継ぎ | CONTEXT_MANAGEMENT.md | 対象書籍の進行記録 |
すべての文書を毎回読む必要はありません。EDITORIAL_WORKFLOW.md で現在の工程を確認し、上表から必要な文書を選びます。
| 文書 | 責務 |
|---|---|
| AGENTS.md | AI が作業別に読む文書と実行時の共通ルール |
| EDITORIAL_WORKFLOW.md | 企画から改訂までの工程と完了条件 |
| CONTEXT_MANAGEMENT.md | 長期作業の判断・進行・未解決事項を引き継ぐ方法 |
| 文書 | この文書を正本とする内容 |
|---|---|
| STYLE_GUIDE.md | 読者価値、密度、本文、見出し、説明順、章構成 |
| TERMS.md | FBC Press 全体の採用表記 |
| RESEARCH_RULES.md | 調査方法、情報源の優先順位、技術情報の書き方 |
| REFERENCE_CHECK.md | 掲載する出典、引用、リンクの確認 |
| FIGURE_GUIDE.md | 図の目的、情報設計、表現、アクセシビリティ |
| ASSET_RULES.md | アセットの命名、配置、生成元、権利、更新 |
| AI_MODEL_POLICY.md | AI モデルの選択と公開前の人間による確認 |
| REPOSITORY_STRUCTURE.md | 書籍リポジトリの構成、命名、シリーズ台帳 |
| CI_RULES.md | CI に持たせる確認と持たせない判断 |
| BUILD_AND_PUBLISH.md | ローカル確認、本番ビルド、公開、公開後確認 |
| THEME_CUSTOMIZATION.md | 日本語テーマ、書籍固有 CSS、共通フッター |
| PROMOTION_POLICY.md | FjordBootCamp の紹介文と宣伝導線 |
| 文書 | 位置付け |
|---|---|
| BOOK_OUTLINE_TEMPLATE.md | 本全体と各章の論証を設計する参考形 |
| CHAPTER_TEMPLATE.md | 章を書く前の問いと章構成の参考形 |
| APPENDIX_TEMPLATE.md | 必要な付録・演習を設計する参考形 |
| SAMPLE_CHAPTER.md | 密度と説明の積み上げを示す例 |
| WRITING_PROMPT.md | 正本を直接参照しにくい環境へ渡す持ち運び用要約 |
| REVIEW_CHECKLIST.md | 執筆後・ビルド後・公開前の横断確認 |
補助文書は正本を上書きしません。WRITING_PROMPT.md に規則を追加する場合は、先に正本文書を更新します。SAMPLE_CHAPTER.md は密度の基準であり、題材、語り口、節構成を全章へ複製するための見本ではありません。
- STYLE_GUIDE.md の第0節と SAMPLE_CHAPTER.md を読む
- BOOK_OUTLINE_TEMPLATE.md を参考に、本全体と全章の論証を
OUTLINE.mdへ書く - 対象書籍に
STYLEGUIDE.mdとTERMS.mdを作り、技術バージョン、読者、用語、基準資料を具体化する - REPOSITORY_STRUCTURE.md に従って構成を作り、THEME_CUSTOMIZATION.md に従って日本語テーマを導入する
- CHAPTER_TEMPLATE.md の問いへ答えてから本文を書く
- REVIEW_CHECKLIST.md の「密度・固有性チェック」から自己点検する
形を揃えるだけでは、良い本にはなりません。具体例、対比、根拠、前後の体系的な接続によって、各章の密度を作ります。
- 想定読者、前提知識、読後にできるようになること
OUTLINE.mdと章ごとの論証STYLEGUIDE.mdと書籍固有のTERMS.md- 対象技術のバージョン、情報の基準日、基準 URL
- 調査記録、出典台帳、図版台帳、レビュー記録
- 作業状況、未解決事項、採用しなかった案
- 書籍固有のビルド・公開手順と、承認済みの例外
- 新しいルールを追加する前に、正本となる既存文書を確認する
- 同じ規則を複数文書へ詳しく複製しない
- 正本を変えたら、対応するテンプレート、
WRITING_PROMPT.md、SAMPLE_CHAPTER.md、チェック項目を確認する - 特定の一冊だけに必要なルールは、その書籍側へ置く
- ファイル名を変える場合は、シリーズの書籍リポジトリからの参照を先に調査する