4
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

GitHub Projects移行のリアル - Zenhubの機能をどう置き換え、何を諦めたか

4
Posted at

なぜ移行したのか

2025年の夏、Zenhub のライセンス更新時期が迫っていました。 以前からコストや運用の二重管理が課題になっており、部長から「GitHub Projects に完全移行できないか」と各部署に打診がありました。

普段 Issue やソースコードは GitHub で管理しているため、ここが変わることはありません。しかし、Zenhub は便利な反面、以下の課題がありました。

  • コスト: メンバー1人ずつにライセンス費用がかかる
  • 使い勝手: 別ツールのため同期ズレが発生したり、どちらの機能か(GitHub側かZenhub側か)混乱することがある

GitHub Projects に集約できれば、ツール管理の手間もコストも削減できます。私が所属しているデザイングループでも、移行に向けた検討を開始しました。

移行前の体制

  • チーム体制:デザイナー4名、フロントエンジニア1名
  • スクラム:1スプリントあたり2週間
  • Issue管理:GitHub
  • スクラム管理:Zenhub

Zenhub から GitHub Projects への移行には課題もありました。

私たちのチームでは、複数のリポジトリでIssueを管理していたので、それらを一元管理できるのか。
また、スクラムの振り返りに必要なデータや、カンバンの管理を継続できるのか、といった点が懸念でした。

このあたりを整理し、検証する必要がありました。

移行後の体制

  • チーム体制:デザイナー4名、フロントエンジニア1名
  • スクラム:1スプリントあたり2週間
  • Issue管理:GitHub
  • スクラム管理:GitHub Projects

Zenhub で活用していたツール

  • Work Tracker
    • いわゆるカンバンボードです
    • 私たちのチームに合わせて、カンバンボードの Status は加工していました
  • Estimate
    • 各Issueのポイント管理です
  • Epic
    • Timeline と合わせて、ロードマップとして活用していました
  • Sprint burndown
    • スプリント内で Issue を消化するために、朝会で毎日ペースを確認していました
  • Team Velocity
    • チーム全体の調子を見通したり、誰がどのくらいの Issue をCloseしているのか見ていました
  • Lead / Cycle Time
    • スクラムでコントロールチャートのうち、サイクルタイムとチームのパフォーマンスを評価するために利用していました
    • Estimate に対して、着手からCloseまでにどのぐらいの日数をかけているのか見ていました

GitHub Projects で置き換えた方法

基本的にはGitHub Projects にデフォルトで備わっている機能だけで実現する方法を考えました。

  • Work Tracker
    • GitHub Projects の Board
  • Estimate
    • Custom fields に Estimate というフィールドを追加
  • Epic
    • Parent Issue と Epic という Labelの併用
  • Sprint burndown
    • Insights の Burnup を sprint:@current に絞った Custom charts を追加
  • Team Velocity
    • Insights の Custom charts を追加
  • Lead / Cycle Time
    • Custom fields に Work Days というフィールドを追加し、手動で記録

Work Tracker

GitHub Projects の Board view を使うことにしました。
私たちのチームでは複数リポジトリで Issue を管理していますが、Workflows の Auto-add sub-issues to project を活用して、Issue が新規作成されたら、 New Issue の Status に自動で取り込むように設定しました。

他にもWorkflows の設定で、 Auto-close issue を活用して、Closeした Issue を Close Status に移動するよう設定しました。

また、対応期日が近かったり、優先度が高い Issue であるとわかるように設定を追加しました。
まず、Custom fields に Issue の対応希望日を設定。
優先度を上げる条件を Type に設定。
最後に、Board の Sort 機能で、ある程度自動で並び替わるように設定しました。

実際のプロジェクトはお見せできませんが、Sort機能の設定画面は以下のようになっています。

image.png
引用:GitHub ドキュメント

Estimate

Custom fields に Estimate という Number(数値) フィールドを追加して、合計値の計算もできるようにしました。

Epic

GitHub の Parent Issue を活用することにしました。
Epic という Label もつけることで、GitHub Projects の Roadmap view に Epic を並べて、並走するプロジェクトの管理をすることにしました

image.png
引用:GitHub Blog

条件に is:open label:Epic を設定して、現在動いているプロジェクトを確認できるようにしました。
label:Epic だけにすれば、いつでも Close したプロジェクトも確認できます。

Parent Issue は 100 Issue までしか Sub-issues を紐づけられないので、超えるようなことがあれば、Epicの期間や粒度を調整していけたらと思っています。

