Github Projectを使ってプロダクト全体の課題・進捗管理をやってしまおう

みなさんスクラムやアジャイルでスプリントやカンバンを管理するとき、どのようなツールを使っていますか？
私は、以前はJiraやTrello、Redmineあたりを仕事では使っていました。他にもBacklogやAsana、Notionも使ったことのある人もいるでしょう。

しかし、小さいチームの場合、開発はほぼGithubしかみない、ビジネスサイドもGithubで十分、Notionはドキュメントをまとめるだけにしたい（そもそも課金したくない）という様々な要因で、Github Projectsを使ったほうが色々助かるときも実はあるのです。

ということで、私のチームでのGithub Projectsの活用事例をご紹介します。

※基本的な使い方については、Qiitaの記事を参考にしていただけると助かります。

参考記事：

https://qiita.com/haganenoubik/items/55700919e2e5b127e166

## プロジェクト作成→カンバンを用意

アジャイルするために、まずは作業の可視化をします。
可視化にはカンバンがとても便利なのでGithub Projectの新規作成画面からカンバンのテンプレートを選んで作成してしまいましょう。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/d28a78f3-9a8e-3981-ef20-f2eb3355ea1b.png)

これだけでBacklog/Ready/In progress/In review/Doneというステータスのあるカンバンができました！


## タスクは全部Issue化

つぎに作業対象の課題を作成していきます。
課題はTODOであれバグであれ改善であれ、すべてをGithub Issuesとして作成しましょう。

Backlogの下部「+ Add item」を押すか、「Team items」タブをクリックし、そこのBacklog以下にある「+ Add item」で追加してみましょう。

![image.png](https://qiita-image-store.s3.ap-northeast-
1.amazonaws.com/0/11128/6639cbfe-ff47-0fa0-e13e-174b02391fdb.png)

こうして作成された課題のStatusはBacklogになっていると思います。Backlogが課題であふれると作業量の多さに気の引ける思いもしてしまうので、私はStatusを外してNo Statusの課題とし、それを増やしていくようにしています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/fe82274e-3c81-bfca-8ac0-3ca0bc309402.png)

作った課題は最初Draft状態として作成されます（上図の破線の丸がついているテスト課題がそれです）。
とりえあず課題を作成していって、あとから適切なIssueとしてConvertすることをおすすめします。
Convert対象はGithub Repository単位で選べます。戦略としては以下です。

1. 複数レポでプロダクトを管理している場合はそれぞれのIssueに変換する
2. IssueをまとめるだけのGithub Repositoryを作成し、そこで一括管理する

（１）は各レポジトリ別でIssueが管理できるので、開発チームが他チームの余計な作業タスクやIssueをいちいちフィルターせずに除外できるメリットがあります。
（２）はぱっと見た感じは規模のでかいカンバンになりがちですが、Github Issueは別レポジトリのIssueへリンクできるしPull Requestにも関連付けできるので、開発チームとしてはフィルタリングで好きなように見え方を変えることで気にせず取り組めます。
加えて、PMやビジネスサイドからみると1つのボードにすべてがまとまっていたほうがロードマップの整理や事業全体の可視化が楽になるので、私は（２）をおすすめします。
チーム個別のタスクは、各Appのレポジトリか別Projectsを作ってもらってそれと課題リンクさせるという方法もとれるため、拡張性にも優れています。

### 項目追加

カスタム項目が設定できるので、例えばカテゴリを追加してみましょう。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/e6cbb4c4-1341-66a6-0a57-b6eecaedaa3f.png)

上図のような感じで作っておけば、課題が1つのProjectにまとまっていてもどの組織（プロダクト）のタスクか判別しやすくなります。

これと似た項目に「Label」がありますが、これはGithub Issuesと関連づくので、Labelの追加は自由にさせず、承認制にすることが個人的好みです。（Jiraを触ったことのある人ならわかると思いますが、だいたい氾濫して似たようなタグが大量作成され収集つかなくなるやつです）

## 実装と関連付ける

課題を開くと右下に「Development」というものがあります。ここで既存のPullRequestやブランチと関連づけすることで、課題の実装状況を追うことが可能となります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/c2122115-f579-acf2-8404-a8505f6d4549.png)

この関連をつけておくと、ProjectのWorkflowにより、Pull RequestがCloseになったタイミングで課題もCloseされます。この挙動が地味に便利なので私はお気に入りです。

Workflowはデフォルトで設定されていますが、自分で好きに変更することも可能です。が、正直デフォルトでもかなり優秀なので、手の込んだWorkflow（外部サービスと連携したりメール・Slack通知したり）がなければそのままで良いと思います。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/ad421715-413a-bef4-18c6-2fe767abbf70.png)

## イテレーションの作成

