NeuralOS
GuideBeginner

AIがプロジェクトを壊す前に、すべてをGitHubに保存しよう · あなたの無限の取り消しボタン

もう経験したか、これから経験するはずだ。AIに小さな変更を頼んだら、40個のファイルを触られて、完璧に動いていたアプリが突然開かなくなる。いつも大惨事になるわけではない —多くのツールはあなたのプロジェクトを保存している— でも、間違ったコマンド、うっかりした削除、あるいはAIによる大規模な変更は、本当に元に戻す術を奪ってしまうことがある。GitHubは、ツールとは切り離された、あなた自身の保険だ。すべてが動いていたちょうどその瞬間に、何も失わずワンクリックで戻れる。「プログラマー向け」なだけではない —AIに全力で仕事をさせることへの恐怖を取り除いてくれるセーフティネットだ。でも秘訣は一度セットアップすることではない。どの瞬間に保存するかを知り、それを習慣にすることだ。それこそが、ここで本当に身につくものだ。

Jun 18, 202611 min
これは誰のため?
AIで何かを作っていて、まだGitHubを使っていない人 —あるいは中途半端にしか使っていない人— のためのものだ。プログラミングは必要ない。 「何か壊れたら困るから」とAIの変更を受け入れるのが怖かったことがあるなら、このガイドがその恐怖を取り除く。そして「それが何か」を超えて、どの瞬間に保存すべきか、そしてそれをどう習慣にするかを教える —ほとんどの人が失敗するのはまさにそこだ。ボタンで進める道と、あなたのエージェントとのチャットで進める道がある。あなたが選べばいい。

必要になるのはいつ?(まさにその瞬間)

必要性が現れるのは、まさにAIで本物のアプリを作り始めたとき —ただAIとおしゃべりしているときではない。その段階では、AIは一度に多くのファイルを触る。そしてある日、小さな変更を頼んだのに、うっかり動いていた3つのものを壊してしまう。そこで初めて、セーフティネットを持っていたか…持っていなかったかがわかる。

恐怖を整理しよう: 事故であって、終末ではない
正直に言おう: いつも「すべてが消える」わけではない。 多くのツールはあなたのプロジェクトをフォルダやクラウドに保存している。本当の問題はもっと別で、もっと静かなものだ: 間違ったコマンドうっかりした削除、あるいは動いていたものを壊すAIの大規模な変更 — そして戻れる地点がなければ、その作業は失われる。GitHubはあなたの別建ての保険で、どのツールを使うかに依存しない。

そしてもう一つ、もっと微妙な足かせがある: 実験することへの恐怖だ。セーフティネットがないと、何も壊さないよう臆病な変更しか頼まない —そして臆病な変更では、大きなものは何も作れない。GitHubに保存しておけば、思い切れる: うまくいかなければ、元に戻せばいいだけだ。

こう想像してみて
GitHubはテキストエディタの「取り消し」機能のようなもの…でも、プロジェクト全体に対して、しかも無制限に。最後の単語を取り消すのではなく、昨日、1時間前、あるいは壊れる直前の状態そのままのプロジェクト全体に戻る。あなたのコードのためのタイムマシンだ。

GitとGitHubって何?(それぞれ一文で)

Gitは、あなたのプロジェクトの時間ごとの写真を保存するシステムだ(各写真をcommitと呼ぶ)。GitHubは、その写真を安全に保管して、いつでもどれにでも戻れるようにアップロードするクラウドだ。Gitはあなたのコンピュータに住み、GitHubはインターネットに住む。両方合わせて = バックアップ + タイムマシン。

ビデオゲームのたとえ
commitセーブポイントだ、ビデオゲームのように。進んで、セーブ。進んで、セーブ。次のステージで失敗したら、最後のセーブをロードし直すので、進捗すべてを失うことはない。GitHubでやるのは、まさにそれ、でもあなたのプロジェクトで。

あなたのプロジェクトはどこに住んでいる? ローカルフォルダ vs サンドボックス

これは、何で作っていようとGitHubがいつもあなたにとって得である理由を理解する鍵だ。AIツールはあなたのプロジェクトを2つの方法で保存し、どちらでもGitHubが勝つ:

