docs: update README.md for skill-based workflow

readme.md

@@ -2,46 +2,50 @@
 
 このプロジェクトは、Strudel ライブコーディングの試行錯誤を記録するノートブックであり、Gemini CLI のカスタムスキルを活用して楽曲制作を加速させるための環境です。
 
-東京の電子音楽シーンの感性を持つ AI アシスタント「ボク」が、君の音楽制作を強力にサポートします。
+東京の電子音楽シーンの感性を持つ AI アシスタント「ボク」が、君の音楽制作をプロの視点から強力にサポートするよ。
 
 ## 🚀 主な機能
 
 ### 1. テンプレート生成 (`generate-strudel-template`)
-指定したジャンル（Techno, House, Dub Techno, Hypnotic Techno など）に基づき、即座に演奏可能な Strudel コードと音楽的解説を生成します。
+Techno, House, Dub Techno, Minimal など、指定したジャンルに基づき、即座に演奏可能な Strudel コードと音楽的解説を生成します。
-生成されたファイルは `strudel/` ディレクトリに保存されます。
+- `strudel/` ディレクトリに新しいアイデアとして保存されます。
+- プロフェッショナルなリズムパターンと音色設定が含まれます。
 
 ### 2. 構文修正 & 解説 (`fix-and-explain-strudelcode`)
-君が書いた Strudel コードのエラー（`~` の誤用など）を最小限の修正で解決し、楽曲の音楽的な意図をプロの視点から解説します。
+Strudel コードのエラーを修正し、楽曲の意図を汲み取った解説を加えます。
-修正版は `explained/` ディレクトリに保存され、オリジナルのファイルは保護されます。
+- 修正版は `explained/` ディレクトリに保存されます。
+- 単なる修正に留まらず、音楽的なアドバイスも提供します。
 
 ## 📁 ディレクトリ構成
 
-- `strudel/`: 楽曲のアイディアや生成されたテンプレート（Markdown）
+- `strudel/`: ライブコーディングのノート（Markdown形式）。日付ベースの記録やジャンル別スケッチ。
-- `explained/`: AI によって修正・解説された楽曲データ
+  - `samples/`: プロジェクト固有のオーディオサンプル。
-- `.gemini/skills/`: Gemini CLI 用のカスタムスキル定義
+- `explained/`: `fix-and-explain-strudelcode` スキルによって生成された修正・解説済みファイル。
-- `.gemini/REFERENCE.md`: Strudel の最新構文や音源のリファレンス
+- `.gemini/skills/`: Gemini CLI 用のカスタムスキル実体。
-- `script/`: バッチ処理用のユーティリティスクリプト
+- `.gemini/REFERENCE.md`: Strudel の最新構文や推奨パターンをまとめたリファレンス。
+- `PRECAUTIONS.md`: 過去のミスから学んだ、高品質なコード生成のための注意守則。
+- `fix-and-explain-strudelcode/`, `generate-strudel-template/`: スキルのソースコード一式。
 
 ## 🛠 使い方
 
-### スキルの有効化
+このプロジェクトでは、Gemini CLI のカスタムスキルを直接呼び出すことで制作をサポートします。
-このプロジェクトを初めて使用する場合や、スキルを更新した後は以下のコマンドを実行してください。
-```bash
-gemini skills reload
-```
 
-### テンプレートの生成
+### スキルの活用
-Gemini CLI に対して、作りたいジャンルを伝えてください。
+Gemini CLI に対して、以下のように話しかけてみて。
-> "Dub Techno のテンプレートを生成して"
 
-### コードのデバッグ
+- **新しいトラックを始めたいとき**
-作成中のコードに問題がある場合や、プロの解説が欲しい場合に依頼してください。
+  > "Minimal Techno のテンプレートを作って"
-> "strudel/my_beat.md のエラーを直して解説して"
+- **コードが動かない、または洗練させたいとき**
+  > "strudel/20260215.md のエラーを直して解説して"
 
-## 🎵 制作のポリシー
+## 🎵 制作のポリシー & 品質管理
-- **Initialization**: すべてのコードは `setcps(BPM/60/4)` で開始します。
+
-- **Modular Control**: 各トラックは `$: ` 記法で独立して制御します。
+ボクが生成するコードは、以下のルールと知見に基づいているよ。
-- **Clean Syntax**: 休符には `-` を使い、可読性の高いコードを目指します。
+
+- **Initialization**: `setcps(BPM/60/4)` で開始し、グリッドの整合性を保つ。
+- **Modular Control**: `$: ` 記法で各トラックを独立させ、ライブ演奏での操作性を確保。
+- **Clean Syntax**: 休符には `-` を使用。
+- **Best Practices**: `PRECAUTIONS.md` に基づき、音源バンクの整合性やフィルターの特性（TB-303スタイルなど）を最適化。
 
 ---
 Happy Live Coding! 🎛️✨