こんにちは！今日から新しいチームで開発を始める君へ、先輩からとっておきの秘密兵器を授けよう。
新しいプロジェクトに参加したとき、こんな絶望感を味わったことはないかい？
- 「あの仕様書、どこに保存されてるんだ……？」
- 「議事録を探したけど、チャットの流れる海に消えてしまった」
- 「同じ質問を何度も Slack で聞くのが申し訳ない……」
情報のサイロ化（孤立）は、開発チームのベロシティ（開発速度）を殺す最大の癌だ。これを一刀両断するために、世界中の優秀なアジャイルチームがこぞって採用している聖域、それが Confluence（コンフルエンス） だ。
今日は、単なるツールの使い方のおさらいじゃない。「なぜ Confluence なのか」「どう使えばチームが劇的に楽になるのか」という本質を、優しく、かつ徹底的に叩き込んでいこう。
—
1. Confluenceとは何か？（本質を理解する）
一言で言えば、Confluence は「チームの脳みそをクラウド上にそのまま複製するシステム」だ。
よくあるファイルサーバー（GoogleドライブやOneDriveなど）は、いわば「書類の倉庫」。フォルダの奥深くにファイルが放り込まれ、誰も見なくなっていく。
一方、Confluence は「リビングルームのホワイトボード」に近い。誰もが自由に書き込み、リンクし、議論し、そして常に最新情報にアップデートされていく。
Jira（ジラ）を開発しているAtlassian（アトラシアン）社が提供しているため、タスク管理とドキュメントがシームレスに繋がるのが最大の特徴だ。
—
2. なぜ導入するのか？ 開発チームが得る3つの圧倒的メリット
「また新しいツールを覚えなきゃいけないの？」なんて思わないでほしい。これを導入することで、君の毎日のストレスは8割削減される。
① 「情報迷子」からの完全なる解放
検索機能が異次元に優秀だ。タイトルだけでなく、ページ内のテキストや添付ファイルの中身まで一瞬でヒットする。「あれどこだっけ？」とチャットで先輩を捕まえる時間がゼロになる。
② 変更履歴（バージョン管理）の透明性
誰が、いつ、どの行を書き換えたのかがすべて履歴として残る。「昨日まで動いていた仕様が、なんで変わったんだ！？」という不毛な犯人探しが不要になり、Gitのコミットログのようにドキュメントの歴史を追える。
③ 開発の文脈（Context）が残る
コード（GitHub）やタスク（Jira）の裏にある「なぜこの仕様にしたのか」という背景（Context）をドキュメントとして残せる。半年後の自分が「なんでこんな実装したんだ……？」と頭を抱える悲劇を防げるのだ。
—
3. まずこれだけ覚えろ！ 必須の基本機能
Confluence にログインしたら、圧倒的な白紙のキャンバスに戸惑うかもしれない。だが、最初は以下の3つだけマスターすれば十分だ。
- スペース（Space）：
プロジェクトやチームごとの「部屋」。例えば「フロントエンド開発チーム」「全社ナレッジ」のように切り分ける。
- ページ（Page）：
スペースの中に作る「ノートの1ページ」。これが階層構造（ツリー構造）を持たせられるのがミソで、親ページの下に子ページをぶら下げることで、美しいドキュメント構造を作れる。
- マクロ（Macros）：
ページをリッチにする魔法のパーツ。例えば、`/table` で美しい表を作ったり、`/jira` で特定のタスクの進捗状況をリアルタイムで埋め込んだりできる。
—
4. 【実践】今日から始める！ 最初のセットアップと「HelloWorld」ページ
百聞は一見に如かず。実際に手を動かして、チームで共有するための美しい「HelloWorldページ」を作ってみよう。
ステップ1：スペースの作成
1. Confluenceのホーム画面から 「スペースを作成」 をクリック。
2. テンプレートとして 「ソフトウェア・プロジェクト」 または 「チームのスペース」 を選択。
3. スペース名（例: `🚀 Rookie Project`）とキー（URLに使われるスラッグ、例: `ROOKIE`）を入力して作成。
ステップ2：構成美が光るページの作成（HelloWorld的実践）
スペースができたら、右上の 「作成（Create）」 ボタンを押す。
以下のような構成で、チームの「キックオフ仕様書」を書いてみよう。
🚀 開発プロジェクト・キックオフ仕様書
> ステータス: 🟢 進行中
> 作成日: 202X-XX-XX
> 担当者: @YourName
1. このプロジェクトの目的（Why）
私たちは、情報のサイロ化を破壊し、開発チームのベロシティを限界突破させるためにこのシステムを構築します。
2. アーキテクチャ概要
- フロントエンド: Next.js (TypeScript)
- バックエンド: Go (Echo)
- ドキュメント管理: Confluence (いまここ！)
3. チームの約束事（マナー）
- チャットで解決した重要な意思決定は、必ずこのConfluenceに言語化して残す。
- ページの構造はツリービューで整理し、階層を深くしすぎない（最大3階層まで）。
- アイディア段階のメモは「下書き（Draft）」状態を活用する。
これだけで、チーム全員がアクセスできる「生きた仕様書」の第一歩が完成だ。これを公開（Publish）しよう。
—
5. 【極意】Slack連携で「情報の血流」を爆速化する
ここからが本番だ。Confluenceを「開くだけの場所」にしてはいけない。君たちが普段使っているSlackへ、Confluenceの動きを自動で流し込むことで、チームの血流を良くするのだ。
Slack連携を完了させると、以下のような未来が手に入る。
- 誰かが重要な仕様書を更新したら、対応するSlackチャンネルに通知が飛ぶ。
- Slackの会話から、ワンクリックでConfluenceのページを作成できる。
Slack連携の設定手順
1. Confluence側でのアプリ追加
- スペースの設定（またはグローバル設定）から 「アプリ（Apps）」 ＞ 「アプリを探す」 を開く。
- 「Slack」で検索し、Slack integration for Confluence をインストールする。
2. Slackチャンネルとの紐付け
- 連携させたいSlackチャンネル（例: `#project-rookie-notify`）を開く。
- スラッシュコマンドを入力する：
/confluence connect [あなたのConfluenceドメイン]
- 画面の指示に従って認証を完了させる。
3. 通知ルールのカスタマイズ
- 「どのスペースの、どんなアクション（作成・更新・コメント）があったときに、どのSlackチャンネルに通知するか」を設定する。
- おすすめは、「主要なスペースのページ更新」を開発チャンネルに流すこと。これだけで、「あ、今あの仕様が更新されたんだな」とチーム全員がリアルタイムでキャッチアップできる。
—
先輩からの最後のメッセージ
ツールというものは、ただ導入しただけではゴミ箱と同じだ。「面倒くさい」「後で書こう」と思った瞬間から、チームの生産性は死んでいく。
でも、安心してほしい。今日紹介した基本のページ作成と、Slackへの通知設定さえマスターすれば、君のチームの情報共有は劇的に変わる。
「これをマスターすれば、毎日の作業が劇的に楽になりますよ」。
さあ、ブラウザを開いて、最初のスペースを作ってみよう。君の素晴らしい開発ライフの始まりだ！