スクラムやアジャイルをするときには、たいてい1スプリントや開発の期間を作成することになります。
しかし、初期では存在しないので手作業で作成する必要があります。

前述のカテゴリの作成のように、イテレーションを作成します。
例えば2週間単位でのイテレーションは以下のように作成できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/53e6b256-6a68-852c-bd1a-d98edfb05d26.png)

作成すると1、2、3までのイテレーションが作成されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/3cf58dee-38f5-3437-67a1-0c6c9e365b68.png)

あとは課題側で「この課題をいつどのイテレーションで実施するか」を割り当てしていく感じです。

注意点としては、このイテレーションは __自動では増えない__ のと __期日が来ても自動で次のイテレーションに切り替わらない__ という点があります。
例えばフィルターで「iteration:@current」と設定していると、設定日以降から急に課題が消えてしまって何がおきた？という状況になります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/63f52da9-bf7e-3995-06fc-972c27267f97.png)

なので、イテレーションを管理するための週次（隔週）定例か週次（隔週）タスクが必要になります。ただこれってスクラムで言うところのスプリントプランニングやリファインメントで代用可能なので、個人的にはフレームワークをチームの作業として強制させるという点では有益だなと思ってます。（忘れることも多いですが……）

## Insightsの活用

InsightsはチャートやグラフでProjectの状況を可視化することができます。
初期ではStatus chartしかありませんが、Iterationの計測も作れます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/ae1cf669-7d4e-731f-fb87-428e7cdcb8b0.png)

工夫は必要になりますが、ある程度の生産性や進捗管理に使うことは可能です。

## ロードマップも作成可能

事業側としては開発内部の進捗の管理は不要なので、Pull Requestとの連携やイテレーションの消化率などよりもロードマップを見て「リリース期日に間に合うか」を確認したいところです。
こちらはロードマップ画面を使えば可能です。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/cde51660-c378-a456-cb91-6994be15e04e.png)

ただし、通常の状態では上図のとおりガントチャートっぽく表示されるだけで味気ないですし、「期日いつだっけ？」とこの画面からは分かりません。そこで __「Milestone」__ の出番です。

### マイルストーンの設定

設定箇所が分かりづらいのですが、マイルストーンは各Github Repository単位で作成する必要があり、Github Projectからは作成できません。冒頭で私が「ProjectのIssueは全部1つのRepositoryでまとめたほうが良いです」と述べたのは、このマイルストーン機能の仕様にも関連しています。

早速作成してみましょう。
適当に課題を1つ別タブで開きます。課題選択後右上「...」からOpen in new tabをクリック。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/4646192c-a76c-757c-8bda-b583874f69b9.png)

開いた画面の左上「Issues」をクリック。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/8983b081-cd28-4a60-d53f-bce7f8220b3e.png)

そうすると課題一覧画面になります。そこに「Milestones」というボタン領域があるのでそこをクリック。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/84b474df-f82a-fb56-5b26-34693fe87830.png)

そして「New milestone」で新しいマイルストーンを作る感じになります。ややこしいですね！

Due Dateは予定日を入れてください。
DescriptionにはNotionやその他プロダクト・プロジェクトドキュメントへのリンクを貼っておくとよいでしょう。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/7ae122f0-7212-18a9-c225-269422803623.png)

マイルストーンの作成が完了したら、そのマイルストーン内で対応する課題について、Milestoneを設定します。Github Projectから課題を開けば、右下にその枠が存在します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/16dc0399-2ad4-cca1-1dab-d6df5ffc69e1.png)

その後、再度Roadmapタブで「Markers」をクリックし「Milestone」を選択すると緑色の縦線が表示されます。※何度やっても表示されない場合は一度画面をリロードしてサイドMarkersの選択からやり直してみてください。。。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/d3a1954b-50d4-52ca-9482-979163a10f47.png)

これで見通し良くなりましたね！

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/11128/2dada0f1-2713-7a5f-de1e-07822f2df534.png)


## まとめ

Github Projectは簡単に課題管理・プロダクト管理が可能です。
地味に便利ですしなんと無料なので、お金のないスタートアップにはとてもおすすめなツールだと思います！

### 良い点

- 簡単に始められる
- いろんなツールを行き来せずGithubでプロダクト管理が簡潔する
- 様々な組織を巻き込みやすい
- Githubレポジトリとの親和性が高い

### 手間な点

- 事業側もGithubアカウントが必要になる
- イテレーションの管理が手作業
- Insightsがちょっとさみしい（難しい）
- サービス連携が若干難しい

特にサービス連携についてはプラグインはありませんし、設定も少ないので、作り込みが必要になります。そのため他のツールと見劣りしてビジネスサイドから「スプレッドシートのほうがわかりやすいっすね」と言われかねない場合はあります。ミーティングやプロダクト開発のフレームワークでカバーするほうが良いかなと個人的には思います。