ローカルフォルダ — Claude Codeのようなツールは、あなた自身のコンピュータ上のフォルダで作業する。動いているのを見るには、ブラウザでlocalhostを開く。プロジェクトはあなたのもので、あなたのディスクにある…でも、うっかり削除したりコマンドが壊したりすると、クラウドにバックアップがなければ元に戻せない。

独自のサンドボックス — 他のツール(NeuralOS、v0、Boltなど)は、あなたのアプリを独自の環境の中で動かし、あなたはそこにデプロイされたものをそのまま見る、フォルダを扱うことなく。とても快適だ。でもあなたのコードはそのプラットフォームのアカウントに住んでいる —何が起きても生き残る、本当にあなたのものであるコピーが欲しいなら、GitHubに置くことだ。

大事な結論
ローカルフォルダであれサンドボックスであれ、GitHubは100%あなたのもので、ツールに依存しない唯一のバックアップだ。 あなたのマスターコピーだ。だからこそ、どちらの場合でも価値があり —だからこそ、本気でアプリを作り始めるちょうどそのときに、接続しておくのが得策なのだ。

ターミナルなしの道 · GitHub Desktop(始めるのにおすすめ)

「ターミナル」という言葉に気が重くなるなら、これがあなたの道だ。GitHub DesktopはGitHubの公式かつ無料のアプリで、すべてをボタンでこなす。あなたの変更のリストを見て、メモを書いて、保存する —コマンドは一切なし。そのスローガンがこう言っている: 「Gitと格闘するのではなく、大事なことに集中しよう」。

4ステップで始める(ボタンで)
github.comで無料アカウントを作る(まだ持っていなければ)。
GitHub Desktopdesktop.github.com/downloadからダウンロードする(MacとWindows)。
アプリでプロジェクトを開く: File → Add Local Repository でフォルダを選ぶ。
Publish repository を押してクラウドにアップロードする。完了: もう安全だ。

そこからは、アプリが変更を見せてくるたびに、左下に短いメモ(Summary)を書いて、Commit to mainを押し、そのあとPush originを押す。それがクラウドにアップロードされたセーブポイントだ。何かがうまく動いたら、毎回これをやろう。

GitHub Desktopは公式で無料
オープンソースで、MITライセンス、GitHub自身がメンテナンスしている(リポジトリに2万1千以上のスター)。トリックでもサードパーティのアプリでもない: コマンドを使いたくない人のためにGitHubがまさに作ったツールだ。

コマンドの道 · 黄金の価値がある4つ

ターミナルの方が好みなら(あるいはあなたのAIがあなたの代わりに使うなら)、この4つのコマンドで必要なことの90%が手に入る。あなたのAIはこれを暗記している —実行して一つずつ説明してもらうよう頼める。

1 · プロジェクトの追跡を始める(一度だけ)bash
git init
git add .
git commit -m "primer punto de guardado: el proyecto funciona"
2 · 何が変わったか見る(保存する前に)bash
git status
3 · 新しいポイントを保存する(何かが動くたびに)bash
git add .
git commit -m "describe en pocas palabras qué lograste"
4 · クラウドにアップロードする(本当に安全に)bash
git push
何も暗記しなくていい
最高のコツ: あなたのAIにやらせること。 「gitに進捗を保存して、今達成したことを説明するメッセージをつけてGitHubにアップロードして」 と言えば、AICがあなたの代わりにコマンドを走らせる。あなたはいつ保存するかを決めるだけだ。

鍵となる瞬間 · AIが何かを壊したときに元に戻す

ここに超能力がある。あなたのアプリが動いていて、変更を頼んで、今は壊れていると想像してほしい。動いていたときにポイントを保存していたなら、それを取り戻すのは造作ない。 GitHub Desktopでは: Historyメニューで、良いポイントを右クリック → Revert changes。コマンドなら、やりたいことに応じて2つの方法がある:

打ち消す新しい変更を作って、変更を取り消す(安全)bash
git revert HEAD

そのgit revertが一番安全だ: 履歴を消さず、最後のものを取り消す新しいポイントを作るだけ。前のポイントの状態のまま1つのファイルだけを取り戻したいなら、AIに頼む: 「ファイルXを、動いていた最後のcommitのときの状態に戻して」 と言えば、AICがgit checkoutを使う。黄金律:

