Linear Issue起票で自動実装が始まる——AI開発の理想形

はじめに

「Issue作成したら、気づいたらPRができてた」

これが、AI時代のプロジェクト管理です。

Linear Issueを起票するだけで、AIが自動でコードを実装し、Pull Requestを作成する。人間がやるのは「何を作りたいか」を書くことと、最後のレビューだけ。

Linear + AI開発で、プロジェクト管理と開発が完全に統合されます。

なぜLinearなのか

Linearが選ばれる理由

Linearの特徴：
✅ 爆速（すべてキーボードで完結）
✅ API豊富（自動化しやすい）
✅ GitHub完全統合（開発ワークフローに最適）
✅ Webhook対応（イベント駆動の自動化）
✅ シンプル（必要な機能だけ）

他のツールとの比較

開発チームにとって、Linearは最も自然な選択です。

Linear Issue → AI実装の全体像

シンプルパターン（推奨）

LinearのGitHub統合だけで完結します。n8nは不要です。

高度なパターン（オプション）

n8nを使うケース：
- Linear Issue内容を加工・整形したい
- 他のツール（Slack、Notionなど）からもトリガーしたい
- 複雑な条件分岐が必要

所要時間

従来：
Issue作成 → 開発者がピックアップ → 実装 → PR作成
（数時間〜数日）

AI開発（Linear統合のみ）：
Issue作成 → 自動実装 → PR作成
（数分）

待ち時間がほぼゼロになります。

Linear Issueの書き方

良いIssueの例

タイトル：
ユーザープロフィール画面にアバター画像のアップロード機能を追加

説明：
## 要件
- ユーザーがプロフィール画面で画像をアップロードできる
- 画像サイズは最大5MBまで
- JPEG、PNG形式に対応
- アップロード後、即座にプレビュー表示

## 技術的制約
- 画像はS3に保存
- サムネイルは自動生成（200x200px）
- 既存のユーザーテーブルにavatar_urlカラムを追加

## UI要件
- プロフィール画面の上部に配置
- ドラッグ＆ドロップ対応
- アップロード中はローディング表示

AIが理解しやすいポイント

✅ 何を作るか明確（画像アップロード機能）
✅ 具体的な制約（5MB、JPEG/PNG）
✅ 技術的な指示（S3、サムネイル生成）
✅ UI要件（配置、操作方法）

詳しく書けば書くほど、AIの実装精度が上がります。

実装：Linear + GitHub + Claude Code

ステップ1：Linear GitHub統合の設定

Linear設定画面で：
1. Settings → Integrations → GitHub
2. リポジトリを接続
3. 同期設定：
   ✅ Create GitHub issues for Linear issues
   ✅ Create Linear issues for GitHub issues
   ✅ Sync issue status changes
   ✅ Link PRs to Linear issues
4. ラベル設定：
   - auto-implementラベルを自動付与するルールを設定

重要： 「Two-way sync issues between Linear and this repository」を選択することで、双方向同期が有効になります。

上記のように設定することで、Linear IssueとGitHub Issueが自動的に同期されます。

ステップ2：Linear Issueテンプレートの作成

Linear設定画面で：
1. Settings → Templates → Issue Templates
2. 新規テンプレート作成

テンプレート内容：
## 実装内容
[何を実装するか]

## 技術的要件
[使用する技術、制約条件]

## 受け入れ基準
- [ ] 基準1
- [ ] 基準2

## 参考
[関連する情報]

ステップ3：Claude Code GitHub Actionsの設定

.github/workflows/claude.yml

name: Claude Code Auto Implementation

on:
  issues:
    types: [opened, labeled]

jobs:
  implement:
    # auto-implementラベルが付いている場合のみ実行
    if: contains(github.event.issue.labels.*.name, 'auto-implement')
    runs-on: ubuntu-latest

    permissions:
      contents: write
      pull-requests: write
      issues: write

    steps:
      - uses: actions/checkout@v4

      - name: Claude Code Implementation
        uses: anthropics/anthropic-quickstarts@main
        with:
          anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
          github-token: ${{ secrets.GITHUB_TOKEN }}

動作の流れ

Linear GitHub統合の仕組み

同期される内容

Linear → GitHub:
✅ Linear Issue作成 → GitHub Issue自動作成
✅ ステータス変更を同期
✅ コメントを同期
✅ ラベルを同期

GitHub → Linear:
✅ PR作成時 → Linear Issueに自動リンク
✅ PRマージ時 → Linear Issue自動クローズ
✅ コミットメッセージ「Fixes LIN-123」でリンク
✅ GitHub Issueのコメント → Linear Issueに同期

