Skip to content

このページは韓国語の原文をAIで翻訳したものです。誤りが含まれる場合があります。

第4章 作る — まず計画、ブランチとコミット ​

必須 この段階を進めるなら、必ず読んでください。

一言まとめ: 新しいセッションでSPEC.mdを渡し、計画モードでまず計画を受け取ります。承認したあとは、ブランチという切り離された場所で作り、小さな変更ごとにコミットで記録します。 ブランチで作り、記録し、レビューを受けて合わせるこの流れを、GitHub flow(ギットハブ・フロー)と呼びます。開発者だけでなく誰にでも役に立つ、軽い作業の流れです。

この章は、2026年11月1日に確認したClaude Code・GitHub公式ドキュメントをもとに書きました。計画モードとコミットは、Claude Code 第4・5章で使ってみました。この章では、それをブランチと結び付けて、「安全に作る流れ」としてまとめます。

まず計画を受け取る ​

SPEC.mdができたら、新しいセッションを開いて計画モードに切り替えます。デスクトップアプリでは、Claude Code 第5章のように、入力欄の下のモードを「計画(계획)」に切り替えます。計画モードでは、Claudeはファイルを読んで計画だけを出し、自分が承認するまで何も直しません。[1]

SPEC.mdを読んで、この仕様を満たすやることボードを作る計画を立てて。まだファイルは作らないで。

計画を受け取ったら、こう聞いてみましょう。

  • SPEC.mdの行ごとに、計画のどの段階が対応しているか。
  • 1つの段階が、一度に確認できる大きさか。
  • 自分の知らない新しいツールやインストールが入っていないか。

気に入らなければ、承認する前に直してもらいます。計画の段階で直すのが一番安くすみます。

理解度チェック

計画モードの説明として正しいものはどれでしょうか?

ブランチで作る ​

ブランチは、機能を切り離された場所で作らせてくれます。準備ができるまで、基本のバージョン(main)は変わりません。[2] 失敗してもmainは無事なので、安心して試せます。

GitHubの入門チュートリアルは、作る過程をこうまとめています。作業の場所を用意する → 変更して保存する → レビューを受けるために提案するで、そのための道具がブランチ・コミット・PRです。[3] PR(Pull Request、プルリクエスト)は、「ブランチで変えたものをmainに合わせてください」と差し出す提案です。第6章で実際に作ってみます。

ブランチの名前は、短く、意味が伝わるようにつけます。[4] やることボードの最初の画面なら、first-boardくらいで十分です。

first-boardブランチを作って、承認した計画どおりに最初の画面を作って。ビルドが要らないように、一番上のフォルダのindex.html一つで開けるようにして。

依頼に出てきたビルド(build)は、書いたコードを、ブラウザが読めるファイルに変える準備の作業です。「ビルドが要らないように」は、そうした作業なしに、ファイルをブラウザでそのまま開けば見えるようにしてほしい、という意味です。

index.html一つで作る理由は、第7章のGitHub Pagesが、公開するフォルダの一番上でindex.htmlを探すからです。

理解度チェック

ブランチを使う理由として正しいものはどれでしょうか?

小さくコミットする ​

コミットは、変更をその瞬間の写真のように保存し、プッシュはその写真をGitHubのリポジトリに送ります。[5]

1つのコミットには、切り離された、完結した変更を1つ入れるのがよいです。そうすれば、別の方法を選びたくなったとき、その部分だけ元に戻しやすくなります。[6] 関係のない変更は、ブランチも別に作ります。[6:1]

物足りないコミットよりよいコミット
1日分の作業を一度に「作業」「やること表の読み込みを追加」、「期限を過ぎたやることを色で表示」

出典: このガイドの例(原則はGitHub公式ドキュメント)[6:2]

ステップ3で学んだとおり、任せる前と後に記録を残す習慣は、ここでもそのまま通用します。

理解度チェック

GitHub がすすめるコミットの仕方はどれでしょうか?

AIが作ったものを読む ​

AIが作った結果は、読んでから受け入れます。GitHubのチュートリアルも、AIが作ったものを確認してから、例に合わせて直すよう言っています。[7]

Claude Codeデスクトップアプリでは、変更内容の表示(diff)で、ファイルごとに変更を確認できます。行の横の**+**で意見を付けると、Claudeが読んで直してくれます。[8]

