個人開発で学んだイシュー＋AI駆動開発

CLIツールやWebアプリ、モバイルアプリを「GitHub＋Claude」で開発している中で学んだことを整理しています。

・【イシュー駆動】GitHub Issueを起点として開発を始め、IssueとPRは1対1対応
・【AI駆動】Claudeのrules、skills、agentsを活用して段階的に開発環境を整備
・【メリット】①トークン節約、②情報資産の蓄積、③安定的な開発サイクルの効果

Transcript

1. 個人開発で学んだ イシュー＋ AI駆動開発 2026.08.15
2. 自己紹介 こうへい （X：@_it0_98） 所属 経歴 情報システム部 （最近は社内でClaude導入やっています） 社会人4年目（プロダクト開発→情シス） 勉強中 セキュリティ、AI駆動開発 趣味 サウナ、ラーメン
3. 目次 1. 課題 2. やったこと 3. まとめ
4. 課題 〜AI駆動開発中に起きた 4つのブレ〜 【原因】毎回ゼロから文脈を渡していた 1. 実装揺れ 同じ機能でも依頼するたびに書き方・置き場所が違う 2. スコープ膨張 頼んでいない「ついでリファクタ」が差分に混ざる 3. 推測実装 実在しないパス・APIを"それっぽく"書いてくる 4. 検証抜け 品質のチェックがないまま「できました」と報告される
5. やったこと 〜全体のイメージ〜 段階的に開発環境を整備 ④品質を設定 ③作業手順を設定 ②判断基準の定義 ①課題の入口を固定
6. やったこと ① 課題の入口を固定（ GitHub Issue） • イシュー、PR、リリースノートのテンプレート作成 ◦ リリースノートに対応したイシュー（＝PR）を列挙 ◦ イシューとPRは1対1で対応 • 【補足】イシューとブランチの対応例 ◦ ◦ ◦ ◦ 🐛不具合 👍機能改修 📖ドキュメント 🔄改善 → fix → feat → docs → chore / refactor
7. やったこと ① 課題の入口を固定（ GitHub Issue） イシュー イシュー イシュー Issue イシュー イシュー イシュー PR Release v1.0.0 イシュー イシュー イシュー Issue イシュー イシュー イシュー PR Release v1.1.0 ⚫ ⚫ ⚫ • Issue：PR＝1：1 • PR：Release＝多：1
8. やったこと ②判断基準を定義（ .claude/rules/） • 【メタルール 】調査ファースト、スコープ制御などの作業フロー • 【アーキテクチャ 】レイヤー間の依存関係や責務、フォルダ構成 • 【品質方針・目標 】例外処理、テスト規約、トーン&マナー • 【git開発フロー 】ブランチ、イシュー、PR、リリースの運用 • 【その他】複雑なドメインロジック、レイヤーごとの詳細説明、ドキュメント 規約
9. やったこと ②判断基準を定義（ .claude/rules/） 【例】プロンプト実際に投げたプロンプト例 • 【Fable】他のモデルでもあなたと同じ精度で開発できるように作業方針 や基準を明文化して下さい。 • 【Opus / Sonnet】今後、このようなことがないようにルールとして明文化し て下さい。
10. やったこと ③手順を設定（ .claude/skills/） 【表】作業フロー ⓪調査 影響範囲・作業内容の調査 ①UCD、ADR 要求仕様書、設計判断の記録 ②Issue起票 GitHub Issue登録 ③実装 Issue対応→PR作成（マージ） ④同期 コードとドキュメントの同期（乖離を解消） ⑤リリース・デプロイ アプリのリリース・デプロイ
11. やったこと ③手順を設定（ .claude/skills/） ⇧ ⇦実際のフォルダ構成例
12. やったこと ④品質を設定（ .claude/agents） ⓪調査 ← exploer エージェント（影響調査） ①UCD、ADR ← reviewer エージェント（設計レビュー） ②Issue起票 ③実装 ← reviewer エージェント（実装レビュー） ④同期 ← doc-auditor エージェント（乖離検出） ⑤リリース・デ プロイ 【+α】文法・型チェック、テストはpre-commitで機械的に対応
13. まとめ ①入出力の固定化、②判断基準の明確化、③コンテキスト・ハーネスの記録 項目 Before After 依頼(課題) チャットの自然文 GitHub Issue ( ↔ GitHub PR ) 判断基準 自分の頭の中 .claude/rules 手順 思いつき .claude/skills, agents 品質 気が向いたらチェック .claude/skills, agents 【効果】トークン節約、情報資産の蓄積、安定的な開発サイクル