docs-handbook ドキュメント一覧

開発文書の書き方に関する個人ハンドブック。地図ビュー(要JS) / llms.txt

• 客先レビューのフロー — 何をいつ提示し、何を合意するか (書き方 / 2026-08-17) — 要求検証から検収までの6段レビューフロー。各段の提示物・判断・完了条件、プロトタイプの非契約明言、再承認の判定基準と2レーン運用 [md]
• 要件の種類と四層の対応 — ビジネス要件・業務要件・システム要件はどこに置くか (概念 / 2026-08-17) — ビジネス要件・業務要件・システム要件と四層の対応表。システム要件=設計という誤解の訂正と、非機能要件の置き場 [md]
• 要件定義書は業務領域単位で書く (書き方 / 2026-08-17) — 要件定義書の文書単位は業務領域。領域の定義(ゴール一文テスト)と却下した代替単位、サイズ目安と境界例 [md]
• 提案型案件の要求フェーズ (書き方 / 2026-08-17) — 受注側の提案から始まる案件で要求フェーズをどう運ぶか。資料の読み替え・検証面談・身分の立て直し [md]
• 要求フェーズの作成資料と情報項目 (書き方 / 2026-08-17) — 要求フェーズで作る5点の資料と各情報項目。受注側が仮説で埋めてヒアリングで検証する3ステップ運用 [md]
• 要件定義関連の蔵書 (その他 / 2026-08-16) — 手元にある要件定義・要求分析関連書籍の一覧。扱う要件の部類つき [md]
• DB関連の蔵書 (その他 / 2026-08-16) — 手元にあるDB関連書籍の一覧。所在・状態・性格のメモ [md]
• 用語定義の監査台帳（作業用） (その他 / 2026-08-16) — 全13回の用語定義監査（作業用）。初出位置・定義の有無・欠陥分類の台帳 [md]
• 用語集 (その他 / 2026-08-16) — 講座全体の用語集。回をまたいで繰り返し出る記法・関数・概念語を1行で引く [md]
• 講座修了後のロードマップ（DBの専門性をどう積むか） (その他 / 2026-08-15) — 全13回の先。公式ドキュメント通読・ミニDB実装・理論・意図的な破壊・他DB比較まで、実務外で積めるステップの地図 [md]
• オンボーディング文書に何を残すか (書き方 / 2026-08-15) — プロジェクト単位のオンボーディング文書に何を残すか。環境構築手順との置き場所の分け方 [md]
• DB性能検証の初期セットアップ (その他 / 2026-08-15) — プロジェクト初期に「遅さを検出する手段」を用意する。実行計画・クエリ数・効率比をどう判定に組むか [md]
• プランナと実行計画、EXPLAINをいつ使うか (その他 / 2026-08-15) — プランナとは何か、EXPLAINをいつ使うか。実行計画をアサートしてはいけない理由と、代わりに検証すべき回数・比率 [md]
• データベース・プロフェッショナル養成講座（PostgreSQL・全13回） (その他 / 2026-08-14) — 講座全体の索引。全13回の地図・共通データセット(PostShop)・修了判定をまとめた入口 [md]
• 第1回｜環境構築・エンコーディング/照合順序の初期決定事項 (その他 / 2026-08-14) — Dockerで PostgreSQL を立て教材データを投入。エンコーディング・照合順序という一方通行の初期決定 [md]
• 第2回｜関係モデルとは何だったのか (その他 / 2026-08-14) — テーブル＝集合。宣言的SQLへの頭の切り替えと、NULL・三値論理・SELECTの論理的評価順序 [md]
• 第3回｜SQL を書ききる (その他 / 2026-08-14) — JOIN・集約・サブクエリ・CTE・ウィンドウ関数で、アプリのループ処理を1クエリに寄せる [md]
• 第4回｜論理設計と正規化 (その他 / 2026-08-14) — ERと関数従属。正規形を「防いでいる更新異常」で理解し、非正規テーブルをBCNFまで分解する [md]
• 第5回｜データ型と制約設計 (その他 / 2026-08-14) — 金額・日時・列挙の型選定と、不整合をアプリでなくDBの制約で弾く設計 [md]
• 第6回｜実務のモデリング (その他 / 2026-08-14) — 履歴・有効期間(tstzrange+排他制約)・状態遷移・論理削除・非正規化の実務モデリング判断 [md]
• 第7回｜ストレージとインデックス＋照合順序の実害 (その他 / 2026-08-14) — ページ/B-tree/複合索引の列順と、照合順序が前方一致検索の索引に効く実害 [md]
• 第8回｜実行計画を読む（虫眼鏡） (その他 / 2026-08-14) — EXPLAIN (ANALYZE, BUFFERS) を読み、遅さの原因を統計情報とコストから言語化して改善する [md]
• 第9回｜トランザクションと並行制御 (その他 / 2026-08-14) — ACID・分離レベル・MVCC。ロストアップデートやデッドロックを再現して正しく防ぐ [md]
• 第10回｜権限・ロール・RLS・監査 (その他 / 2026-08-14) — 最小権限・行レベルセキュリティ(RLS)・監査。アプリのsuperuser接続からの卒業 [md]
• 第11回｜アプリとの境界＋インジェクション (その他 / 2026-08-14) — N+1・コネクションプール・長時間TxとSQLインジェクションを、境界で同時に防ぐ [md]
• 第12回｜運用＋pg_stat_statements（定点観測） (その他 / 2026-08-14) — バックアップ/PITR・無停止スキーマ変更・VACUUM・pg_stat_statementsによる遅いクエリの定点観測 [md]
• 第13回｜スケールと外の世界 (その他 / 2026-08-14) — レプリケーション・パーティション・OLTP/OLAP分離・NoSQL/ベクトルDBの選択基準を俯瞰する [md]
• 複雑と煩雑は違う (概念 / 2026-08-09) — 複雑性とは規模ではなく、結果が事後にしか分からないこと。設計が守る境界は煩雑系と複雑系の間にある [md]
• クネビンフレームワーク (概念 / 2026-08-09) — 明確系・煩雑系・複雑系・混沌系・無秩序の5領域と、領域ごとに変わる進め方・見積もり・決裁者。成熟度の段階ではない [md]
• 要求は何でできているか (概念 / 2026-08-09) — 背景・目的・成功基準・制約・スコープ外。5要素の役割と、埋まっているのに機能しない要求の見分け方 [md]
• 要求は誰のものか (概念 / 2026-08-09) — 顧客がいない案件で要求層に誰が座るか。合意事項と仮説という要求の身分を書き分ける [md]
• 層と粒度は別の軸である (概念 / 2026-08-08) — 層は誰が検証するかで切り、粒度は何を1件と数えるかで切る。直交する2つの軸 [md]
• Fish の線引き (概念 / 2026-08-08) — Fishをいつ立て、どの層に置くか。粒度の問いと層の問いを分けて判断する [md]
• コードから何が読めるか (概念 / 2026-08-08) — コードから復元できる層とできない層。要求だけが原理的に復元できない理由 [md]
• 層の越境パターン集 (概念 / 2026-08-08) — 層が静かに越境する15の型。下向きの先取りと上向きの追認を、症状と直し方で整理する [md]
• なぜ工程として必要なのか (概念 / 2026-08-08) — 層は判断の分離、工程はその並べ方。なぜ分けるのか、なぜ順序があるのか [md]
• 開発プロセスの全体像 (概念 / 2026-08-08) — 開発プロセス全体の見取り図。各工程が何を決め、何を残すか [md]