From 671d3c256e0bf6a3aa927b6d78f658414a537000 Mon Sep 17 00:00:00 2001 From: emahiro Date: Thu, 26 Jun 2025 00:06:25 +0900 Subject: [PATCH] feat: add GEMINI.md --- GEMINI.md | 102 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 GEMINI.md diff --git a/GEMINI.md b/GEMINI.md new file mode 100644 index 0000000..c53ff6e --- /dev/null +++ b/GEMINI.md @@ -0,0 +1,102 @@ +# GEMINI.md + +このファイルは、このリポジトリでコードを操作する際にClaude Code (claude.ai/code) にガイダンスを提供します。 + +## リポジトリ概要 + +これは複数の実験的なアプリケーションとツールを含むLLMの開発練習用リポジトリです。 + +## プロジェクト構造 + +このリポジトリには複数の独立したアプリケーションが含まれています： + +### ルートレベル +- ルートのpackage.jsonはBiomeによる共通フォーマット/リントを提供 +- 環境設定用のMakefile（.env → .envrc変換） +- タブインデントを使用（biome.jsonで設定） + +### サブアプリケーション + +1. **pomodoro-timer-by-copilot-claude4/** - SQLiteを使ったNext.jsポモドーロタイマー + - コマンド: `npm run dev`, `npm run build`, `npm run lint` + - セッション履歴保存にbetter-sqlite3を使用 + - TailwindCSSスタイリング、TypeScript + +2. **pomodoro-timer-by-jules/** - 代替ポモドーロ実装 + - 同様の構造だが実装アプローチが異なる + +3. **my-fastmcp-app/** - FastMCPアプリケーション + - コマンド: `npm start` (`npx fastmcp dev src/index.ts`を実行) + - Google GenAI統合を使用 + +4. **my-mastra-app/** - Mastraフレームワークアプリケーション + - コマンド: `npm run dev` (`mastra dev`を実行) + - @mastra/coreとGoogle AI SDKを使用 + +5. **claude-code-test/** - 基本的なJavaScriptテストファイル + +## 共通コマンド + +### ルートレベル +- `pnpm run format` - Biomeでコードをフォーマット +- `pnpm run lint` - Biomeでリント・自動修正 +- `pnpm run check` - Biomeの完全チェックを実行 +- `pnpm install` - 全ての依存関係をインストール +- `make setup-env` - direnv用に.envを.envrcに変換 +- `make clean` - 一時ファイルを削除 +- `make install` - 全ての依存関係をインストール +- `make format` - 全てのコードをフォーマット +- `make lint` - 全てのコードをリント + +### Next.jsプロジェクト (pomodoro-timer-*) +- `pnpm run dev` - 開発サーバーを起動（ポート3000） +- `pnpm run build` - 本番用ビルド +- `pnpm run lint` - ESLintチェック + +### MCP/Mastraプロジェクト +- 各package.jsonで定義されたstart/devコマンドを使用（pnpm経由で実行） + +## コードスタイルガイドライン + +.cursor/rules/common-rules.mdcに基づく： +- 要求された内容を正確に実行 - 追加機能なし +- 創意的な拡張なしに指定された要件を正確に実装 +- すべての要件を満たす最もシンプルなソリューションを使用 +- タスクを完了しながらコード行数を最小化 + +## フォーマット設定 + +- フォーマットとリントにBiomeを使用 +- タブインデント（幅：2） +- JavaScriptにはダブルクォート +- 推奨リントルールを有効化 + +## Design Directory ルール + +### 概要 +llmlab 内でのアプリケーション開発・変更時は、必ず `./design` ディレクトリ配下の設計ドキュメントを参照すること。 + +### ディレクトリ構造 +``` +./design/ +├── pomodoro-timer-by-copilot-claude4.md +├── pomodoro-timer-by-jules.md +├── my-fastmcp-app.md +├── my-mastra-app.md +└── claude-code-test.md +``` + +### 運用ルール +1. **開発前の確認**: アプリケーションの開発・変更を行う前に、該当する design ドキュメントを必ず読む +2. **設計ドキュメントの更新**: アプリケーションに変更を加えた場合は、対応する design ドキュメントも同時に更新する +3. **新規アプリケーション**: 新しいアプリケーションを作成する場合は、`./design/{application_name}.md` 形式で設計ドキュメントを作成する +4. **アーキテクチャの一貫性**: design ドキュメントに記載されたアーキテクチャ・技術スタック・開発ガイドラインに従う + +### 設計ドキュメントの内容 +各設計ドキュメントには以下の情報を含める： +- 概要とアーキテクチャ +- 技術仕様（フレームワーク、言語、依存関係） +- 機能要件 +- 開発コマンド +- セットアップ手順 +- 開発ガイドライン \ No newline at end of file