あなたのAIに日本語で頼もう
revertresetcheckoutかを覚える必要はない。こう言おう: 「何かが壊れた。動いていた最後のポイントのちょうど状態にプロジェクトを戻して、可能ならその後の作業は失わずに。」 あなたのAICが正しいコマンドを選ぶ。GitHubはセーフティネット、あなたのAIはそれを使う人だ。

ブランチ · 恐れずに無茶を試す(任意だが魔法のよう)

ブランチとは、動いているバージョンに触れずに実験できる、あなたのプロジェクトの並行コピーだ。AIに何か危険なことを試させたい? ブランチを作って、そこで試させて、うまくいけば統合する(merge)、失敗したら削除すれば何もなかったことになる。あなたのメインバージョンは一度も危険にさらされない。

下書きのたとえ
メインブランチ(main)は清書した文書だ。新しいブランチはらくがきをするコピーだ。らくがきがうまくいったら、清書に写す。だめなら、コピーを捨てる。原本はいつも無傷だ。
実験用のブランチを作るbash
git checkout -b prueba-arriesgada

最も大事なこと · 必ず保存する5つの瞬間

ここに本当の秘訣があり、ほとんど誰もやっていないことだ: GitHubは一度セットアップしたら終わり、ではない。その価値は習慣にある。GitHubを絶えず養わなければ、必要になった日に戻れるものが何もない。保存が交渉の余地なしとなる5つの瞬間、本気で作る私たちが使っているのと同じものだ:

絶対に保存すべきとき…
何かが動いたとき。 ボタン、画面、フローが機能するようにできた → 保存。それは戻りたくなるポイントだ。
大きな、あるいは危険な変更のまえに。 AIに大ごとを頼むところ → まず保存。失敗したら、ワンクリックで戻る。
バグを見直して直したあと。 ちょうど監査してすべてをきれいにしたところ → その良い状態を保存。(こう働くのだ: 監査して、直して、それから保存。)
各セッションの終わりに。 接続を切ろうとしている → クラウドにアップロード。あなたのコンピュータが死んでも、プロジェクトは生きる。
AIに一人で「実験」させる前に。 試す自由を与える → バックアップポイントを用意しておく。
要約する一言
間違いはGitHubを持たないことではない。間違いはそれを養わないことだ。反射にしよう: 「動いた → 保存する」「大ごとを触るところ → まえに保存する」。何ヶ月分もの作業の価値がある、毎回わずか10秒。

きれいに保存 · GitHubをゴミで埋めない

良い履歴とは、各ポイントが何かを意味する履歴だ。GitHubが役立つものになり、ゴミ捨て場にならないための、シンプルな2つのルール:

きれいに保存するための良い習慣
きれいな瞬間に保存する(何かが動いたときや、直ったとき)、壊れた変更の途中ではなく。
未来のあなたが理解できるメッセージを: 「支払いボタンを直した」「変更」「asdf」ではなく。
ゴミファイルをアップロードしない: 依存関係(node_modules)、一時ファイル、秘密情報(.env)。それは.gitignoreに入れる(下で見る)。
1ポイント = 1つのアイデア。3つの別々のことをしたなら、それぞれのメモをつけて3回保存していい。

初心者にありがちな間違い(と、その避け方)

パスワードをGitHubにアップロードしない
あなたのプロジェクトにキー、パスワード、トークンがファイル(たいてい.envという名前)に入っているなら、それらは絶対にGitHubにアップロードしてはいけない。AIに.envを中に入れた.gitignoreファイルを作ってもらおう —それがGitに「これは無視して、保存しないで」と伝える。ナンバーワンの間違いで、10秒で避けられる。
デフォルトでプライベートリポジトリ
公開するとき、GitHubはリポジトリが公開(public)非公開(private)かを尋ねる。あなたの個人やビジネスのプロジェクトなら、非公開を選ぶ。公開は、インターネット上の誰でもあなたのコードを見られることを意味する。あとで変更できるが、安全のため非公開で始めよう。

一番簡単な道 · あなたのエージェントにチャットでやってもらう

