[🛠] 会社実務の記事を workstream 別の3階層カテゴリに分ける
✨ GPT-5.6 Solの要約
一つのカテゴリに混在していた会社実務の技術記録を workstream ごとの連続した物語に分け、パス・番号・ナビゲーション・旧URLをまとめて整理した記録。
会社実務のdevlogが増えるにつれ、一つのカテゴリに別々の物語が混ざり始めた。AI OrchestrationとOperations Automationでは作業の連続性も読む順序も違う。それでも両方をdevlog/company-workに置くと、タイトル番号が会社実務全体の番号なのか、プロジェクト別の番号なのかさえ曖昧だった。
devlog/company-work/<workstream>にパスと番号を固定する
記事のファイルパス、categories、permalinkを同じworkstream slugに合わせた。タイトル番号も会社実務全体ではなく、各workstreamの中で#1から続くようにした。
devlog/company-work/ai-orchestration
devlog/company-work/operations-automation
URLを見るだけでどの連続した物語に属するか分かり、別プロジェクトの番号も衝突しない。
一つのnavigation.ymlツリーからsidebarとモバイルメニューを描画する
以前、モバイルメニューとカテゴリoverviewを同じnavigation dataにつないだ。今回はそのツリーのcompany-work配下にworkstreamのchildrenをもう一段追加した。
sidebarとモバイルメニューは共通のcategory-nav-groups.htmlを使う。上位の会社実務archiveでは全workstreamの記事を集め、下位archiveではパス内の全categoryに一致する記事だけを残す。3階層構造を各ナビゲーションに複製していない。
旧2階層URLを生成redirectで保持する
カテゴリを移動すると、既存の/devlog/company-work/<記事>/リンクが壊れる。移動した各記事にredirect_fromを残し、Jekyll generatorが新しい3階層URLへ送る静的redirect pageを生成するようにした。不正な外部パスや競合するredirectはbuild前に失敗する。
workstreamのパス・番号・翻訳を一つの検査にまとめる
company_work:verifyは、workstreamが登録済みか、ファイルパスとcategoriesが一致するか、タイトル番号に欠番や重複がないか、active localeの翻訳も同じ構造かをまとめて検査する。
次の会社実務記事を書くときは、先にworkstreamを選べばよい。そうすればURL、archive、ナビゲーション、タイトル番号が同じ連続した物語を指す。
コメントする