Repository navigation
ReflectメモをローカルMDXへ移行する #16
Description
概要
Reflectで公開しているメモを棚卸しし、公開を継続する知識をcontent/docs/配下のMDXへ段階的に移行する。
公開コンテンツはMDX/Gitをマスターとし、Reflectはメモ・収集・下書きに限定する。移行時は原文の構造、語調、情報量を維持し、AIによる不要な加筆はしない。
現状
2026-10-09時点のcontent/docs/には、Reflectへの参照が145箇所、固有URLが136件ある。
content/docs/index.mdx: 134件content/docs/uses.mdx: 8件（index.mdxとの重複を含む）- 移行済みMDXの出典リンク: 2件
- その他の本文内リンク: 1件
index.mdx内の内訳:
| カテゴリ | 件数 |
|---|---|
| AI & Machine Learning | 11 |
| Development & Tools | 76 |
| Writing | 1 |
| Creating | 6 |
| Workflow & Productivity | 10 |
| Philosophy & Design | 6 |
| Knowledge Management | 10 |
| Photography | 8 |
| Life & Interests | 6 |
| 合計 | 134 |
ゴール
- 公開を継続するReflectメモがローカルMDXで閲覧できる
index.mdxとuses.mdxのナビゲーションがローカルリンクを参照する- 新しい公開コンテンツをReflect URLへ直接追加しない運用に切り替える
- 移行対象外のリンクも判断理由を残し、未判断のReflectリンクをなくす
対象外
- Reflect上の非公開メモ、日次メモ、未完成の下書きの全量移行
- 移行時の内容拡張や全面的なリライト
- 外部サービス上の一次コンテンツをローカルへ複製すること
移行方針
各リンクを次のいずれかに分類する。
- 移行: 独立した公開知識として
content/docs/<category>-<slug>.mdxを作る - 統合: 短いメモや重複内容を既存ページまたはCollectionへ追記する
- 外部リンク化: 内容の本体が公式ドキュメントなどにあり、ローカル化する価値が低い場合は一次情報へ差し替える
- 削除: 古い、重複している、公開価値がない、またはリンク切れの項目を取り除く
- Reflect継続: 日次メモ、断片的なアイデア、更新中の調査など、公開MDXへ昇格させずReflectで管理する。
index.mdxなど公開ナビゲーションからは外す - 保留: 内容を取得できないなど、判断材料が不足するもの。理由と再確認条件を記録する
優先順位は以下とする。
- 個人の思想・判断基準、現在も参照するワークフロー
- リンク切れ時の影響が大きい技術メモ、リファレンス
uses.mdxから参照される現役ツールのメモ- その他の短いTips、過去ツール、趣味メモ
実施計画
Phase 1: 棚卸しと基準確定
- Reflect固有URL 136件の管理表を作る
- 各項目にカテゴリ、移行判断、移行先、優先度、状態を付ける
- 重複参照と、すでにローカル化済みの項目を特定する
- 取得不能・非公開・リンク切れの項目を分離する
- Reflect継続候補を特定し、公開ナビゲーションから外す
- 1バッチあたり5〜15件を目安に子Issueへ分割する
管理表の最低限の項目:
| Title | Reflect URL | Category | Decision | Destination | Priority | Status |
|---|
Phase 2: 優先コンテンツの移行
- Philosophy & Design（6件）
- Workflow & Productivity（10件）
- AI & Machine Learning（11件）
- Development & Tools: Architecture / Best Practices / Claude Code（11件）
-
uses.mdxで参照中のメモ（重複を除いて確認）
Phase 3: 技術リファレンスの移行
- Development & Tools: Frontend & UI（17件）
- Development & Tools: Backend & Data（10件）
- Development & Tools: TypeScript / JavaScript / Schema（6件）
- Development & Tools: Cloud / Development Environment（16件）
- Development & Tools: Build / Analytics（9件）
- Development & Tools: Knowledge / Payment（7件）
Phase 4: その他カテゴリの移行
- Knowledge Management（10件）
- Photography（8件）
- Creating / Writing（7件）
- Life & Interests（6件）
Phase 5: ナビゲーションと運用の切り替え
- 移行・統合した項目を
index.mdxのローカルリンクへ差し替える -
uses.mdxなど本文中の重複参照もローカルリンクへ差し替える -
index.mdxのdescriptionと本文からReflect連携を前提とする表現を更新する -
rg 'https://reflect\.site/' content/docsで残存リンクを確認し、意図した出典リンク以外を解消する -
bun run buildを実行する - 新規公開コンテンツはMDXへ追加する運用をドキュメントに反映する
1メモの移行手順
- Reflectページの最新内容を取得する
- 「移行・統合・外部リンク化・削除・Reflect継続・保留」を判断する
- 移行する場合はカテゴリプレフィックス付きのMDXを
content/docs/直下に作る titleとdescriptionをfrontmatterへ設定し、本文見出しは##から始める- 原文を維持し、必要な体裁と一次情報のReferencesだけを補う
- 技術仕様を扱う場合は公式ドキュメントの原文を確認する
index.mdxまたは既存Collectionからローカルページへリンクする- 個人の思想・判断基準を示すページだけ
meta.jsonのサイドバー候補とする - ビルドでMDXとリンクを検証する
子Issueの完了条件
- 対象項目すべての移行判断が記録されている
- 移行対象のMDXとローカルリンクが追加されている
- 統合・外部リンク化・削除・Reflect継続・保留の理由がPRまたはIssueに残っている
- 対象範囲に意図しないReflectナビゲーションリンクが残っていない
bun run buildが成功する- PR本文からこのUmbrella Issueと対応する子Issueを参照している
全体の完了条件
- 固有URL 136件すべての判断が完了している
- 公開継続対象がMDX/Git管理になっている
-
index.mdxとuses.mdxに未判断のReflectリンクがない - Reflect継続と判断した項目が公開ナビゲーションから外れている
- 残存するReflectリンクが出典用途として明示されている
- サイト内検索で移行コンテンツを検索できる
- プロダクションビルドが成功する
Activity
fix(content): shorten truncated descriptions of migrated pages
nitaking commentedon Oct 9, 2026
Phase 1 管理表（PR #17 での最終判断）
bun run build成功全136件の判断一覧
nitaking commentedon Oct 9, 2026
サイドバー判断（手順8）の記録
「このページは『なぜこうするか』を語っているか」で、思想系の候補5件を本文で確認した結果。
子Issue分割について
5〜15件ごとの分割は「目安」とされているが、全件を一括変換で処理して PR #17 に集約したため、子Issueは作成していない。分割が必要なら指示をください。
fix(content): restore PDF attachment of Claude Code privacy policy note
fix(content): withhold video tool notes and risky items from publication
nitaking commentedon Oct 9, 2026
公開見送り（公開前レビュー後の判断変更）
新規ファイル全件（MDX 74件、画像19枚、PDF 1件）を公開前レビューし、以下はMDXに含めない判断に変更した。Reflect上のページは変更していない。先の管理表のうち該当項目は「削除（公開見送り）」として読み替える。
creating-aquastalk/creating-voicebox-nemo/creating-final-cut-pro/workflow-mac-zundamon-yukkuri-videoshort-notesの AI Agent Shorts Video Workflow・PSDTool・DaVinci Resolve・Final Cut Pro // FCP・Voicevox の 調声ai-deep-research-best-practicephotography-shutter-speedtech-claude-code-privacy-policy、life-carbo-loadingtech-claude-code-knowledge-structure、tech-list-bordershort-notesの Tips ProxySQLindex.mdxの該当リンクも削除し、空になった Creating 節を削除short-notes.mdx自体を数えた誤りで、正しくは 73件（新規ファイルが74件）bun run build成功。PR #17 に反映済みnitaking commentedon Oct 9, 2026
方針変更: 公開知識として成立するものだけをMDXにする
「全件をMDXへ」から、「自分の判断・経験が書かれたもの、または再利用できるコードや設定を含むものだけをMDXにし、手軽なメモはReflectに残す」へ変更した。
content/docs/<prefix>-<slug>.mdxindex.mdxは元のReflect URLへリンクtech-online-ddl-mysqlへ差し替え合計 134件。出典として残す移行済み2件（
tech-commit-message、tech-go-goroutine-patterns）を加えて固有URL 136件。tech-tinylyticstech-slidertech-design-doctech-twelve-factor-apptech-terraform-awstech-raycastai-agentai-search-engineai-toolsai-prompt-engineeringphilosophy-network-effectsknowledge-crystallized-intelligencetech-bun-vs-pnpm-security-tradeoffs-2026tech-list-bordertech-tinybirdworkflow-how-to-create-chart-per-deck-themeworkflow-sprint-review-retrospective-englishphilosophy-cathedral-effectshort-notes.mdxは廃止CLAUDE.mdに「MDXへ移行しないもの」の基準を追加bun run build成功refactor(content): keep quick memos on Reflect and migrate only stand…
feat(content): migrate published Reflect notes to local MDX