CodeGuide

CodeGuideとは？

CodeGuideは、AIコーディングツール向けの仕様駆動型コンテキスト生成ツールです。アイデアや既存のGitHubコードベースを、PRD、技術仕様、ワイヤーフレームなどの構造化されたプロジェクトドキュメントに変換し、AIモデルがソフトウェア実装時に参照できるようにします。

主な目的は、AI支援開発における「ブラックボックス」問題を軽減することです。説明から始めてもレガシー リポジトリを拡張する場合でも、計画とドキュメントのための明確なコンテキストを持つプロジェクト知識ベースを作成します。

主な機能

• 仕様駆動型ドキュメント生成（自然言語入力）: プロジェクトを自然言語で記述すると、PRD、技術スタックガイダンス、ワイヤーフレームを含むドキュメントキットを生成します。
• 既存GitHubコードベースのドキュメント化: 既存のGitHubプロジェクトを入力してコードベースをマッピングし、AIツールがリポジトリの内容を明確に理解できるようにします。
• AIドキュメントワークフロー（明確化質問 → 計画 → ドキュメント）: プロジェクト概要を提供し、開かれた質問（例: 通知動作、オンボーディング、機能制約）に答えて結果のドキュメントを形成します。
• Software v2自律型コーディングエージェント: コードベースを分析し、ドキュメントを計画、コーディングタスクを長時間のセッションで「自律的」に実行できるエージェントを使用します。
• 複数CLIツール/モデルルーティングの統一インターフェース: 単一のインターフェースで複数AIモデルを同期して動作させ、モデルルーターがワークフローの各部分に適したモデルを選択します。
• ブラウザベース生成のためのChrome拡張: ブラウザから直接PRD、技術仕様、ドキュメントを生成します。
• 画面上UIエディタ: 画面上で編集し、UI修正や機能追加のために複数エージェントを並行して調整します。
• セットアップ負担を軽減するスタータキット: AIコーディングモデル向けのオープンソースボイラープレートには、認証、データベース設定、Stripe決済設定などの共通インフラが含まれています（テンプレートの説明通り）。

CodeGuideの使い方

1. アイデアまたはリポジトリから開始: 構築したいものを自然言語で記述するか、CodeGuideに既存のGitHubプロジェクトを指定します。
2. プロンプトされたプロジェクト質問に回答: 明確化質問を使って製品動作と制約を指定します。
3. ドキュメントキットを生成: 実装に必要な出力（PRD、技術仕様、ワイヤーフレーム、関連計画アーティファクト）を作成します。
4. 実行にSoftware v2を使用: コーディングと実装に移行する場合、自律エージェントを実行してコードベースを分析し、計画されたドキュメントに従います。
5. オプションでChrome拡張を使用: ブラウザワークフロー内でPRD/技術仕様/ドキュメントを生成します。

ユースケース

• アプリアイデアを実装準備完了の仕様に変換: 開発者がアプリコンセプト（例: モバイルアプリ vs. ウェブサイト）を記述し、製品動作質問に答えてPRD、技術仕様、ワイヤーフレームを取得します。
• レガシーGitHubリポジトリをAI開発向けにドキュメント化: 解釈しにくい古いコードで作業する場合、リポジトリを入力してマッピングされ、AIが利用可能なコンテキストを取得し、後続のコーディングタスクに活用します。
• AIコーディングアシスタント使用前に製品要件を計画: 生成された仕様を構造化入力として使用し、AIコーディングツールがアドホックプロンプトではなく明示的な要件に基づいて機能を実装します。
• エージェントで自律コーディングを実行: Software v2を使用して、コードベース分析、計画、コーディング実行を統一インターフェースで長時間のセッションで調整します。
• UIを反復的に改善・拡張: 画面上エディタを使用してUI問題を修正したり機能を追加したりし、複数エージェントを並行動作させます。

FAQ

CodeGuideは説明やリポジトリ、または両方からドキュメントを生成しますか？

CodeGuideは両方をサポートします：自然言語のアイデアからドキュメントを生成でき、GitHubコードベースに対してはリポジトリをAIコンテキストにマッピングしてドキュメントを生成します。

CodeGuideが生成できるドキュメントの種類は？

サイトではPRD、技術仕様、ワイヤーフレームを主要出力として記述し、プロジェクトブリーフに紐づくより広範な「documentation kit」を含みます。

Software v2とは何ですか？

Software v2は、コードベースを分析しドキュメントを計画・実行する自律型コーディングエージェントで、統一インターフェースと複数モデル同期を備えています。

この製品はAIのハルシネーションをどう防ぎますか？

サイトでは、プロジェクト知識ベースと構造化された仕様/コンテキストを作成し、AIモデルが参照できるようにすることで、欠落や不明瞭なコンテキストによる「推測」を減らすアプローチを説明しています。

メインアプリ以外でCodeGuideを使うツールはありますか？

はい。サイトでは、ブラウザから直接PRD、技術仕様、ドキュメントを生成するChrome拡張を挙げています。

代替案

• 手動PRD/技術仕様作成＋AIコーディングアシスタント：自分で（または汎用AIチャットで）ドキュメントを作成しコーディングツールに提供；リポジトリマッピングや構造化生成ワークフローに依存せずユーザー作成仕様に頼ります。
• 汎用AIコーディングコパイロット：コード生成・リファクタリングに特化したツールは、ここで記述されたエンドツーエンドのdocumentation kit（PRD/技術仕様/ワイヤーフレーム）やリポジトリマッピングを提供しない場合があります。
• ドキュメント優先のコードベース分析ツール：ソースコードからドキュメント生成に特化（仕様/PRDワークフローなし）で理解を助けますが、製品要件に紐づく計画アーティファクトを生成しない可能性があります。
• スターターテンプレート/ボイラープレート＋別途計画：ボイラープレートでセットアップ時間を短縮できますが、AIコーディングワークフロー向けにPRD/技術仕様/ワイヤーフレームを生成する別プロセスが必要です。