nykooi1/vibe-wise

VibeWise – 学習に焦点を当てた AI ガイド付きコーディング

概要

• Anthropic の Claude Code と OpenAI の Codex 用のプラグインで、コード生成ワークフローに学習モードを追加します。
• AI はまずアプローチの概要を尋ね、トレードオフについて議論し、コードを作成する前に馴染みのない概念を説明します。
• 設計を確認すると、AI が実装を生成し、何が変更されたか、その理由について簡潔なレポートを提供します。

対象者

• 開発中に理解を深めたいジュニア開発者やすべての人。
• 新しいスタックやアーキテクチャを構造的に探求する必要がある経験豊富なエンジニア。
• 設計上の決定を明確にし、コードの所有権を維持したいチーム。

仕組み

1. インストール – Claude Code の組み込み Anthropic Directory からインストールします（/plugin install vibe-wise@anthropic-plugin-directory）。または GitHub マーケットプレイスから。Codex の場合は、マーケットプレイスを追加し、codex plugin add vibe-wise@vibe-wise でインストールします。
2. 学習セッションを開始 – /vibe-wise:learn（Claude Code）または $vibe-wise:learn（Codex）を実行します。プラグインは一連のチェックポイントをガイドします。
   • ビルド – AI と一緒に問題を推論します（例：メモとフォルダーの関係）。
   • 設計 – AI が設計を提案します。確認して続行または議論を選択できます。
   • 実装 – 承認すると、AI がコードを作成し、テストを実行し、変更を報告します。
3. メモとコンテキスト – すべての決定、図、説明は、プロジェクト内の隠しフォルダー .vibe-wise/ に保存されます。これらのメモは将来のセッションで AI のコンテキストに自動的に追加され、アシスタントが以前の議論を記憶します。
4. 設定 – 学習レベル（初級、中級、上級）を設定し、チェックポイントの頻度や質問スタイルなどをその場で調整できます。
5. リセット / 更新 – /vibe-wise:reset で最初からやり直すか、通常の Claude Code または Codex プラグイン更新コマンドでプラグインを更新します。

主な機能

• コード生成前の対話型設計ディスカッション。
• 説明優先アプローチ – AI が概念、トレードオフ、馴染みのない部分を説明します。
• チェックポイントシステム – 構造化されているがオプションのステージ（ビルド、設計、実装）で、明確な「確認」または「議論」アクションがあります。
• 永続的な学習メモ – ローカルに保存され、バージョン管理され、デフォルトで Git に無視されます。
• 外部依存関係ゼロ – Python 3 のみが必要です。プラグインはホスト IDE/アシスタント内で実行されます。

重要性

• AI 支援コーディングをブラックボックスのコード出力から、構築しながら学ぶ体験に変えます。
• 開発者がアーキテクチャ上の決定の所有権を保持し、生成されたコードを理解するのに役立ちます。
• 単純なスクリプトからフルスタックアプリまで、あらゆるプロジェクトに適用できる再利用可能なワークフローを提供します。

ライセンス

• MIT ライセンスの下でオープンソースであり、商用利用、変更、再配布が許可されています。