Workflow Catalog グループ

Workflow Catalog グループは、組織、グループ、プロジェクト全体で作成・キュレーション・共有可能なエージェント、ツール、フローのカタログである Workflow Catalog の開発に注力しています。

ビジョン

Workflow Catalog グループは、組織、グループ、プロジェクト全体で作成・キュレーション・共有可能なエージェント、ツール、フローのカタログである Workflow Catalog の開発に注力しています。

チームメンバー

エンジニアリングマネージャー ＆ エンジニア

チームメンバー情報は 原文 (英語) を参照してください。

連絡方法

文脈に応じて、Workflow Catalog グループに連絡する最も適切な方法は次のとおりです:

  • Slack チャンネル: #g_workflow_catalog
  • GitLab グループ @gitlab-org/ai-powered/workflow-catalog/engineering（エンジニアのみ）

取り組み中の作業

現在、私たちは Workflow Catalog の最初のイテレーション（MVP）に取り組んでいます。 この作業は MVP epic で追跡できます。

私たちの働き方

私たちはまだ始まったばかりで、新しいチームに馴染みながら働き方を定義していきます。 スタートのためのリンクをいくつか紹介します:

DRI

大きなプロジェクトに取り組むとき、それを Epic と Issue に分割します。 各 Epic の Directly Responsible Individual (DRI) は、そのドメインに対する単一のアカウンタビリティポイントとして機能します。 DRI が必ずしもすべての作業を行うわけではありませんが、自分の Epic の成功を所有します。

DRI の責任:

  1. Epic のステータス、スコープ、技術的決定について質問に答える
  2. 正確な Epic と Issue の説明を維持する
  3. デリバリーの健全性ステータスを監視・伝達する
  4. Issue リストをキュレーションする。必要なものを含め、不要なものを削除する
  5. デリバリー日と Issue ステータスを最新に保つ
  6. 作業が複数の Epic にまたがる場合、他の DRI と調整する

ヘルプリクエストの処理方法

カタログで顧客が問題に遭遇した場合、私たちのサポートチームは ヘルプリクエスト を起こします。 ヘルプリクエストを起こしたい場合は、その方法とタイミングについて この readme をお読みください。

チーム全体の注意を散漫にせずにヘルプリクエストをタイムリーに処理するため、各マイルストーンでゴールキーパーを指名します。 ゴールキーパーは、入ってくるリクエスト、質問、Issue がトリアージされ、適切な人またはチームに振り向けられることを保証する責任を持ちます。

各マイルストーンで新しいゴールキーパーをアサインし、ゴールキーピング Issue をオープンします。

詳細は Issue テンプレート で確認できます。

コミュニケーション

Workflow Catalog チームは以下のガイドラインに基づいてコミュニケーションを行います:

  • 同期ミーティングよりも非同期コミュニケーションを常に好みます。
  • 非同期で非効率な場合は 同期コール のアレンジをためらいません。ただし、必ず録画してチームメンバーと共有します。
  • デフォルトで公開の場でコミュニケーションします。
  • 仕事関連の Slack メッセージは、プライベートメッセージよりもパブリックチャンネル（#g_workflow_catalog）を好みます。

フロントエンドとバックエンドのコラボレーション

開発速度とコード品質を確保するため、フロントエンドとバックエンドのエンジニア間で高度なコラボレーションを促進することを目指します。

  • スキーマファースト開発: 実装が始まる前に、フロントエンドとバックエンドのエンジニアは、UI 要件、ユーザーエクスペリエンスのニーズ、パフォーマンスの考慮事項に基づいて GraphQL API スキーマを設計するために協働します。
  • 並行開発プロセス: スキーマが合意されたら、フロントエンドは合意されたスキーマに合うモックデータ、モックエンドポイント、API スタブを使って進められます。バックエンドはデータモデル、ビジネスロジック、実際の API スキーマの実装に集中できます。
  • 整合性の維持: 私たちは優れたコミュニケーションを大切にします。要件やスキーマを変更する必要があるときは、関連する GitLab Issue または #g_workflow_catalog を通じて早期にコミュニケーションし、フロントエンドまたはバックエンドのカウンターパートがすべての変更について情報を得て、後期のブロッカーを避けるためのフィードバックを早期に提供できるようにします。

