Claude Codeをもう少しうまく使う方法について、自分なりのやり方を共有したいです。

問題

バイブコーディングでプロジェクトを始めると、最初の数時間は新世界です。プロンプトを投げればコードが出てきて、何かが動いているように見えて、「これ、本当に自分で作っているのか？」と思う瞬間が来ます。

そしてエラーが出始めます。

直してほしいと頼むと別の場所が壊れ、30分もするとAIはさっき自分が言ったことを忘れ、1時間もすると自分も今何を作っていたのか分からなくなります。翌日にまた開くと白紙の状態です。結局、同じ場所をぐるぐる回ることになります。

複数のプロジェクトを同時に進めると、さらにひどくなります。月曜日にやっていたことを木曜日に再開しようとすると、コンテキストを最初からまたセットし直さなければなりません。

原因

ボトルネックはコードにあるのではありませんでした。記憶にありました。

AIはセッションが切れると忘れ、私も数日たてば忘れます。なのに誰も記録しないので、プロジェクトはずっと初期化され続けます。

試した方法

Obsidianをプロジェクトの長期記憶ストレージとして使い始めました。

• Obsidian — 企画、設計、セッションログ、エラー記録をすべてMarkdownで管理
• Claude Desktop + MCP — Obsidianノートを直接読み、設計を議論する「指揮者」の役割
• Claude Code + MCP — 設計が終わった作業を実際に実装する「実行者」の役割

Claude Desktopのコンテキスト喪失問題は、日付_handoff.md ファイルにセッション間の引き継ぎを記録することで解決しました。新しいセッションを開くときはこのファイルだけ読めば、文脈がすぐに復元されます。

核心は 「記録 → 設計 → 実装 → 記録」 のサイクルを繰り返すことでした。

結果

以前はトイプロジェクトを始めては3日でフォルダを削除することを繰り返していましたが、この方法に変えてからは、完成できなかったプロジェクトが一つずつ一次完成 → デプロイ → 検収 → 修正のサイクルで回り始めました。現在は10個以上のプロジェクトをObsidianキャンバスで同時に管理しています。

最近Claude CodeにAuto Memory機能が追加されましたが、これはAIがAIのために書くメモであり、上の方法は人間が人間のために書く記録です。お互いを補完する関係だと考えています。

まとめ

このワークフローを整理して、WikiDocsで書籍として公開しました。全文無料です。

「バイブコーディングはなぜ失敗するのか — AI協業ガイドブック」 https://wikidocs.net/book/19307

プロローグ〜Ch.22 + 付録まであり、フィードバックは各ページのコメントに残していただければすぐ反映します。手厳しいひと言も歓迎します。

[runableapp]

Cursor を使っていますが、そういうケース（途中で忘れるケース）を経験していないので、Claude でそういう話をたまに読むと不思議に思います。品質が低かったり、正確に明示していなかったことでそうなる場合はあっても、途中で忘れることはありませんでしたし、別の箇所でエラーが出て困るケースも、Cursor 製品の初期には何度かありましたが、今はそういうことはありません。私のプロジェクトが十分に大きくないからでしょうか?

私はこんなやり方をしています:

• 大まかな構想、方法、似たようなやり方があればそれも明記して、10〜20行くらいの文書を書きます。
• それを読ませて、構想とアーキテクチャ、テスト、プランを書いて詳しい文書にまとめるように指示します。私に質問があればするようにも伝えます。（すると、番号を選ぶ形式でよく質問してきます。）そしてそれについて話し合いながら仕上げます。別途 Gemini と会話して追加の調査も行い、その内容についても一緒に話します。
• そして完成した文書をレビューし、また対話しながら少しずつ修正していき、その後で作るように命じます。作りながら完成した部分には完了と表示し、その文書を更新しつつ進めるようにします。さらに、時間がかかるほど大きいものや複雑なものについては、Cursor ルールに毎日何をしたかを別の文書に記録するよう指示します。

文書はプロジェクト内にあるので、特別に別管理する必要はありません。そして Cursor は作業を継続し続けるわけではありません。どれだけ最後までやれと言っても、いつも途中で止まってしまい（これが変なループに入らないための安全装置だとは聞いていますが、私に選択権がないのは不満です）、対話を強制してきます。それはそれで役に立ちます。数時間後に見たらまったく見当違いなものができてしまう余地を減らせる面もあります。

1つの IDE の中ですべて処理するので、ほかのサービスを付け足す必要もありません。Claude は API で LLM 機能だけ使ったことがあるので、コーディングについては多くの人が良いと言っていますが、実際どうなのかは分かりません。ただ、こういう「忘れる」とか「エラーが出る」という話をたまに見ると、プロジェクトの規模が小さいからなのかな……と思うこともあります。

結論としては、会社でプロジェクトやチームを管理するときのように進めています。人と進めるときと同じ進め方、つまり文書化と記録、対話、意思決定です……新しいワークフローでもありません。だからこそ、Claude でどんなワークフローを使って「完全自動」でやったのかというやり方にはとても興味がありますし、完全自動でないとしても、頻繁な「ミーティング」（人で構成されたチームでも頻繁なミーティングは減らそうとしますよね）をどう減らせるか考えています。

[pari0130]

qmd というものを使うと、以前のセッション管理のためのデータベースをローカルで管理してくれます！

[sharpscar]

有益な情報をありがとうございます。