上記のように、Linear Issueを作成すると自動的にGitHub Issueが作成され、auto-implementラベルが付与されます。Linear Issue ID（GOO-6など）とGitHub Issue番号が自動的にリンクされます。

ラベルの自動付与

Linear設定で：
1. Settings → Integrations → GitHub
2. Label Mappings:
   - Linearの特定プロジェクト → auto-implementラベル
   - 特定のチーム → auto-implementラベル

これで、特定のプロジェクトやチームのLinear Issueを作成するだけで、自動的にauto-implementラベルが付き、AI実装が始まります。

実践例：ログイン機能の実装

1. Linear Issueを作成

タイトル：ログイン機能の実装

説明：
## 要件
- メールアドレスとパスワードでログイン
- ログイン失敗5回でアカウントロック
- パスワードリセット機能
- セッション管理（JWT）

## 技術スタック
- Next.js App Router
- NextAuth.js
- Prisma
- PostgreSQL

## 画面
- /login：ログイン画面
- /forgot-password：パスワードリセット画面

## セキュリティ
- パスワードはbcryptでハッシュ化
- CSRFトークン
- レート制限

2. 自動実装が開始

[数秒後]
Linear GitHub統合がGitHub Issueを作成

[10秒後]
Claude Code GitHub Actionsが起動

[5分後]
PRが作成される
- /app/login/page.tsx
- /app/api/auth/[...nextauth]/route.ts
- /lib/auth.ts
- /prisma/schema.prisma（User拡張）
- Linear Issueに自動でリンク

3. レビュー

PRの内容を確認：
✅ ログイン画面のUI
✅ NextAuth.js設定
✅ パスワードハッシュ化
✅ セッション管理
✅ エラーハンドリング

4. マージ

PRをマージ
   ↓
Linear Issueが自動でクローズ
   ↓
デプロイパイプラインが起動

Linear Issueを書いてから、本番デプロイまで10分。

チームでの運用

役割分担

プロダクトマネージャー：
- Linear Issueを詳しく書く
- 優先度を設定
- 受け入れ基準を明確に

エンジニア：
- PRをレビュー
- 必要に応じて修正
- マージ

AI：
- 要件分析
- コード実装
- PR作成

運用ルール

Issueのラベル：
- auto-implement：自動実装ON
- manual：手動実装
- discussion：議論が必要

優先度：
- Urgent：即座に実装
- High：24時間以内
- Medium：1週間以内
- Low：時間があるとき

トラブルシューティング

Q: AIの実装が期待と違う

対策：
1. Linear Issueをより詳しく書く
2. 参考コードのパスを指定
3. 技術的制約を明記
4. UIのスクリーンショットを添付

Q: PRが作成されない

確認項目：
□ auto-implementラベルが付いているか
□ GitHub Actionsが有効か
□ Anthropic API Keyが正しいか
□ リポジトリの権限設定

Q: Linear Issueがクローズされない

確認項目：
□ Linear GitHub統合が有効か
□ PRに Linear Issue IDが含まれているか
□ ブランチ名にIssue IDが含まれているか

コスト

1 Issueあたりのコスト

Anthropic API：
- 分析：$0.01
- 実装：$0.10〜0.50（コード量による）

合計：約 $0.11〜0.51 / Issue

月間コスト（100 Issue）

Anthropic API：$11〜51
Linear：$8/ユーザー
GitHub：無料〜$4/ユーザー

合計：約 $19〜63/月

エンジニア1人の時給を考えると、圧倒的にコスパが良いです。

まとめ

Linear Issue起票で自動実装が始まる——これがAI時代の開発スタイルです。

得られる効果

⏱️ 開発スピード：
- Issue → PR：数分
- 待ち時間：ほぼゼロ

🎯 品質：
- レビューに集中できる
- 実装の一貫性が保たれる

😊 チーム：
- エンジニアは創造的な仕事に集中
- PMは要件定義に集中

今日から始められること

□ Linearアカウントを作成
□ Linear GitHub統合を設定
□ Claude Code GitHub Actionsを導入
□ Issue Templateを作成
□ 1つのLinear Issueで試してみる

必要なもの

✅ Linearアカウント（$8/月〜）
✅ GitHubリポジトリ
✅ Anthropic APIキー
✅ Claude Code GitHub Actions

n8nは不要。LinearのGitHub統合だけで完結します。

「何を作るか」を書くだけで、AIが実装する。これが当たり前になる時代が来ています。

---

Linear + AI開発についてのご相談も承っております。お気軽にお問い合わせください。