Imported from kyonenya/ai-sdk-tools-playground (AGENTS.md). Install upstream with npx skills add kyonenya/ai-sdk-tools-playground. Copyright stays with the author.

リポジトリガイドライン

プロジェクト構造とモジュール構成

• app: Next.js App Router のソースコード（page, layout, api）
  • app/api/chat/route.ts: AI SDK、MCP、およびツールを使用したストリーミングチャットのエンドポイント
• public: 静的アセット
• config: next.config.ts, open-next.config.ts, wrangler.jsonc, tsconfig.json, eslint.config.mjs, biome.json
• env: .env.local（開発用）, .dev.vars（Wrangler開発用）, .env.sample（テンプレート）

ビルド、テスト、開発コマンド

• pnpm dev: Turbopack を使用して next dev を実行します
• pnpm build: プロダクション用バンドルをビルドします
• pnpm start: プロダクションビルドをサーバーで実行します
• pnpm lint: ESLint を実行（Next の core-web-vitals ルール）
• pnpm format: Biome を使用してコードをフォーマット（2 スペース、ダブルクォート）
• pnpm tsc: TypeScriptの型チェック（ウォッチモード）
• pnpm deploy: OpenNext → Cloudflare Workers経由でビルドとデプロイを実行します
• pnpm preview: Cloudflareプレビューをビルドして起動します
• pnpm cf-typegen: cloudflare-env.d.tsにCloudflareバインディングタイプを生成します

コーディングスタイルと命名規則

• TypeScript は strict モード；2スペースのインデント、80文字の行幅、ダブルクォート（Biome）
• React コンポーネント：pascalCase；変数/関数：camelCase
• アプリルーティングファイルとAPIルート：小文字のフォルダー；APIはapp/api/<name>/route.tsに配置

テストガイドライン

• ユニットテストフレームワークは未設定です。当面は：
  • ローカルでスモークテスト：pnpm build && pnpm start を実行し、app/api/chat を実行
  • テストを追加

エージェントの応答と言語方針

• 既定の言語: 日本語で応答する。
• トーン: 簡潔・友好的・事実ベース。不要な冗長説明は避ける。
• 事前連絡: コマンド実行やパッチ適用前は、1–2文の短い日本語プレアンブルで意図を共有する。
• 計画共有: 作業が複数ステップに及ぶ場合は update_plan を用い、日本語で短いタスク単位の計画を提示・更新する（常に1つが in_progress）。

思考過程の表示方針

• 思考の開示は「要約ベース」で行い、日本語で意図・判断理由・次アクションを簡潔に記述する。
• エラーや不確実性は日本語で明示し、必要な追加情報や代替案を提示する。

実行時メッセージのスタイル

• プレアンブル: 「これから何をするか」を8–12語程度で日本語説明。
• 進捗更新: 長い処理では短い日本語ステータス更新を適宜送る（例: 「設定を確認、次はAPIルート修正」）。
• 最終結果: 変更点・影響・次の提案を日本語で簡潔にまとめる。コマンドやファイルパスはコード体裁で示す。