コメントを整理

control.js

@@ -1,3 +1,19 @@
+/**
+ * control.js - UIコントロールとイベント管理
+ * 
+ * 主な機能:
+ * - サイドバーの制御（表示/非表示、リサイズ）
+ * - キーボードショートカット
+ * - ローカルストレージのクリア
+ * - レイアウトの自動調整
+ * - モデルリストの更新
+ * 
+ * 重要な関数:
+ * - initSidebarResize(): サイドバーのリサイズ機能を初期化
+ * - resizeMain(): メインコンテンツのサイズを調整
+ * - updateModelList(): 利用可能なモデルリストを更新
+ */
+
 updateHistoryList();
 loadFromUserStorage();
 setInterval(() => {

history.js

@@ -1,3 +1,23 @@
+/**
+ * history.js - プロンプト生成履歴の管理
+ * 
+ * 主な機能:
+ * - 履歴の保存と読み込み
+ * - 履歴の検索
+ * - 履歴項目の編集と削除
+ * - ストレージ使用量の表示
+ * 
+ * 重要な関数:
+ * - saveToHistory(): 新しい履歴項目を保存
+ * - updateHistoryList(): 履歴リストを更新
+ * - filterHistory(): 履歴の検索機能
+ * - loadHistoryItem(): 履歴項目を読み込み
+ * 
+ * 注意事項:
+ * - 履歴の最大サイズは3MB
+ * - 容量超過時は古い履歴から自動削除
+ */
+
 function saveToHistory(title) {
     if(!title) {
         title = document.getElementById('query').value.slice(0, 10);

index.html

@@ -5,6 +5,53 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Gemini Prompt Generator</title>
+
+    <!-- 
+    ファイル構成と役割:
+    
+    1. index.html
+       - メインのUIレイアウト
+       - スタイル定義
+       - 外部リソースの読み込み
+    
+    2. prompt.js
+       - Gemini APIとの通信
+       - プロンプト生成のロジック
+       - モデル管理
+       ※ API関連の機能追加はこのファイルに
+    
+    3. storage.js
+       - ローカルストレージの管理
+       - フォームデータの永続化
+       ※ データ保存関連の機能はこのファイルに
+    
+    4. translation.js
+       - 多言語対応
+       - i18next設定
+       - 言語リソース
+       ※ 新しい言語や翻訳文字列の追加はこのファイルに
+    
+    5. control.js
+       - UIイベント管理
+       - レイアウト制御
+       - グローバルショートカット
+       ※ UI操作に関する機能追加はこのファイルに
+    
+    6. history.js
+       - 履歴管理
+       - 履歴検索
+       - 履歴UI
+       ※ 履歴関連の機能追加はこのファイルに
+    
+    開発規約:
+    1. 各ファイルの責務を明確に分離し、機能追加は適切なファイルに行う
+    2. UIコンポーネントの追加は index.html に
+    3. スタイルの追加は index.html の <style> タグ内に
+    4. 新しい機能は既存のファイル構成に従い、適切なファイルに実装
+    5. 共通で使用する定数や設定は storage.js で管理
+    6. 多言語対応が必要な文字列は必ず translation.js に追加
+    -->
+
     <link href="https://unpkg.com/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet" crossorigin="anonymous">
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.2/css/all.min.css"
         crossorigin="anonymous">

prompt.js

@@ -1,3 +1,18 @@
+/**
+ * prompt.js - プロンプト生成の中核機能を提供
+ * 
+ * 主な機能:
+ * - Gemini APIを使用したプロンプト生成
+ * - モデルリストの取得と管理
+ * - プロンプトの生成と整形
+ * - 文字列置換機能
+ * 
+ * 重要な関数:
+ * - getModelList(): 利用可能なGeminiモデルを取得
+ * - generatePrompt(): メインのプロンプト生成処理
+ * - applyReplacements(): 文字列置換を適用
+ */
+
 async function getModelList() {
     const url = 'https://generativelanguage.googleapis.com/v1beta/models?key=' + document.getElementById('apiKey').value;
     const response = await fetch(url);

storage.js

@@ -1,3 +1,15 @@
+/**
+ * storage.js - ローカルストレージを使用したデータ永続化を管理
+ * 
+ * 主な機能:
+ * - フォーム入力値の保存と復元
+ * - 自動保存機能（5秒間隔）
+ * 
+ * 重要な関数:
+ * - saveToUserStorage(): フォームデータを保存
+ * - loadFromUserStorage(): 保存されたデータを復元
+ */
+
 function saveToUserStorage(force = false) {
     const currentTime = new Date().getTime();
     const lastSaveTimestamp = parseInt(localStorage.getItem('lastSaveTimestamp') || '0');

style.css

@@ -1,28 +0,0 @@
-body {
-	padding: 2rem;
-	font-family: -apple-system, BlinkMacSystemFont, "Arial", sans-serif;
-}
-
-h1 {
-	font-size: 16px;
-	margin-top: 0;
-}
-
-p {
-	color: rgb(107, 114, 128);
-	font-size: 15px;
-	margin-bottom: 10px;
-	margin-top: 5px;
-}
-
-.card {
-	max-width: 620px;
-	margin: 0 auto;
-	padding: 16px;
-	border: 1px solid lightgray;
-	border-radius: 16px;
-}
-
-.card p:last-child {
-	margin-bottom: 0;
-}

translation.js

@@ -1,3 +1,16 @@
+/**
+ * translation.js - 多言語対応機能を提供
+ * 
+ * 主な機能:
+ * - i18nextを使用した多言語切り替え
+ * - 8言語対応（日本語、英語、中国語、韓国語、フランス語、スペイン語、ドイツ語、イタリア語）
+ * - UIテキストの動的更新
+ * 
+ * 重要な関数:
+ * - updateContent(): UI要素の翻訳を更新
+ * - changeLang(): 言語切り替えを実行
+ */
+
 const translations = {
     ja: {
         inputQueryTitle: "入力クエリ",