要件定義書

1. 背景・課題

プロジェクトの情報共有において、次の問題が起きている。

md ファイルの増殖：設計メモ・手順書・議事録・学び記録が md で量産される。AI コーディング支援（Claude Code 等）の普及で生成速度がさらに上がった
可読性の低さ：md の山はエディタや git のファイル一覧でしか俯瞰できず、関係者が「どこに何があるか」を把握できない
HTML の手作り増加：読みやすさを求めて HTML 資料を個別に作る人が増え、正本が分裂し始めている
wiki の廃墟化：過去に導入した wiki ツールは、転記・整形の手間が人間任せだったため更新が止まった

書くコストは下がったのに、読む・探すコストが下がっていない。これが解決したい本質的な課題である。

正本を md + git に一本化したまま、人間向けの読み口（サイト）を自動生成する。サイトの管理作業を「ファイルを置く」だけに圧縮し、更新が止まらない仕組みを作る。

用語	定義
正本	唯一の信頼できる原稿。本システムでは `docs/` 配下の md ファイル
読み口	人間が閲覧するための表示形態。本システムでは自動生成される静的サイト
増築	ディレクトリにファイルを追加してサイトを拡張すること

AI を正式な利用者として定義する点が本システムの特徴である。md + git という正本形式は、AI が直接読み書きできる。

ID	要件	備考
FR-01	`docs/` 配下に md を置くと、ページとサイドバー項目が自動で生成されること	ディレクトリ構造＝サイトマップ
FR-02	サイドバーの表示名は md の frontmatter `title:`（日本語）を反映すること	URL は英語スラグのまま
FR-03	日本語で全文検索ができること	追加サービス契約なし
FR-04	サイト内リンクの切れをビルド時に自動検出し、ビルドを失敗させること	リンク切れの混入防止
FR-05	スマートフォンでも閲覧できること	レスポンシブ
FR-06	公開 URL でチームに共有できること	アクセス制限は段階導入（リリース計画書 Step3）

ID	要件	目標値
NFR-01	運用コスト	月額 0 円（ホスティング無料枠内）
NFR-02	ビルド時間	60 秒以内
NFR-03	学習コスト	md が書ければ増築できる。サイト生成ツールの知識を編集者に要求しない
NFR-04	セットアップ時間	ゼロから公開まで半日以内
NFR-05	可搬性	正本が md のため、生成ツールを将来乗り換えても資産が残ること

公開範囲の制約（最重要）

公開 URL（*.pages.dev）は誰でも閲覧可能。機密情報・実在の取引先名・個人情報は置かない（リリース計画書の公開前チェックリストで担保）。

テスト計画書に定める T-01〜T-06 がすべて合格であること。

版	日付	変更内容
1.0	2026-06-12	初版作成