diff --git a/.gitignore b/.gitignore
index f39db3b..37ea220 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,3 +4,8 @@ Thumbs.db
 
 # Project specific
 *.log
+
+# Development and Tooling
+node_modules/
+.env
+.vscode/
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..87f1e78
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+# Strudel Live Coding with Gemini-CLI
+
+このリポジトリは、`gemini-cli` を活用して高品質な Strudel (TidalCycles for the web) のコードを生成・管理するための開発環境です。
+
+## プロジェクト構成
+
+設定ファイルはすべて `.gemini/` フォルダに集約されています。
+
+- **.gemini/gemini.md**: Gemini へのシステム指示書。出力フォーマット、コーディング規約、公式ドキュメントへの参照が含まれています。
+- **.gemini/reference.md**: Strudel の構文、音色、エフェクト、スタイルテンプレートをまとめたリファレンス辞書です。
+- **.gemini/skills/**: 特定のタスクを実行するためのカスタムスキル定義。
+  - `genre_composer.md`: ジャンル名やサブジャンルを指定して、そのスタイルに最適なコードテンプレートを生成します。
+
+## 使い方
+
+`gemini-cli` を使用して、以下のコマンド例のように指示を出します。
+
+### 1. 基本的なコード生成
+
+システム指示書を読み込み、自由なリクエストを送ります。
+
+```bash
+gemini-cli \
+  --system .gemini/gemini.md \
+  "128BPMで、ミニマルなテクノのコードを生成して"
+```
+
+### 2. ジャンルコンポーザー・スキルを使用する
+
+特定のジャンルに特化したテンプレートを生成したい場合は、スキルファイルをコンテキストに追加します。
+
+```bash
+gemini-cli \
+  --system .gemini/gemini.md \
+  --context .gemini/skills/genre_composer.md \
+  "Genre: Dub Techno"
+```
+
+## コーディング指針
+
+- すべてのコードは `setcps(BPM/60/4)` で開始されます。
+- 各トラックは `$: ` 記法を使用して独立して制御可能です。
+- プロフェッショナルな音響を実現するため、ステレオ感（`.jux()`）や空間系（`.room()`）のエフェクトが積極的に適用されます。
\ No newline at end of file