goldBug
goldBug Project OS icon
goldBug Project OS
AI エージェントと働くためのルール公開

goldBug Project OS は、AI の協力者たちと一緒に働いても筋道を見失わないための、私のやり方です。アプリでも、二つ目のプロジェクト管理ツールでもありません。Markdown のリポジトリ——共有のエージェント指示、プロジェクトのライフサイクル、タスクの実行とレビューの手順書、そして各プロダクトリポジトリが最初にコピーするテンプレート。このページのすべてのプロジェクトが、このサイトも含めて、この上で動いています。公開リポジトリは非公開リポジトリを整理したスナップショットで、ルールそのものがプロダクトです。

ドキュメントリポジトリ · インストール不要
画面スワイプ →
リポジトリ
リポジトリ
手順書
手順書
レビュー手順
レビュー手順
PR テンプレート
PR テンプレート

作った理由

複数のエージェント——Claude、Codex、クラウドのセッション、ローカルのセッション——と同時に働くと、決まった形で失敗します。頼んでいないものを直す、二つのエージェントが同じファイルを触る、なぜそう決めたか誰も書いていないせいで決定が「修正」されてしまう。OS はそのひとつひとつに対する、書かれた答えです。ひとつの成果にひとつの issue、ひとつの issue にひとつのブランチ、検証表つきのドラフト PR、コードを書いていないエージェントによるレビュー、そして、そうしなければ偶然に見えてしまう選択を説明する決定ファイル。オープンソースにしたのは、ルールのほうが、その上に建てたどのプロジェクトよりも役に立つからです。

仕組み

  1. 01私が成果をひとことで承認する。
  2. 02エージェントがそれを、受け入れ条件とストップロスつきの、範囲の決まった GitHub issue にする。
  3. 03エージェントが自分のブランチで実装し、検証表つきのドラフト PR を開く。
  4. 04別のエージェントがタスク・差分・証拠をレビューし、所見を投稿する。
  5. 05私が重要な選択を決め、マージする。
  6. 06再利用できる学びは、別の pull request で OS に戻す。

使用技術

MARKDOWNGITHUB ISSUES & PULL REQUESTSGITHUB ACTIONSPYTHONBASHJQ

ロードマップ

  • ルール・手順書・テンプレートをひとつのバージョン管理されたリポジトリに——完了
  • 他のメンテナーも採用できる設定可能なプロファイル——完了
  • 整理した公開スナップショット——完了
  • 公開リポジトリのマスコットと README の更新

既知の制限

  • —ひとりのメンテナーと数体のエージェントのために書かれたもので、汎用のプロジェクト管理フレームワークではなく、そうなるつもりもありません。
  • —公開リポジトリはスナップショットです。非公開のプロジェクト登録簿とパイロット用プロファイルは含まれません。
  • —UI はなく、今後も作りません——GitHub リポジトリがプロダクトのすべてです。