必要になるのはいつ?(まさにその瞬間)
必要性が現れるのは、まさにAIで本物のアプリを作り始めたとき —ただAIとおしゃべりしているときではない。その段階では、AIは一度に多くのファイルを触る。そしてある日、小さな変更を頼んだのに、うっかり動いていた3つのものを壊してしまう。そこで初めて、セーフティネットを持っていたか…持っていなかったかがわかる。
そしてもう一つ、もっと微妙な足かせがある: 実験することへの恐怖だ。セーフティネットがないと、何も壊さないよう臆病な変更しか頼まない —そして臆病な変更では、大きなものは何も作れない。GitHubに保存しておけば、思い切れる: うまくいかなければ、元に戻せばいいだけだ。
GitとGitHubって何?(それぞれ一文で)
Gitは、あなたのプロジェクトの時間ごとの写真を保存するシステムだ(各写真をcommitと呼ぶ)。GitHubは、その写真を安全に保管して、いつでもどれにでも戻れるようにアップロードするクラウドだ。Gitはあなたのコンピュータに住み、GitHubはインターネットに住む。両方合わせて = バックアップ + タイムマシン。
あなたのプロジェクトはどこに住んでいる? ローカルフォルダ vs サンドボックス
これは、何で作っていようとGitHubがいつもあなたにとって得である理由を理解する鍵だ。AIツールはあなたのプロジェクトを2つの方法で保存し、どちらでもGitHubが勝つ:
ローカルフォルダ — Claude Codeのようなツールは、あなた自身のコンピュータ上のフォルダで作業する。動いているのを見るには、ブラウザでlocalhostを開く。プロジェクトはあなたのもので、あなたのディスクにある…でも、うっかり削除したりコマンドが壊したりすると、クラウドにバックアップがなければ元に戻せない。
独自のサンドボックス — 他のツール(NeuralOS、v0、Boltなど)は、あなたのアプリを独自の環境の中で動かし、あなたはそこにデプロイされたものをそのまま見る、フォルダを扱うことなく。とても快適だ。でもあなたのコードはそのプラットフォームのアカウントに住んでいる —何が起きても生き残る、本当にあなたのものであるコピーが欲しいなら、GitHubに置くことだ。
ターミナルなしの道 · GitHub Desktop(始めるのにおすすめ)
「ターミナル」という言葉に気が重くなるなら、これがあなたの道だ。GitHub DesktopはGitHubの公式かつ無料のアプリで、すべてをボタンでこなす。あなたの変更のリストを見て、メモを書いて、保存する —コマンドは一切なし。そのスローガンがこう言っている: 「Gitと格闘するのではなく、大事なことに集中しよう」。
- github.comで無料アカウントを作る(まだ持っていなければ)。
- GitHub Desktopを
desktop.github.com/downloadからダウンロードする(MacとWindows)。 - アプリでプロジェクトを開く: File → Add Local Repository でフォルダを選ぶ。
- Publish repository を押してクラウドにアップロードする。完了: もう安全だ。
そこからは、アプリが変更を見せてくるたびに、左下に短いメモ(Summary)を書いて、Commit to mainを押し、そのあとPush originを押す。それがクラウドにアップロードされたセーブポイントだ。何かがうまく動いたら、毎回これをやろう。
コマンドの道 · 黄金の価値がある4つ
ターミナルの方が好みなら(あるいはあなたのAIがあなたの代わりに使うなら)、この4つのコマンドで必要なことの90%が手に入る。あなたのAIはこれを暗記している —実行して一つずつ説明してもらうよう頼める。
git init git add . git commit -m "primer punto de guardado: el proyecto funciona"
git status
git add . git commit -m "describe en pocas palabras qué lograste"
git push
鍵となる瞬間 · AIが何かを壊したときに元に戻す
ここに超能力がある。あなたのアプリが動いていて、変更を頼んで、今は壊れていると想像してほしい。動いていたときにポイントを保存していたなら、それを取り戻すのは造作ない。 GitHub Desktopでは: Historyメニューで、良いポイントを右クリック → Revert changes。コマンドなら、やりたいことに応じて2つの方法がある:
git revert HEAD
そのgit revertが一番安全だ: 履歴を消さず、最後のものを取り消す新しいポイントを作るだけ。前のポイントの状態のまま1つのファイルだけを取り戻したいなら、AIに頼む: 「ファイルXを、動いていた最後のcommitのときの状態に戻して」 と言えば、AICがgit checkoutを使う。黄金律:
revertかresetかcheckoutかを覚える必要はない。こう言おう: 「何かが壊れた。動いていた最後のポイントのちょうど状態にプロジェクトを戻して、可能ならその後の作業は失わずに。」 あなたのAICが正しいコマンドを選ぶ。GitHubはセーフティネット、あなたのAIはそれを使う人だ。ブランチ · 恐れずに無茶を試す(任意だが魔法のよう)
ブランチとは、動いているバージョンに触れずに実験できる、あなたのプロジェクトの並行コピーだ。AIに何か危険なことを試させたい? ブランチを作って、そこで試させて、うまくいけば統合する(merge)、失敗したら削除すれば何もなかったことになる。あなたのメインバージョンは一度も危険にさらされない。
main)は清書した文書だ。新しいブランチはらくがきをするコピーだ。らくがきがうまくいったら、清書に写す。だめなら、コピーを捨てる。原本はいつも無傷だ。git checkout -b prueba-arriesgada
最も大事なこと · 必ず保存する5つの瞬間
ここに本当の秘訣があり、ほとんど誰もやっていないことだ: GitHubは一度セットアップしたら終わり、ではない。その価値は習慣にある。GitHubを絶えず養わなければ、必要になった日に戻れるものが何もない。保存が交渉の余地なしとなる5つの瞬間、本気で作る私たちが使っているのと同じものだ:
- 何かが動いたとき。 ボタン、画面、フローが機能するようにできた → 保存。それは戻りたくなるポイントだ。
- 大きな、あるいは危険な変更のまえに。 AIに大ごとを頼むところ → まず保存。失敗したら、ワンクリックで戻る。
- バグを見直して直したあと。 ちょうど監査してすべてをきれいにしたところ → その良い状態を保存。(こう働くのだ: 監査して、直して、それから保存。)
- 各セッションの終わりに。 接続を切ろうとしている → クラウドにアップロード。あなたのコンピュータが死んでも、プロジェクトは生きる。
- AIに一人で「実験」させる前に。 試す自由を与える → バックアップポイントを用意しておく。
きれいに保存 · GitHubをゴミで埋めない
良い履歴とは、各ポイントが何かを意味する履歴だ。GitHubが役立つものになり、ゴミ捨て場にならないための、シンプルな2つのルール:
- きれいな瞬間に保存する(何かが動いたときや、直ったとき)、壊れた変更の途中ではなく。
- 未来のあなたが理解できるメッセージを: 「支払いボタンを直した」、「変更」や「asdf」ではなく。
- ゴミファイルをアップロードしない: 依存関係(
node_modules)、一時ファイル、秘密情報(.env)。それは.gitignoreに入れる(下で見る)。 - 1ポイント = 1つのアイデア。3つの別々のことをしたなら、それぞれのメモをつけて3回保存していい。
初心者にありがちな間違い(と、その避け方)
.envという名前)に入っているなら、それらは絶対にGitHubにアップロードしてはいけない。AIに.envを中に入れた.gitignoreファイルを作ってもらおう —それがGitに「これは無視して、保存しないで」と伝える。ナンバーワンの間違いで、10秒で避けられる。一番簡単な道 · あなたのエージェントにチャットでやってもらう
コードエージェント(Claude Codeなど)を使っているなら、ほとんどすべてがチャットでこなせる —コマンドを覚える必要はない。あなたのエージェントがメッセージだけで一人でできること、そしてあなたがやるべきわずかなことはこうだ:
- エージェントがチャットでやること:
.gitignoreの作成、最初のセーブポイント、その後のすべてのセーブ、クラウドへのアップロード、そして何か壊れたときに元に戻すこと。 - あなたが一度だけやること(5分):
github.comでアカウントを作ること、そして手動で接続したいなら、そこに空のリポジトリを作ること。エージェントによっては、許可を与えればこれすら一人でやる。 - 接続のコツ: GitHubで空のリポジトリを作って、その名前/URLをコピーし、エージェントに渡す: 「このプロジェクトをこのリポジトリに接続してアップロードして」。残りは彼がやる。
mi-tienda-online、app-de-recetas、landing-cafe。アクセント記号や変な大文字なしで。名前を見るのはあなた(と招待した人)だけだ。迷ったら、プロジェクトの名前をそのままつけよう。すぐ使えるプロンプト · あなたのAIに渡せば、すべて設定完了
これが最初から最後までの完全なプロンプトだ。コピーして、角括弧の中身を置き換えて、コードエージェントに貼り付ける。GitHubがセットアップされ、接続され、保存を思い出させる習慣までついた状態にしてくれる。
gitのことはわからないけど、GitHubでプロジェクトを守りたい。ステップごとに案内して、できるところはあなたがやって。ぼくのプロジェクトの名前は[NOMBRE]。[Claude Code / NeuralOS / 他のツール]で作っている。 1) アカウント: GitHubアカウントを持っていなければ、github.com(無料)でどう作るか、短いステップで正確に教えて。 2) リポジトリ: 新しくて非公開のリポジトリをどう作るか教えて。ぼくのプロジェクトの名前から、小文字でハイフンつきの名前を提案して。許可を得てあなたが作れるなら作って。無理なら正確なクリックを教えて、ぼくが名前かURLを渡す。 3) クリーンアップ: .env、node_modules、一時ファイル、あらゆる秘密情報を無視する.gitignoreを作って、ゴミやパスワードをアップロードしないようにして。 4) 最初のポイント: gitを初期化して、明確なメッセージで最初のcommitをして、ぼくの非公開リポジトリに接続してアップロードして。 5) 習慣: これからは、動くものを達成するたび、大きな変更のまえ、そしてバグを見直し/修正したあとに、ポイントを保存するよう思い出させて、クラウドにアップロードするか聞いて。未来のぼくが理解できる明確なcommitメッセージを使って。 6) レスキュー: 何か壊れたら、ぼくの作業を失わずに動いていた最後のポイントに戻れるよう手伝って、何が起きたか一文で説明して。 シンプルにやって。ぼくがウェブで自分でやるしかないことがあれば、正確なクリックとともに教えて。
公式ツール(無料で検証済み)
GitHub Desktop — Gitをボタンで、ターミナルなしで使う、GitHubの公式かつ無料のアプリ。「Gitと格闘するのではなく、大事なことに集中しよう。」desktop.github.com/download でダウンロード。