サイドバー上部の歯車アイコンをクリックし、組織の設定ページへ遷移します。

インテグレーションを選択しインテグレーション可能なサービスよりGitHubを選択してください。

「有効にする」ボタンを押しますと新規ウィンドウでGitHubのページが開きますので連携したいワークスペースを選択し操作を進めます。

特定のリポジトリのみを選択したい場合はOnly select repositoriesを選択しSelect repositoriesから任意のリポジトリを選択します。

リポジトリアクセスを選択後「Install」ボタンを押します。

接続が完了するとCoadmapにリダイレクトされ接続されたGitHubの組織に接続中と表示されます。

プロジェクトにGitHubのリポジトリを連携するには、プロジェクトの「設定」→「外部リポジトリ連携」を開きます。

「リポジトリ追加」ボタンをクリックします。

追加したいリポジトリを選択し「追加」ボタンをクリックします。

追加が完了すると同期しているリポジトリ一覧に表示されます。

リポジトリ連携完了後、Issueが同期されタスクとして作成されます。

Issueから同期して作成されたタスクは本文やコメントも同期されます。

また、Issueとタスクが紐づいている場合、CoadmapでタスクをクローズするとIssueもクローズされます。

GitHub上でプルリクエストを作成時にCoadmapのタスクリンクを貼り付ける事でタスクとプルリクエストを同期することが可能になります。

タスクとプルリクエストが同期されるとプルリクエストのリンクやマージリクエストの欄が追加されます。

この状態でGitHubのプルリクエストにレビュワーを設定するとCoadmapのタスクは自動でレビュー中のタスクに移動します。

※ プルリクがマージされてもタスクは自動で終了したタスクには移動しません。

GitHub側の操作によってCoadmapとの連携が切れると、Issueの同期、プルリクエストの同期、CoadmapでタスクをクローズしたときのIssueクローズなど、GitHub連携の機能がすべて停止します。

連携が切れると、そのリポジトリを連携しているプロジェクトの画面上部に 「〇〇 の GitHub 連携が切れました」 という警告バナーが表示されます。

連携が切れる原因は2つあり、原因によって対処が異なります。

GitHubのCoadmap GitHub Appの設定を開き、Only select repositories の対象に該当リポジトリを再度追加してください（設定手順は「3. 用途に応じてリポジトリのアクセス設定を選択します」と同じです）。追加が完了すると、Coadmap側の連携は自動的に復旧し、警告バナーも自動で消えます。

※ この場合、Coadmap側での操作は必要ありません。

リポジトリの移転による連携切れは自動では復旧しません。以下の手順で接続し直してください。

警告バナーは右側の「×」から非表示にできます。クリックすると 「この警告を非表示にしますか？」 という確認モーダルが表示されるので、「非表示にする」をクリックします。

Tips

リポジトリの移転による警告（Case 2）は、GitHub側で元の組織に戻しても自動では解消されません。再接続が完了したら、警告バナーは手動で非表示にしてください。