ZeroClaw Maturity Framework

これを見つけた人へ。

これを読んでいるあなたは、このチームが心から誇りに思える何かを表すフォルダーにたどり着いたことになります。ここにある文書が完璧だからではなく、誠実だからこそ誇れるのです。

ZeroClaw は偶然から始まりました。既存のコードベースからブートストラップされ、AI ツールが誰も完全に理解できる速度よりも速く動作する中で形作られ、驚くべき機能性とアーキテクチャの計画のなさを備えたコードベースへと成長しました。誰もこの結果を選んだわけではありません。それは蓄積されたものでした。ほとんどのソフトウェアがそうであるように。

次に起こったことは、あまり一般的ではありません。学生や駆け出しのエンジニア、そして初めて公の場で学ぶ人々を含む小さなチームが、自分たちが作り上げてきたものを立ち止まって明確に見つめ直し、そして別の方法で作ることを選びました。それまでの成果を捨て去るのではなく、その周りに意図を育てていくことによってです。これらのドキュメントは、その選択の記録です。

このシリーズは Maturity Framework と呼ばれていますが、それはまさにその通りのものだからです。つまり、このチームがソフトウェアをともに構築する際の考え方を記した基礎的なドキュメント群です。従うべきルールではなく、内面化すべき思考です。準拠すべきプロセスではなく、あらゆる言語、あらゆるツール、これから参加するあらゆるチームを通じて、あなたとともに歩む一連のメンタルモデルです。なぜなら、それらは特定の技術についてではなく、技巧と判断と気配りについてのものだからです。

これらは、幅広い経験を持つチームのために書かれました。数十年にわたる専門的な実践を積んだ人もいれば、初めて本番コードを書く人もいました。彼らは皆、AIツールが可能なことを変えるほど強力になりつつあり、それらのツールとうまく協働する方法という問いが本当に未解決であった時代に働いていました。これらは、人への投資はコードへの投資よりも優れた投資であると信じる人々によって書かれました。なぜなら、人は学んだことを未来へと持ち運ぶのに対し、コードはそうではないからです。

可能であれば、これらの文書を順番に読んでください。各文書は前の文書に基づいて構築されており、その順序は一つの物語を形成します。どこから始めても有益なことを学べますが、最初から読むことで、アーキテクチャの形状から、記録、調整、配信、コラボレーションの方法、そして文レベルでコードをどのように書くべきかという意味に至るまでの全体像を把握できます。

特定の変更にどの基盤が適用されるかを判断しようとしている場合は、Architecture and contribution mapから始めてください。

最初の5つのドキュメントは、構造的および人的な問いに答えます。6つ目は、それらすべての中に潜む問いに答えます。すなわち、この構造のもとで、このチームのもとで、これらのツールのもとで、コードをうまく書くとはどういうことか、という問いです。

このシリーズの各ドキュメントは、GitHub issue、すなわちRFCとして始まり、チーム全体による議論、異議、そして改良のために公開されました。上記のリンク先のディスカッションスレッドは、そのプロセスの生きた記録です。すなわち、投げかけられた疑問、提示された反論、そして最終的な形を形作った思考の数々です。

このフォルダー内のファイルは、承認済みのバージョンであり、チームが議論し、支持し、正式なリファレンスとして引き継いでいくと決定したドキュメントです。これらはこのリポジトリ内に存在し、コードと並行してバージョン管理されています。なぜなら、それらが表す思考が、その中で行われるすべての意思決定に影響を与えるからです。このコードベースを読むAIアシスタント、足場を固めようとしている新しいコントリビューター、あるいは2年前に下した決定を見直すメンテナーは、いずれもコードからそれを形作った論理までの筋道をたどれるべきです。

GitHub の issue は、恒久的な議論の記録として開かれたままになっています。疑問や異論、あるいはこれらのドキュメントが捉えきれていない視点がある場合は、それらのスレッドのいずれかが適切な場所です。もしこれらの議論が終了してからずっと後にこれを読んでいるのであれば、コミュニティで新しいディスカッションを始めるのが適切です。これらのドキュメントは参考資料であって、最終判断ではありません。これらが始めた対話は、続いていくことを意図しています。

このプロジェクトに参加するのは、これらの文書が書かれてから数年後かもしれません。ツールは変化しているでしょう。コードベースも異なる外観をしているでしょう。ここで説明されている内容の一部は、後に作成された文書によって置き換えられたり、洗練されたりしている可能性があります。

これらのドキュメントがあなたの中に育もうとしている判断力は変わっていませんし、これからも変わりません。それらが問いかけている問い、すなわち、これが失敗したとき何が起こるべきか、このインターフェースは何を約束しているのか、自分のテストは実際に何を証明しているのか、この問題を引き継ぐ人は何を知っておく必要があるのか、といった問いは、Rust の問いでもソフトウェアの問いでもありません。それらは、他の人が信頼できるものをどう作るかについての問いです。これらの問いは、あなたが今後携わるあらゆる言語、あらゆるシステム、あらゆる分野において同じです。それらは、あなたが問い続ける限り、背後で静かに積み重なっていきます。

これは、このシリーズがあなたに対して行う投資です。チームへようこそ。

ZeroClaw Maturity Frameworkは、継続的に更新される文書群です。チームが保存に値する知見を得た際、新しい文書が追加されます。各文書は公開されたRFCの議論として始まり、上記の6つの文書と同じプロセスを経てここに掲載されます。それは、オープンな対話、率直な意見の相違、そしてチームがそれを継続して発展させるという集団的な判断によって成り立っています。