AI ステージのコラボレーション

Workflow Catalog は、基盤バックエンドサービスとして Workflow Service に依存しています。 ほとんどの Workflow Catalog 機能では、Workflow Service 内で新しい機能を開発する必要があります。 そのため、私たちのエンジニアは Agent Foundations チーム と連携して、そのコードベースに直接貢献する必要があります。

コラボレーション要件:

  • すべての Workflow Service への貢献は、Agent Foundations チームと密接なパートナーシップで開発される必要があります
  • 私たちの実装は彼らのサービスアーキテクチャとビジョンに沿っている必要があります
  • 私たちは Workflow Service の幅広い目標をサポートし、彼らの技術基準に従うことをコミットします

コラボレーションプロセス:

  • 計画フェーズで、関連する Agent Foundations の連絡先（以下に記載）に連絡を取ります
  • 彼らの #g_duo-agent-platform チャンネルに参加します
  • デフォルトで 非同期コミュニケーション設定 に従いますが、必要に応じて同期ミーティングをスケジュールし、主要な成果が GitLab Issue に文書化されることを確認します

主な Agent Foundations の連絡先

チームメンバー専門分野
Mikołaj WawrzyniakWorkflow Service アーキテクチャ
Frédéric Capletteクライアントサイド実装
Dylan GriffithWorkflow Executor アーキテクチャ: リモート実行環境とランナー実装
Jessie Young認可と認証
Shekhar Patnaik / Igor DrozdovDuo Chat エージェント統合
Sebastian Rehmエンジニアリングマネージャー、上記いずれかのバックアップ連絡先

~Deliverable ラベル

~Deliverable ラベルは、チームが特定のマイルストーン内で提供することをコミットした Issue を識別するために使用されます。 このラベルは複数の目的を果たします:

  • コミットメントシグナル: ステークホルダーや顧客に、私たちがマイルストーンでこの作業を完了させる意図があることを伝えます
  • 優先順位付け: チームメンバーが最初に取り組むべき Issue を識別するのに役立ちます
  • フォーカス: イテレーションでどの作業が必須でどれが nice-to-have かを明確にします

誰がいつ適用するか

エンジニアリングマネージャーは、イテレーション開始前の計画プロセス中に ~Deliverable ラベルを適用します。 この決定は、プロダクトマネージャーと協働して以下に基づいて行われます:

  • イテレーションのチームキャパシティ
  • Issue の見積もりと複雑さ
  • 戦略的優先度と顧客コミットメント

優先順位付け

~Deliverable ラベル付きの Issue は、イテレーションの他の作業よりも優先されます。 チームメンバーは:

  1. まず、現在のイテレーションでアサインされた ~Deliverable Issue に取り組みます
  2. すべての ~Deliverable Issue が完了またはブロックされた場合、イテレーションの他の Issue を取り上げます
  3. 優先度が不明な場合、または ~Deliverable Issue を非優先化する必要がある場合は、エンジニアリングマネージャーに相談します

イテレーション中:

  • ~Deliverable Issue がブロックされた、または完了できない場合、#g_workflow_catalog または関連する Issue で早期にコミュニケーションします
  • エンジニアリングマネージャーは、変化する優先度やキャパシティに基づいて、イテレーション中に ~Deliverable ラベルを調整することがあります

私たちの技術スタック

チームミーティング

Workflow Catalog: グループミーティング

  • 時間: 毎週火曜、05:30 UTC と 15:00 UTC を週ごとに交互に切り替え。
  • 目的: このミーティングは、現在の Issue やブロッカーを取り上げる一般的な同期ミーティングとして機能します。
  • アジェンダ: Google Doc（内部のみ）
  • 録画: Google Drive（内部のみ）
最終更新 May 6, 2026: Merge pull request #100 from kyama0/fix/upload-images-tolerate-upstream-missing (70970e1a)
ページのソースコードを見る - ページの編集 - please contribute. Creative Commons License