こんにちは!開発チームのナレッジ管理や情報共有に、日々頭を悩ませていませんか?
「Confluenceを開いたはいいものの、どこに何があるのか分からない…」
「議事録が乱立して、必要な仕様書にたどり着くまでに3回はため息をつく」
「結局、Slackの過去ログを漁る羽目になる」
……もし、あなたが今こんな状態なら、安心してください。それはあなたのチームの頭が悪いわけでも、ドキュメントを書くスキルがないわけでもありません。単に「情報の置き場所(階層設計)のルール」が不在なだけなのです。
今回は、数々の現場で情報迷子を救ってきた私と一緒に、Confluenceを「誰もが迷わず、秒で目的の知見にたどり着く聖地」へと変貌させるためのツリー構造の極意を紐解いていきましょう。これをマスターすれば、チーム全体のベロシティ(開発速度)が劇的に向上しますよ。
—
1. なぜConfluenceは「ゴミ屋敷」になってしまうのか?
まず、敵を知ることから始めましょう。なぜConfluenceは放置するとすぐにカオスと化すのでしょうか?
その原因は、Confluenceが「あまりにも自由にページを作れてしまうから」です。
階層を意識せず、その場の勢いで「親ページなし」で新規ページを量産していくと、ツリー構造は平面的になり、やがて巨大なゴミ屋敷が完成します。
陥りがちな「ダメなツリー構造」の例
- スペースの直下に「2023年10月議事録」「新機能仕様書」「チームメンバー一覧」「ランチのお店」がフラットに並んでいる。
- 誰が何を書いたか分からない「メモ_v2_fix(1)」のような野良ページが放置されている。
情報整理の基本は、「人間が認知しやすいチャンク(塊)に情報を分割し、文脈(Context)のストーリーを持たせること」です。これをConfluenceのページツリー上で実現します。
—
2. 現場で即効性がある!黄金のツリー構造パターン
それでは、実際に現場で爆発的な効果を生んでいる「見やすく迷わないツリー構造」の具体的なパターンを見ていきましょう。
今回は、多くの開発チームが採用している「プロジェクト別+機能別」のハイブリッド型を紹介します。
📁 【00】スペースの歩き方(ポータル・メタ情報)
┣ 📄 このスペースについて(目的・スコープ)
┣ 📄 メンバー・連絡先一覧
┗ 📄 運用ルール(命名規則など)
📁 【01】プロジェクト仕様・要件定義
┣ 📁 プロジェクトA(新規決済機能)
┃ ┣ 📄 背景・ゴール(Why)
┃ ┣ 📄 要件定義書
┃ ┗ 📄 アーキテクチャ・DB設計
┗ 📁 プロジェクトB(既存改修)
📁 【02】開発プロセス・ナレッジ
┣ 📁 定例ミーティング(議事録)
┃ ┣ 📄 2023-10-15 定例MTG
┃ ┗ 📄 2023-10-22 定例MTG
┣ 📁 トラブルシューティング・知見集
┗ 📁 開発環境構築ガイド
📁 【99】アーカイブ(過去の遺物)
この構造の美しいポイントを解説します。
1. プレフィックス(番号)で並び順を制御する
Confluenceのデフォルトのソート(アルファベット順や作成順)は、人間の重要度の感覚と一致しません。フォルダ名やページ名の頭に `【00】` や `【01】` といった番号をつけることで、読ませたい順番に強制的にコントロールできます。
2. メタ情報(スペースの歩き方)を最上部に置く
新しくチームに参加したメンバーが、最初にどこを見るべきかを迷わせないための「玄関口」を作ります。
3. 「今動いているもの」と「過去の遺物」を明確に分離する
終わったプロジェクトの資料が検索結果にノイズとして混ざらないよう、`【99】アーカイブ`行きを作るのが、知見の鮮度を保つ最大のコツです。
—
3. 事故を防ぐ!絶対に守るべき「命名規則」のルール
構造が綺麗になっても、中のページ名がバラバラだと、結局は検索迷子になります。以下の3つのルールをチームで合意しましょう。
ルール①:議事録は「YYYY-MM-DD_タイトル」で統一する
- NG例: 「今日の定例」「MTG議事録」「佐藤さんとの話」
- OK例: 「`2023-10-25_決済API連携についての壁打ち`」
- 理由: 時系列でソートされやすくなり、いつの話題かが一目でわかります。さらに、Confluenceの「会議メモ」ブループリントを活用すれば、自動的にこのフォーマットに寄せやすくなります。
ルール②:ステータスをタイトルのプレフィックスに入れる
現在進行形のドキュメントなのか、すでに完了したものなのかをタイトルで表現します。
- `【下書き】`:執筆中。フィードバック歓迎。
- `【確定】`:レビューが完了し、チームの合意が取れたもの。
- `【凍結】`:議論がストップしているもの、または過去の仕様。
ルール③:「親ページ」のタイトルを動詞にしない
親ページ(フォルダ代わりになるページ)のタイトルは、名詞またはカテゴリー名にしてください。
- NG: 「仕様を決める」「会議をする」
- OK: 「要件定義ドキュメント」「定例ミーティング議事録」
—
4. チームにこの仕組みを定着させる「優しく知的な」アプローチ
ここまで読んだあなたは、「理屈は分かったけど、メンバーがルールを守ってくれるか心配……」と思っているかもしれません。
ここで、アジャイルコーチとしての極意を伝授します。ルールをドキュメントに書いて「守れ」と強制しても、絶対に失敗します。 人間は面倒くさいことが嫌いだからです。
チームに自然と綺麗なツリー構造を根付かせるには、以下のステップを踏んでください。
1. 「テンプレート」を仕込む
Confluenceの「ページテンプレート機能」を使い、先ほどの命名規則や推奨する見出し構造(背景、詳細、ネクストアクション等)をあらかじめセットしたテンプレートを作成します。「新規作成ボタンを押したら、勝手に綺麗な形から始まる」状態を作るのが最強のハックです。
2. 最初の1週間は、こっそり直して褒める
メンバーが変な階層にページを作ったら、怒るのではなく、サッと正しい親ページの下にドラッグ&ドロップで移動してあげましょう。「ここ、こっちの方が綺麗にまとまるから移動しておいたよ!」と軽く声をかけるだけで、その人は自然と正しい位置感覚を身につけていきます。
3. 「散らかり検知デー」を設ける
スプリントの振り返り(レトロスペクティブ)などのタイミングで、「今週のConfluence綺麗にしようぜタイム」を5分だけ取り、みんなで不要なページの削除や整理を行います。
—
まとめ:今日からできるファーストステップ
いかがだったでしょうか? Confluenceのページ階層設計は、単なる「お片付け」ではありません。それは、チームの思考の整理であり、情報のサイロ化を防ぐための最重要インフラです。
今日、あなたがオフィスデスクに戻ったら(あるいはリモートワークのPCを開いたら)、まずは以下のタスクを一つだけ実行してみてください。
> 【今日のToDo】
> 今関わっているプロジェクトのスペースを開き、一番上に `【00】このスペースの歩き方` というページを1枚だけ作ってみてください。そこに「このスペースの目的」と「主要なページへのリンク」を貼るだけで、あなたのチームの迷子は劇的に減ります。
これをマスターすれば、毎日の作業や情報のキャッチアップが劇的に楽になりますよ。
さあ、今すぐ美しいツリー構造の世界へ一歩を踏み出しましょう!