チームの言葉へ昇格 — トラッカー・ウィキ・Git (5)

個人のメモやノートは自分しか読みません。チームが知るべき決定や手順は、イシュートラッカーやウィキ、リポジトリへ昇格させる必要があります。Tossの自動ドキュメント化、アーキテクチャ決定記録、GitLabハンドブック、GoogleとSpotifyのドキュメント文化、そしてドキュメント品質と成果の関係を扱ったDORA研究から見ていきます。記録型AI業務術シリーズ第5回。

AXAI変革協働ドキュメント化ナレッジマネジメント

私のメモリとノートは、結局、自分とAIだけが読みます。 同僚が知るべきことは、チームの言葉へ移してこそ、はじめて共有されます。

個人記録で止まると、チームと断絶する

前の回々で、ルール・メモリ・ノートを積み上げました。ところがこれは、すべて自分とAIだけが読む記録です。AIと長く働いて良い結論に至ったのに、それがイシュートラッカー・ウィキ・リポジトリに反映されなければ、同僚の立場からは、自分が何をしたのか確認する手立てがありません。個人記録で止まった瞬間、チームと断絶します。

だから必要なのが昇格です。デイリーノートで繰り返し参照される内容、同僚も知るべき手順・決定・結論を、チームのシステムへ上げます。

どこへ昇格するのか

  • イシュートラッカー(Jira・Redmine・OpenProjectなど) — 進捗・担当・期限。セッションの結果をチケットのコメントや添付として。ただし「完了」がすなわち「解決」ではないので、検証結果をコメントで残します。
  • ウィキ(Confluence・Notion・Outlineなど) — 手順書・設計決定・会議の結論といった正本。新規入社者も理解できる水準で、文脈を省略しません。
  • Gitリポジトリ — コード・スクリプトだけでなく、スキル・ルールファイル・設定も。複数のPCやチームメンバーで共有し、コミットメッセージがそのまま短い作業記録になります。

原則は一つ。**一つの情報は一か所にだけ原本を。**同じ内容を三か所に書けば、必ず食い違います。昇格した後は、個人メモリに原本をコピーせず、リンクだけを残します。

先を行くチームは、すでにこうしている

これは理想論ではなく、うまくいっている組織が実際に回している方法です。

  • Tossは、Slackでの議論を要約して文書リポジトリに自動で積み上げ、その文書がさらに社内ドキュメントチャットボットの学習データになるようにしました。記事のタイトルが象徴的です — Tossのフロントエンド開発者たちが、もう文書を探さなくなった理由。記録が積み上がったので、検索すら要らなくなったのです。
  • アーキテクチャ決定記録(ADR)は、ウィキではなくソース管理リポジトリに置け、というのがThoughtWorksの勧めです。記録がコードと一緒に動いてこそ食い違わないからです(ThoughtWorks Technology Radar)。
  • GitLabは、会社の運営方法すべてを公開ハンドブックに書く「ハンドブック・ファースト」文化で有名です。数千ページに及ぶこの文書が「私たちの働き方の唯一の信頼できる情報源」であり、個人が去っても残ります。
  • GoogleとSpotifyは、文書をコードのように扱うdocs-as-codeを定着させました。Googleは散らばったウィキの代わりにコードの隣のマークダウン(g3doc)を、Spotifyは開発者ポータルBackstageのTechDocsを使っています。国内ではLINEが、開発者向けドキュメントをGitHubに置いてdocs-as-codeで運用した事例を公開しました。

ドキュメント化はコストではなく増幅器である

「文書を書く時間があるなら仕事をもっとする」という反論があります。データは逆のことを語ります。GoogleのDORA研究は、内部ドキュメントの品質が良いチームほど同じ技術的プラクティスからはるかに大きな成果向上を得ることを、繰り返し確認しました。信頼性目標を達成する可能性は、ドキュメント品質が良いときに2倍以上高く、DORAは「品質の良いドキュメントが、私たちが研究したすべての技術的プラクティスの実行を牽引する」とまとめています。ドキュメントは、ほかのプラクティスの効果を増幅します。

逆に、記録がないときの損失は、先の第1回で見たとおりです。知識が個人だけに縛られていれば(Panopto調査では、組織の知識の42パーセントが1人にだけ存在していました)、その人が去る瞬間、まるごと消えます。

流れとして覚える

全体の流れは、こう整理できます。

デイリーノート → 繰り返されればメモリ → チームも知るべきならウィキ → 全員が毎回守るべきならルールファイル。

下へ行くほど、より多くの人が、より長く読みます。下書きはAIが作り、外部へ掲載する最後の確認は人が行います。

続く話

最後の回では、この体系を運用するうえで必ず出会う落とし穴と、一度に全部やろうとして疲れ果てないよう4週間に分けた導入ロードマップを整理します — 落とし穴と4週間の導入ロードマップ。

私たちのチームのツール(トラッカー・ウィキ・リポジトリ)にAIの記録をどうつなげるか、その見取り図が必要でしたら、お問い合わせからご連絡ください。


「AIを記憶する同僚として使う方法」シリーズ

  1. AIはなぜ昨日を忘れるのか — セッションの忘却とコンテキストコスト
  2. ルールは一か所に — AIルールファイルの書き方
  3. 一つのファイルに一つの事実 — AI自動メモリ
  4. 次のセッションの自分へ — デイリーノートと引き継ぎ
  5. チームの言葉へ昇格 — トラッカー・ウィキ・Git(現在の記事)
  6. 落とし穴と4週間の導入ロードマップ