コードエージェント(Claude Codeなど)を使っているなら、ほとんどすべてがチャットでこなせる —コマンドを覚える必要はない。あなたのエージェントがメッセージだけで一人でできること、そしてあなたがやるべきわずかなことはこうだ:

誰が何をやるか
エージェントがチャットでやること: .gitignoreの作成、最初のセーブポイント、その後のすべてのセーブ、クラウドへのアップロード、そして何か壊れたときに元に戻すこと。
あなたが一度だけやること(5分): github.comでアカウントを作ること、そして手動で接続したいなら、そこに空のリポジトリを作ること。エージェントによっては、許可を与えればこれすら一人でやる。
接続のコツ: GitHubで空のリポジトリを作って、その名前/URLをコピーし、エージェントに渡す: 「このプロジェクトをこのリポジトリに接続してアップロードして」。残りは彼がやる。
リポジトリはどう名付ける?
シンプルに小文字で、スペースの代わりにハイフンを: mi-tienda-onlineapp-de-recetaslanding-cafe。アクセント記号や変な大文字なしで。名前を見るのはあなた(と招待した人)だけだ。迷ったら、プロジェクトの名前をそのままつけよう。

すぐ使えるプロンプト · あなたのAIに渡せば、すべて設定完了

これが最初から最後までの完全なプロンプトだ。コピーして、角括弧の中身を置き換えて、コードエージェントに貼り付ける。GitHubがセットアップされ、接続され、保存を思い出させる習慣までついた状態にしてくれる。

これをコピーして、コードエージェントに渡そうtexto
gitのことはわからないけど、GitHubでプロジェクトを守りたい。ステップごとに案内して、できるところはあなたがやって。ぼくのプロジェクトの名前は[NOMBRE]。[Claude Code / NeuralOS / 他のツール]で作っている。

1) アカウント: GitHubアカウントを持っていなければ、github.com(無料)でどう作るか、短いステップで正確に教えて。

2) リポジトリ: 新しくて非公開のリポジトリをどう作るか教えて。ぼくのプロジェクトの名前から、小文字でハイフンつきの名前を提案して。許可を得てあなたが作れるなら作って。無理なら正確なクリックを教えて、ぼくが名前かURLを渡す。

3) クリーンアップ: .env、node_modules、一時ファイル、あらゆる秘密情報を無視する.gitignoreを作って、ゴミやパスワードをアップロードしないようにして。

4) 最初のポイント: gitを初期化して、明確なメッセージで最初のcommitをして、ぼくの非公開リポジトリに接続してアップロードして。

5) 習慣: これからは、動くものを達成するたび、大きな変更のまえ、そしてバグを見直し/修正したあとに、ポイントを保存するよう思い出させて、クラウドにアップロードするか聞いて。未来のぼくが理解できる明確なcommitメッセージを使って。

6) レスキュー: 何か壊れたら、ぼくの作業を失わずに動いていた最後のポイントに戻れるよう手伝って、何が起きたか一文で説明して。

シンプルにやって。ぼくがウェブで自分でやるしかないことがあれば、正確なクリックとともに教えて。
いつでも貼り直せばいい
このプロンプトを保存しておこう。新しいプロジェクトを始めるたびにエージェントに貼り直せば、2分でセーフティネットが張れる。同じ動作、いつも。

公式ツール(無料で検証済み)

desktop/desktop
REPO

GitHub Desktop — Gitをボタンで、ターミナルなしで使う、GitHubの公式かつ無料のアプリ。「Gitと格闘するのではなく、大事なことに集中しよう。」desktop.github.com/download でダウンロード。

TypeScriptMITView on GitHub
NeuralOSではこれと格闘しない
NeuralOSの中では、あなたが作る各アプリがバージョン履歴を自動で保存する —commitやブランチのことを考える必要なしに。セーフティネットは最初から張られている。学習曲線なしでGitHubの力が欲しいなら、それがその道だ。
C-A-Rプロトコル · あなたのAIとバグのないソフトウェアを作る
セーフティネットができたら、次のステップ: そもそもAIが隠れたバグを渡してこないようにする。
#github#git#バックアップ#初心者
Ready to build?

Start building in
under 3 minutes

Join 4,200+ builders. No credit card. Build your first app with AI in minutes.