Seeing decisions before code is written

初めてのUpstream Contribution - 失敗と学びの物語

CNCFOSSContributionLearning

はじめに

この記事は、私が初めてCNCFプロジェクトにコントリビューションを試みたときの経験を綴ったものです。

華やかな成功談ではありません。むしろ、失敗と戸惑いの連続でした。しかし、その経験こそが、Upstreamの意思決定プロセスを理解する上で最も重要な学びとなりました。

きっかけ

「Upstreamを理解したいなら、まず参加してみればいい」

誰かがそう言っていた気がします。しかし、実際に参加しようとすると、途端に壁にぶつかります。

  • どのプロジェクトに参加すればいいのか?
  • どのIssueから始めればいいのか?
  • そもそも、自分に貢献できることがあるのか?

最初の一歩

私が選んだのは、よく使っているツールの小さなドキュメント修正でした。

「これなら簡単だろう」

そう思っていました。しかし、PRを出した瞬間から、予想外の展開が始まりました。

💡 ビジネスフレームワーク: リーンスタートアップ

リーンスタートアップでは「仮説を立てる → 実験する → 学ぶ」のサイクルを重視します。Upstream活動も同じです。小さく始めて、フィードバックから学び、次のアクションを決める。完璧を目指すより、まず一歩踏み出すことが重要です。

意外な問題

提出したPRには、3日後に1つのコメントがつきました。

“Thanks for the contribution, but we need to discuss the terminology first. See #XXXX.”

参照先のIssueを見ると、2年前から続く用語の議論がありました。

私が「単純なtypo修正」だと思っていたことが、実はコミュニティで長年議論されている用語の標準化問題の一部だったのです。

気づき

この経験から、私は重要なことを学びました。

Upstreamには「些細な変更」は存在しない。

どんな小さな変更も、以下のような背景を持ちます:

  1. 過去の議論 - なぜ今の形になっているのか
  2. 複数のステークホルダー - その変更が誰に影響するか
  3. 将来への影響 - その変更が将来どう展開するか

💡 ビジネスフレームワーク: ステークホルダーマネジメント

ステークホルダーとは、プロジェクトに関わる全ての利害関係者のことです。Upstreamでは、ユーザー、開発者、企業、エコシステム全体が複雑に絡み合います。意思決定の前に「誰が影響を受けるか」を考えることが、合意形成の第一歩です。

その後

結局、私のPRはマージされませんでした。

しかし、そのプロセスで、以下のことを学びました:

  • Issueの読み方
  • 過去の議論の追跡方法
  • SIG/WGの存在と役割
  • 意思決定プロセスの複雑さ

「失敗」から得たもの

私のPRはマージされませんでしたが、これは「失敗」ではありませんでした。

むしろ、以下のことを体感できた貴重な経験でした:

1. Upstreamは「人」で動いている

コードやドキュメントの裏には、常に「人」がいます。 それぞれの意見、背景、経験があります。

2. 意思決定には時間がかかる

「正しい答え」があるわけではありません。 コミュニティ全体で合意形成をしながら進んでいきます。

3. コンテキストが全て

同じ変更でも、タイミングやコンテキストによって評価が変わります。 過去の議論を知ることが、最も重要なスキルです。

学び

この経験を通じて、私はUpstreamを見る視点が変わりました。

「なぜこのツールはこう設計されているのか?」

この問いに答えるためには、コードだけを見ていてはわかりません。

  • Issue
  • PR
  • Slack
  • Meeting Notes
  • Design Docs

これらすべてを追いかけて、初めて「意思決定の流れ」が見えてきます。

💡 ビジネスフレームワーク: 5 Whys(なぜを5回繰り返す)

トヨタ生産方式で使われる問題解決手法。「なぜ?」を繰り返すことで、表面的な症状から根本原因へ到達します。Upstreamを理解する際も、「なぜこの設計?」「なぜこの判断?」と問い続けることで、意思決定の本質が見えてきます。

まとめ

初めてのUpstream Contributionは、技術的な成功ではありませんでした。

しかし、以下のことを学べた、かけがえのない経験でした:

  • Upstreamの意思決定プロセスの複雑さ
  • コミュニティの文化と価値観
  • 「なぜ」を追いかけることの重要性

これが、Upstream Lensを始めるきっかけになりました。

あとがき

もしあなたがUpstreamに参加しようと考えているなら、小さなPRから始めてみてください。

マージされなくても構いません。 その過程で得られる学びこそが、最も価値のある「貢献」です。


この記事は、著者の個人的な経験に基づいています。