Sprint burndown

Zenhubは「Burndown(消化してゼロに向かう)」というUIでしたが、GitHub Projects の Insights では 「Burnup(積み上げて完了に向かう)」がありました。

image.png
引用:GitHub ドキュメント

Burndownの再現は、別ツールなどを活用すれば実現できそうだということはわかりました。
しかし私たちのスクラム管理としては、スプリント内で Issue を消化するために、朝会で毎日 Issue の消化ペースを確認できれば、目的は達成できます。

sprint:@current に絞った Custom charts を追加することで、現在のスプリントだけに状況を絞ることができました。

以上のことから、積み上がっていくグラフでも問題ないと判断し、Burnup で管理することにしました。

Team Velocity

Insights の Custom charts に対し下記の設定をしました。

  • X軸:スプリント
  • Y軸:Estimateの合計値
  • Group by (optional):Assignee

最後に書く予定ですが…
Issueを Close してから、一定期間経ったら、Issue を Archive する Workflows を試していたので、お見せできる量があまり残っていません。
ただ、Zenhub でやっていたように、Sprint ごとの消化ポイント数と、メンバーごとの内訳を確認できるようにしました。

スプリントごとの消化ポイントとメンバーごとの内訳が表示されているInsights

また、現在のスプリントの状況が見える Custom charts も作成しました

  • X軸:カンバンボードのStatus
  • Y軸:Estimateの合計値
  • Group by (optional):Assignee
  • 条件に sprint:@current を追加

これによって、現在誰がどの Status にIssueを保持しているのかがわかるようになりました。

現在のスプリントの状況を見えるようにしたCustom charts

Lead / Cycle Time

着手からCloseまでにどのぐらいの日数がかかったのか自動で集計する方法は、GitHub Projects にありませんでした。
GitHub Actions などを活用すれば、自動で取得できそうでしたが、自動取得の仕組みを構築する工数をかけるよりは、手動運用でも良いので移行を優先しました。

移行後しばらくしてから、Custom fields に Work Days という Number(数値) フィールドを追加し、完了までにかかった日数を手動入力するようにしました。

この機能の代替手段は、現在も試行錯誤中です。

移行したメリット・デメリット

【メリット1】コスト削減

私たちのチームでは、GitHub Projects に移行できたので、5人分の Zenhub のライセンス費が浮きました。

【メリット2】Zenhub のアカウントを持っていなかったビジネスメンバーもデザイナーの動きが見やすくなった

これまでは、各リポジトリの Issue を個別に確認してもらったり、依頼の Issue を都度追加してもらったりしていました。
GitHub であれば、Qiita社では全社員にアカウントを配っているので、カンバンボードも見ることができるようになり、デザイナーの進捗や、依頼した Issue の進捗も見やすくなりました。

【メリット3】Board で複数の Issue を別の Status に一括移動できる

複数のIssueを Command または Shift で選択し、一括で移動できました。
ただ、Zenhub のように、自動で行えていた部分や、もっといろんな一括編集ができないのはデメリットでした。

【デメリット1】Board で複数の Issue を一括編集できない

例えば、Sprint をまとめて指定したいときに、一つずつの Issue を開いて、Sprintを設定する必要がありました。
ただ、GitHub Projects の Table であれば、一括編集ができたので、まとめて編集したくなるような要素で構成した Table も Board とは別に用意しました。
移行当初期待したGUIではありませんでしたが、Excelのように操作できるので、問題なく運用に乗せることができました。

【デメリット2】Issue の依存関係が作れない

移行当初は、Issue の Blocked や Blocking の依存関係が作れませんでした。
そのため、Parent Issueで順序を丁寧に管理するか、Issue本文に追記する方法を検討していました。

ですがタイミングよく、GitHub で機能がリリースされました。

IssueがBlockingされている様子
引用:GitHub Blog

まだまだ検討していること

Close したIssueが溜まり過ぎて、Issue の読み込みが遅くなってしまいました。
Close してから一定期間経ったら Archive する Workflows も適用してみたのですが、そうすると長期的な振り返りをしづらいことが最近わかりました。

一旦 Archive するのはやめる運用に戻しました。

この点はまだまだチームで検討していきたいと思っています。

終わりに

私たちのチームでも、まだまだ改善の余地はありますし、GitHub Projects自体が機能のアップデートがされています。
随時改善していきたいとおもいます。

この記事が誰かのお役に立てたら幸いです。

4
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
4
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?