AITuber開発日誌 1-3　環境設定_3　自動でファイル作成

まず、AITuberの「家」となるフォルダを作ります。

1. PC上の適当な場所（デスクトップなど）に新しいフォルダを作成します（例：my-aituber）。

2. Cursorのメニューから File > Open Folder... を選択し、作成したフォルダを開きます。

Cursorには、AIにプロジェクト固有のルールを記憶させる機能があります。これにより、AIが勝手に古い書き方をしたり、不適切なコードを書くのを防ぎます。

1. Cursorのファイルエクスプローラーで、プロジェクトルート（一番上の階層）に .cursor というフォルダを作成します。

2. その中に rules というフォルダを作成します。

3. rules フォルダの中に、global_architecture.mdc というファイルを作成し、以下の内容をコピペして保存してください。これはAITuber開発の「憲法」になります。

---
description: プロジェクト全体のアーキテクチャとコーディング規約
globs: *.py
alwaysApply: true
---

# 基本原則
あなたはPythonによるAITuberシステムの専門開発者です。以下の原則を厳守してください。

1. 完全非同期駆動:
   - すべてのI/O操作（API通信、ファイル読み書き、待機）は `asyncio` を使用した非同期処理として実装してください。
   - `requests` ライブラリの使用は禁止です。代わりに `aiohttp` または `httpx` を使用してください。
   - `time.sleep()` は禁止です。必ず `await asyncio.sleep()` を使用してください。

2. 型安全性とドキュメント:
   - すべての関数・メソッドにはPythonの型ヒント（Type Hints）を付与してください。
   - DocstringはGoogleスタイルで記述し、引数、戻り値、発生しうる例外を明記してください。

3. エラーハンドリング:
   - 例外を握りつぶす（passのみ）処理は禁止です。必ず `loguru` を使用してエラーログを出力してください。
   - API通信などの不安定な処理には、リトライロジックを実装してください。

4. 構成管理:
   - APIキーや設定値はコードにハードコーディングせず、環境変数（.env）または設定クラスから読み込んでください。

AITuber開発に必要な外部ツールの説明書（ドキュメント）をCursorに読ませます。これにより、AIが最新のAPI仕様に基づいてコードを書けるようになります。

1. Cursorの設定を開きます（Cmd + , または Ctrl + ,）。

2. Features > Docs に移動します。

3. Add new doc をクリックし、以下のURLを登録してください。

    ◦ VTube Studio API: https://github.com/DenchiSoft/VTubeStudio

    ◦ OpenAI Python SDK: https://github.com/openai/openai-python

    ◦ VOICEVOX Engine API: https://voicevox.github.io/voicevox_engine/api/

    ◦ Pytchat (コメント取得): https://pypi.org/project/pytchat/

※ 名前（Prefix）は「VTubeStudio」「OpenAI」「VoiceVox」「Pytchat」など分かりやすいものを付けてください。

最後に、Cursorの強力な機能「Composer」を使って、必要なファイル構成を一気に作ります。

1. Cmd + I （Windowsは Ctrl + I）を押して、Composer（小さな入力ウィンドウ）を開きます。

2. 以下のプロンプト（命令文）をコピペして送信（Enter）してください。

現在のディレクトリに、AITuber開発用のPythonプロジェクト構造を作成してください。
モジュラーモノリス構成を採用し、以下のディレクトリと空ファイルを作成してください。

構成:
- config/settings.py (環境変数管理)
- core/orchestration.py (メインループ制御)
- core/logger.py (ログ設定)
- modules/perception/youtube.py (コメント取得)
- modules/cognition/llm_client.py (OpenAI連携)
- modules/cognition/memory.py (記憶管理)
- modules/expression/voicevox.py (音声合成)
- modules/expression/vtube_studio.py (アバター制御)
- main.py (エントリーポイント)
- requirements.txt (依存ライブラリ)
- .env (APIキー用テンプレート)
- .gitignore (Python推奨設定)

requirements.txtには以下を含めてください:
openai, pytchat, aiohttp, python-dotenv, loguru, websockets, pydantic-settings
3. Cursorが作成計画（Plan）を提示するので、「Accept All」（または Save All）をクリックして実行します。

通常のチャットやインライン編集（Cmd + K）は、基本的に「開いているファイル」や「選択した箇所」の修正が得意ですが、Composerは一度の指示で複数のファイルやフォルダを同時に新規作成・編集できます。今回の「ディレクトリ構造と空ファイルを一気に作る」という作業に最適です。

Composerはプロジェクト全体の文脈（Context）を理解し、ファイル間の整合性を保ちながらコードを書くことができます。

指示を受けると、AIがいきなり書き始めるのではなく、まず「どのファイルを作成し、どう編集するか」という**計画（Plan）**を提示します。ユーザーがそれを確認して「Accept（適用）」することで、安全に大規模な変更を行えます。