コードを全部理解できなくても大丈夫です。こう聞いてみましょう。

さっき変えたファイルごとに、何をなぜ変えたのか1行ずつ説明して。SPEC.mdのどの行とつながるかも教えて。

説明がSPEC.mdとつながらない変更があれば、頼んでいないことをしたのかもしれません。その部分を聞いてみましょう。

理解度チェック

AI が作ったコードをすべては理解できないとき、このガイドがすすめることはどれでしょうか?

自分でやってみよう ​

  1. やることボードのフォルダで新しいセッションを開き、計画モードに切り替える。
  2. 上の計画の依頼を送り、3つの質問で計画を点検してから承認する。
  3. first-boardブランチで最初の画面を作らせる。やることのデータは、ステップ3の議事録のやること表を使う。
  4. 変更内容の表示でファイルを確認し、変更の説明を依頼する。
  5. 小さな単位でコミットさせる。
  6. Claudeに「first-boardブランチをGitHubにアップロード(プッシュ)して」とお願いする。GitHubのリポジトリ画面でブランチが見えればよい。初めてアップロードするときにログイン画面が出たら、第2章と同じように案内に従う。失敗したというメッセージが出たら、そのメッセージをそのままClaudeに見せて、何が問題なのかを聞く。

続きの課題: 第5章では、「やることが1つも欠けずに見えるか?」をClaudeが自分で確認する仕組みを作ります。

まとめ ​

  • 新しいセッションでSPEC.mdを渡し、計画モードでまず計画を受け取る。直すのは計画の段階が一番安い。
  • ブランチは、mainに触れない作業の場所。名前は短く、意味が伝わるように。
  • 1つのコミットに、完結した変更を1つ。関係のない変更は、ブランチを分ける。
  • AIが作ったものは、読んでから受け入れる。変更ごとに、SPEC.mdのどの行とつながるかを聞く。

用語まとめ ​

用語読み方一言でいうと
Branchブランチ基本のバージョンに触れずに、別に作業する枝分かれ
Commitコミット変更をその瞬間の写真のように記録すること
Pushプッシュ自分の記録をGitHubのリポジトリに送ること
GitHub flowギットハブ・フローブランチ → 変更 → PR → レビュー → マージという作業の流れ

この章は読み終わりましたか?

学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。

次の章: 第5章 確認とテスト

参考資料(8件)
  1. Claude Code公式ドキュメント、「Common workflows」。"For changes you want to review before they touch disk, switch to plan mode. Claude reads files and proposes a plan but makes no edits until you approve." code.claude.com (確認日 2026-11-01) ↩︎

  2. GitHub公式ドキュメント、「Writing and storing your code」。"A branch lets you work on your feature in its own space, without changing the main copy of your code until you're ready." docs.github.com (確認日 2026-11-01) ↩︎

  3. GitHub公式ドキュメント、「Writing and storing your code」。"Along the way, you'll follow the core developer workflow—setting up a space for your work, making and saving your changes, and proposing them for review—using branches, commits, and a pull request." docs.github.com (確認日 2026-11-01) ↩︎

  4. GitHub公式ドキュメント、「GitHub flow」。"A short, descriptive branch name enables your collaborators to see ongoing work at a glance." docs.github.com (確認日 2026-11-01) ↩︎

  5. GitHub公式ドキュメント、「Writing and storing your code」。"Committing saves a snapshot of your changes, and pushing sends them to GitHub where they will be stored in your repository." docs.github.com (確認日 2026-11-01) ↩︎

  6. GitHub公式ドキュメント、「GitHub flow」。"Ideally, each commit contains an isolated, complete change. This makes it easy to revert your changes if you decide to take a different approach." / "Make a separate branch for each set of unrelated changes." docs.github.com (確認日 2026-11-01) ↩︎

  7. GitHub公式ドキュメント、「Writing and storing your code」。"Review what Copilot generates, then adjust the files to match the examples below." docs.github.com (確認日 2026-11-01) ↩︎

  8. Claude Code公式ドキュメント、「Desktop application」。"After Claude makes changes to your code, the diff view lets you review modifications file by file before creating a pull request." / "Claude reads your comments and makes the requested changes, which appear as a new diff you can review." code.claude.com (確認日 2026-11-01) ↩︎