next2d-development-mcp 0.0.2 → 0.0.4

package/README.md

@@ -1,9 +1,15 @@
 # next2d-development-mcp
 
 <div align="center">
-  <img src="https://next2d.app/assets/img/logo.svg" width="180" alt="Next2D">
+  <img src="https://next2d.app/assets/img/top-logo.svg" width="180" alt="Next2D">
 </div>
 
+[![UnitTest](https://github.com/Next2D/next2d-development-mcp/actions/workflows/integration.yml/badge.svg?branch=main)](https://github.com/Next2D/next2d-development-mcp/actions/workflows/integration.yml)
+[![CodeQL](https://github.com/Next2D/next2d-development-mcp/actions/workflows/github-code-scanning/codeql/badge.svg?branch=main)](https://github.com/Next2D/next2d-development-mcp/actions/workflows/github-code-scanning/codeql)
+[![Lint](https://github.com/Next2D/next2d-development-mcp/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/Next2D/next2d-development-mcp/actions/workflows/lint.yml)
+
+[![release](https://img.shields.io/github/v/release/Next2D/next2d-development-mcp)](https://github.com/Next2D/next2d-development-mcp/releases)
+
 [Next2D](https://next2d.app) アプリケーション開発を支援する **MCP (Model Context Protocol) サーバー**です。  
 [framework-typescript-template](https://github.com/Next2D/framework-typescript-template) を使った **MVVM + Clean Architecture + Atomic Design** パターンに従ったコード生成、アーキテクチャ検証、API リファレンスを提供します。
 
@@ -66,7 +72,7 @@ Create `.vscode/mcp.json` at the project root:
   "servers": {
     "next2d": {
       "command": "npx",
-      "args": ["next2d-development-mcp"]
+      "args": ["-y", "next2d-development-mcp"]
     }
   }
 }
@@ -97,7 +103,7 @@ Edit the configuration file:
   "mcpServers": {
     "next2d": {
       "command": "npx",
-      "args": ["next2d-development-mcp"]
+      "args": ["-y", "next2d-development-mcp"]
     }
   }
 }
@@ -116,7 +122,7 @@ Create `.mcp.json` at the project root:
   "mcpServers": {
     "next2d": {
       "command": "npx",
-      "args": ["next2d-development-mcp"]
+      "args": ["-y", "next2d-development-mcp"]
     }
   }
 }
@@ -126,7 +132,7 @@ Create `.mcp.json` at the project root:
 Or add directly via CLI:
 
 ```bash
-claude mcp add next2d -- npx next2d-development-mcp
+claude mcp add next2d -- npx -y next2d-development-mcp
 ```
 
 ### OpenAI Codex (ChatGPT CLI)
@@ -139,12 +145,16 @@ Create `.codex/mcp.json` at the project root:
   "mcpServers": {
     "next2d": {
       "command": "npx",
-      "args": ["next2d-development-mcp"]
+      "args": ["-y", "next2d-development-mcp"]
     }
   }
 }
 ```
 
+> `npm` キャッシュ権限エラー (`EPERM`, `~/.npm/_npx`) が出る場合はキャッシュ先を明示してください。  
+> If npm cache permission errors occur, set a writable cache path:
+> `"args": ["-y", "--cache", "/tmp/next2d-mcp-npm-cache", "next2d-development-mcp"]`
+
 ### Gemini CLI
 
 プロジェクトルートに `.gemini/settings.json` を作成します。  
@@ -155,7 +165,7 @@ Create `.gemini/settings.json` at the project root:
   "mcpServers": {
     "next2d": {
       "command": "npx",
-      "args": ["next2d-development-mcp"]
+      "args": ["-y", "next2d-development-mcp"]
     }
   }
 }
@@ -176,7 +186,7 @@ Add the MCP server from Cline settings:
   "mcpServers": {
     "next2d": {
       "command": "npx",
-      "args": ["next2d-development-mcp"]
+      "args": ["-y", "next2d-development-mcp"]
     }
   }
 }
@@ -195,7 +205,7 @@ Add to Cursor settings:
   "mcpServers": {
     "next2d": {
       "command": "npx",
-      "args": ["next2d-development-mcp"]
+      "args": ["-y", "next2d-development-mcp"]
     }
   }
 }
@@ -213,7 +223,7 @@ Add to Windsurf MCP configuration:
   "mcpServers": {
     "next2d": {
       "command": "npx",
-      "args": ["next2d-development-mcp"]
+      "args": ["-y", "next2d-development-mcp"]
     }
   }
 }
@@ -227,7 +237,7 @@ MCP uses the standard **stdio** transport protocol. Configure the following comm
 
 ```
 command: npx
-args: next2d-development-mcp
+args: -y next2d-development-mcp
 ```
 
 ---

package/dist/references/develop-specs.md

@@ -1,17 +1,16 @@
-# Next2D Framework TypeScript Template - Development Specs
+# Next2D Framework TypeScript Template - 開発仕様
 
-## Table of Contents
+## 目次
 
-1. [Overview](#next2d-framework-typescript-template---overview)
-2. [CLI Commands Reference](#cli-commands-reference)
-3. [Configuration Files](#configuration-files)
-4. [Interface Definitions](#interface-definitions)
-5. [Model Layer (Application / Domain / Infrastructure)](#model-layer-application--domain--infrastructure)
-6. [UI Layer (Components / Animation / Content)](#ui-layer-components--animation--content)
-7. [View / ViewModel (MVVM Pattern)](#view--viewmodel-mvvm-pattern)
+1. [概要](#next2d-framework-typescript-template---overview)
+2. [CLIコマンドリファレンス](#cli-commands-reference)
+3. [設定ファイル](#configuration-files)
+4. [インターフェース定義](#interface-definitions)
+5. [Modelレイヤー (Application / Domain / Infrastructure)](#model-layer-application--domain--infrastructure)
+6. [UIレイヤー (Components / Animation / Content)](#ui-layer-components--animation--content)
+7. [View / ViewModel (MVVMパターン)](#view--viewmodel-mvvm-pattern)
 
 ---
-
 # Next2D Framework TypeScript Template - Overview
 
 ## Project Summary
@@ -903,50 +902,6 @@ ui/
 
 ---
 
-## DisplayObject 配置の基本方針（中心基準点パターン）
-
-Next2D の座標系は画面左上 (0, 0) が基準点。Shape や Sprite をそのまま配置すると、スケールや回転アニメーション時に座標がずれる。
-**基本方針として、子要素を親 Sprite に中心配置する。**
-
-### パターン: Shape を Sprite に中心配置
-
-```typescript
-const sprite = new Sprite();
-const shape  = new Shape();
-
-// 画像の場合、Retina対応でスケールを設定
-shape.scaleX = shape.scaleY = 0.5;
-
-// スケール設定後に中心配置
-shape.x = -shape.width  / 2;
-shape.y = -shape.height / 2;
-
-sprite.addChild(shape);
-```
-
-### パターン: Sprite を Sprite に中心配置
-
-```typescript
-const parent = new Sprite();
-const child  = new Sprite();
-
-// 子要素のサイズ確定後に中心配置
-child.x = -child.width  / 2;
-child.y = -child.height / 2;
-
-parent.addChild(child);
-```
-
-### なぜ中心配置が必要か
-
-- スケール・回転は DisplayObject の (0, 0) を基点に実行される
-- 中心配置しないと、回転・拡縮時に意図しない位置ずれが発生する
-- 中心配置により、親 Sprite の (x, y) がそのまま表示上の中心座標になる
-
-**注意:** すべてのケースで必須ではないが、アニメーション対象の要素には基本的にこのパターンを適用する。
-
----
-
 ## Atomic Design Hierarchy
 
 ### Atom (原子) - 最小単位
@@ -954,7 +909,7 @@ parent.addChild(child);
 最も基本的なUI要素。これ以上分割できない。
 
 ```typescript
-// ButtonAtom: ボタンの基本機能 (enable/disable による連続押下防止機能付き)
+// ButtonAtom: ボタンの基本機能
 import { Sprite } from "@next2d/display";
 
 export class ButtonAtom extends Sprite
@@ -964,34 +919,6 @@ export class ButtonAtom extends Sprite
         super();
         this.buttonMode = true;
     }
-
-    /**
-     * @description ボタンを有効化する
-     *              Enable button
-     *
-     * @return {void}
-     * @method
-     * @public
-     */
-    enable (): void
-    {
-        this.mouseEnabled  = true;
-        this.mouseChildren = true;
-    }
-
-    /**
-     * @description ボタンを無効化する
-     *              Disable button
-     *
-     * @return {void}
-     * @method
-     * @public
-     */
-    disable (): void
-    {
-        this.mouseEnabled  = false;
-        this.mouseChildren = false;
-    }
 }
 ```
 
@@ -1014,86 +941,6 @@ export class TextAtom extends TextField implements ITextField
 }
 ```
 
-### ボタン連続押下防止パターン
-
-ボタン押下後に処理が完了するまで連続押下を防止したい場合に使えるパターン。`ButtonAtom` の `disable()` / `enable()` を利用して `mouseEnabled` と `mouseChildren` を制御する。
-
-連続押下を防止するかどうかはユースケースに応じて判断する。画面遷移やAPI通信など多重実行を避けたい処理では有効。
-
-#### View でのイベント登録パターン
-
-```typescript
-// View: ボタン押下時にViewModelのハンドラを呼び出す
-async initialize (): Promise<void>
-{
-    const btn = new YourBtnMolecule();
-    btn.addEventListener(PointerEvent.POINTER_DOWN, (event) => {
-        this.vm.handleButtonTap(event);
-    });
-    this.addChild(btn);
-}
-```
-
-#### ViewModel での連続押下防止パターン
-
-```typescript
-// ViewModel: disable → 処理 → enable で連続押下を防止
-handleButtonTap (event: PointerEvent): void
-{
-    // ボタンを即座に無効化して連続押下を防止
-    const button = event.currentTarget as unknown as ButtonAtom;
-    button.disable();
-
-    // 処理実行 (画面遷移、API呼び出し、アニメーション等)
-    this.someUseCase.execute();
-
-    // 処理完了後にボタンを再有効化 (画面遷移の場合は不要)
-    button.enable();
-}
-```
-
-#### 非同期処理での連続押下防止パターン
-
-```typescript
-// ViewModel: 非同期処理の完了を待ってから再有効化
-async handleButtonTap (event: PointerEvent): Promise<void>
-{
-    const button = event.currentTarget as unknown as ButtonAtom;
-    button.disable();
-
-    try {
-        await this.fetchDataUseCase.execute();
-    } finally {
-        // エラー時も必ず再有効化
-        button.enable();
-    }
-}
-```
-
-#### アニメーション完了後に再有効化するパターン
-
-```typescript
-// ViewModel: アニメーション完了コールバックで再有効化
-handleButtonTap (event: PointerEvent): void
-{
-    const button = event.currentTarget as unknown as ButtonAtom;
-    button.disable();
-
-    new SomeAnimation(button, () => {
-        // アニメーション完了後に再有効化
-        button.enable();
-    }).start();
-}
-```
-
-#### 連続押下を許可するケース
-
-以下のケースでは `disable()` / `enable()` を使わず、連続押下を許可する:
-
-- **インクリメント/デクリメントボタン**: 数量の増減など、連打を前提とした操作
-- **連射系ゲーム操作**: 連続タップがゲームメカニクスの一部である場合
-- **トグルボタン**: ON/OFF を素早く切り替える必要がある場合
-
 ### Molecule (分子) - Atomの組み合わせ
 
 複数のAtomを組み合わせた、特定の用途向けコンポーネント。
@@ -1574,3 +1421,4 @@ homeContentPointerDownEvent(event: PointerEvent): void {
     this.startDragUseCase.execute(target);
 }
 ```
+

package/dist/references/framework-specs.md

@@ -1,6 +1,6 @@
-# Next2D Framework Specs - Combined Reference
+# Next2D Framework Specs - 統合リファレンス
 
-## Table of Contents
+## 目次
 
 1. [Index - フレームワーク概要](#index---フレームワーク概要)
 2. [AnimationTool連携](#animationtool連携)
@@ -9,23 +9,22 @@
 5. [View と ViewModel](#view-と-viewmodel)
 
 ---
+# Next2D Framework
 
-# Index - フレームワーク概要
+Next2D Frameworkは、Next2D Playerを用いたアプリケーション開発のためのMVVMフレームワークです。シングルページアプリケーション（SPA）のためのルーティング、View/ViewModel管理、環境設定管理などの機能を提供します。
 
-Next2D Framework is an MVVM framework for application development using the Next2D Player. It provides routing, View/ViewModel management, configuration management, and other features for single-page applications (SPAs).
+## 主な特徴
 
-## Key Features
+- **MVVMパターン**: Model-View-ViewModelパターンによる関心の分離
+- **クリーンアーキテクチャ**: 依存性の逆転と疎結合な設計
+- **シングルページアプリケーション**: URLベースのシーン管理
+- **Animation Tool連携**: Animation Toolで作成したアセットとの連携
+- **TypeScriptサポート**: 型安全な開発が可能
+- **アトミックデザイン**: 再利用可能なコンポーネント設計を推奨
 
-- **MVVM Pattern**: Separation of concerns through Model-View-ViewModel architecture
-- **Clean Architecture**: Dependency inversion and loosely coupled design
-- **Single Page Application**: Scene management based on URLs
-- **Animation Tool Integration**: Integration with assets created in Animation Tool
-- **TypeScript Support**: Type-safe development capability
-- **Atomic Design**: Component design promoting reusability
+## アーキテクチャ概要
 
-## Architecture Overview
-
-This project combines clean architecture with the MVVM pattern.
+このプロジェクトはクリーンアーキテクチャとMVVMパターンを組み合わせて実装されています。
 
 ```mermaid
 graph TB
@@ -63,53 +62,53 @@ graph TB
     InfraLayer -.->|accesses| ExternalAPI
 ```
 
-### Layer Responsibilities
+### レイヤーの責務
 
-| Layer | Path | Role |
+| レイヤー | パス | 役割 |
 |----------|------|------|
-| **View** | `view/*`, `ui/*` | Screen structure and display |
-| **ViewModel** | `view/*` | Bridging View and Model, event handling |
-| **Interface** | `interface/*` | Abstraction layer, type definitions |
-| **Application** | `model/application/*/usecase/*` | Business logic implementation (UseCase) |
-| **Domain** | `model/domain/*` | Core business rules |
-| **Infrastructure** | `model/infrastructure/repository/*` | Data access, external API integration |
+| **View** | `view/*`, `ui/*` | 画面の構造と表示を担当 |
+| **ViewModel** | `view/*` | ViewとModelの橋渡し、イベントハンドリング |
+| **Interface** | `interface/*` | 抽象化レイヤー、型定義 |
+| **Application** | `model/application/*/usecase/*` | ビジネスロジックの実装（UseCase） |
+| **Domain** | `model/domain/*` | コアビジネスルール |
+| **Infrastructure** | `model/infrastructure/repository/*` | データアクセス、外部API連携 |
 
-### Dependency Direction
+### 依存関係の方向
 
-Following clean architecture principles, dependencies always point inward toward the Domain layer.
+クリーンアーキテクチャの原則に従い、依存関係は常に内側（Domain層）に向かいます。
 
-- **View Layer**: Uses Application layer through interfaces
-- **Application Layer**: Uses Domain and Infrastructure layers through interfaces
-- **Domain Layer**: Depends on nothing (pure business logic)
-- **Infrastructure Layer**: Implements Domain layer interfaces
+- **View層**: インターフェースを通じてApplication層を使用
+- **Application層**: インターフェースを通じてDomain層とInfrastructure層を使用
+- **Domain層**: 何にも依存しない（純粋なビジネスロジック）
+- **Infrastructure層**: Domain層のインターフェースを実装
 
-## Directory Structure
+## ディレクトリ構造
 
 ```
 my-app/
 ├── src/
-│   ├── config/                    # Configuration files
-│   │   ├── stage.json             # Stage configuration
-│   │   ├── config.json            # Environment configuration
-│   │   ├── routing.json           # Routing configuration
-│   │   └── Config.ts              # Type definitions and exports
+│   ├── config/                    # 設定ファイル
+│   │   ├── stage.json             # ステージ設定
+│   │   ├── config.json            # 環境設定
+│   │   ├── routing.json           # ルーティング設定
+│   │   └── Config.ts              # 設定の型定義とエクスポート
 │   │
-│   ├── interface/                 # Interface definitions
-│   │   ├── IDraggable.ts          # Draggable objects
-│   │   ├── ITextField.ts          # Text field interface
-│   │   ├── IHomeTextResponse.ts   # API response type
-│   │   └── IViewName.ts           # Screen name type definition
+│   ├── interface/                 # インターフェース定義
+│   │   ├── IDraggable.ts          # ドラッグ可能なオブジェクト
+│   │   ├── ITextField.ts          # テキストフィールド
+│   │   ├── IHomeTextResponse.ts   # APIレスポンス型
+│   │   └── IViewName.ts           # 画面名の型定義
 │   │
 │   ├── view/                      # View & ViewModel
 │   │   ├── top/
-│   │   │   ├── TopView.ts         # Screen structure definition
-│   │   │   └── TopViewModel.ts    # Business logic bridge
+│   │   │   ├── TopView.ts         # 画面の構造定義
+│   │   │   └── TopViewModel.ts    # ビジネスロジックとの橋渡し
 │   │   └── home/
 │   │       ├── HomeView.ts
 │   │       └── HomeViewModel.ts
 │   │
 │   ├── model/
-│   │   ├── application/           # Application layer
+│   │   ├── application/           # アプリケーション層
 │   │   │   ├── top/
 │   │   │   │   └── usecase/
 │   │   │   │       └── NavigateToViewUseCase.ts
@@ -119,7 +118,7 @@ my-app/
 │   │   │           ├── StopDragUseCase.ts
 │   │   │           └── CenterTextFieldUseCase.ts
 │   │   │
-│   │   ├── domain/                # Domain layer
+│   │   ├── domain/                # ドメイン層
 │   │   │   └── callback/
 │   │   │       ├── Background.ts
 │   │   │       └── Background/
@@ -127,53 +126,53 @@ my-app/
 │   │   │               ├── BackgroundDrawService.ts
 │   │   │               └── BackgroundChangeScaleService.ts
 │   │   │
-│   │   └── infrastructure/        # Infrastructure layer
+│   │   └── infrastructure/        # インフラ層
 │   │       └── repository/
 │   │           └── HomeTextRepository.ts
 │   │
-│   ├── ui/                        # UI components
-│   │   ├── animation/             # Animation definitions
+│   ├── ui/                        # UIコンポーネント
+│   │   ├── animation/             # アニメーション定義
 │   │   │   └── top/
 │   │   │       └── TopBtnShowAnimation.ts
 │   │   │
-│   │   ├── component/             # Atomic design
-│   │   │   ├── atom/              # Minimal unit components
+│   │   ├── component/             # アトミックデザイン
+│   │   │   ├── atom/              # 最小単位のコンポーネント
 │   │   │   │   ├── ButtonAtom.ts
 │   │   │   │   └── TextAtom.ts
-│   │   │   ├── molecule/          # Combined atoms
+│   │   │   ├── molecule/          # Atomを組み合わせたコンポーネント
 │   │   │   │   ├── HomeBtnMolecule.ts
 │   │   │   │   └── TopBtnMolecule.ts
-│   │   │   ├── organism/          # Multiple molecules combined
-│   │   │   ├── template/          # Page templates
-│   │   │   └── page/              # Page components
+│   │   │   ├── organism/          # 複数Moleculeの組み合わせ
+│   │   │   ├── template/          # ページテンプレート
+│   │   │   └── page/              # ページコンポーネント
 │   │   │       ├── top/
 │   │   │       │   └── TopPage.ts
 │   │   │       └── home/
 │   │   │           └── HomePage.ts
 │   │   │
-│   │   └── content/               # Animation Tool generated content
+│   │   └── content/               # Animation Tool生成コンテンツ
 │   │       ├── TopContent.ts
 │   │       └── HomeContent.ts
 │   │
-│   ├── assets/                    # Static assets
+│   ├── assets/                    # 静的アセット
 │   │
-│   ├── Packages.ts                # Package exports
-│   └── index.ts                   # Entry point
+│   ├── Packages.ts                # パッケージエクスポート
+│   └── index.ts                   # エントリーポイント
 │
-├── file/                          # Animation Tool output files
+├── file/                          # Animation Tool出力ファイル
 │   └── sample.n2d
 │
-├── mock/                          # Mock data
-│   ├── api/                       # API mocks
-│   ├── content/                   # Content mocks
-│   └── img/                       # Image mocks
+├── mock/                          # モックデータ
+│   ├── api/                       # APIモック
+│   ├── content/                   # コンテンツモック
+│   └── img/                       # 画像モック
 │
 └── package.json
 ```
 
-## Framework Flowchart
+## フレームワークフローチャート
 
-Detailed flow of screen transitions via the gotoView function.
+gotoView関数による画面遷移の詳細なフローを示します。
 
 ```mermaid
 graph TD
@@ -246,28 +245,28 @@ graph TD
     style GlobalData fill:#f5f5f5,stroke:#666666
 ```
 
-### Main Flow Steps
+### フローの主要ステップ
 
-| Step | Description |
+| ステップ | 説明 |
 |----------|------|
-| **gotoView** | Entry point for screen transitions |
-| **Loading** | Display/hide loading screen control |
-| **Request Type** | Three types of requests: JSON, CONTENT, CUSTOM |
-| **Cache** | Response data caching control |
-| **View/ViewModel Bind** | New View/ViewModel binding process |
-| **onEnter** | Callback after screen display completion |
+| **gotoView** | 画面遷移のエントリーポイント |
+| **Loading** | ローディング画面の表示/非表示制御 |
+| **Request Type** | JSON、CONTENT、CUSTOMの3種類のリクエスト |
+| **Cache** | レスポンスデータのキャッシュ制御 |
+| **View/ViewModel Bind** | 新しいView/ViewModelのバインド処理 |
+| **onEnter** | 画面表示完了後のコールバック |
 
-## Major Design Patterns
+## 主要な設計パターン
 
 ### 1. MVVM (Model-View-ViewModel)
 
-- **View**: Handles screen structure and display without business logic
-- **ViewModel**: Bridges View and Model, holds UseCases and processes events
-- **Model**: Manages business logic and data access
+- **View**: 画面の構造と表示を担当。ビジネスロジックは持たない
+- **ViewModel**: ViewとModelの橋渡し。UseCaseを保持し、イベントを処理
+- **Model**: ビジネスロジックとデータアクセスを担当
 
-### 2. UseCase Pattern
+### 2. UseCaseパターン
 
-Create dedicated UseCase classes for each user action:
+各ユーザーアクションに対して、専用のUseCaseクラスを作成:
 
 ```typescript
 export class StartDragUseCase
@@ -279,12 +278,12 @@ export class StartDragUseCase
 }
 ```
 
-### 3. Dependency Inversion
+### 3. 依存性の逆転 (Dependency Inversion)
 
-Depend on interfaces rather than concrete classes:
+具象クラスではなく、インターフェースに依存:
 
 ```typescript
-// Good example: depends on interface
+// 良い例: インターフェースに依存
 import type { IDraggable } from "@/interface/IDraggable";
 
 function startDrag(target: IDraggable): void
@@ -293,9 +292,9 @@ function startDrag(target: IDraggable): void
 }
 ```
 
-### 4. Repository Pattern
+### 4. Repositoryパターン
 
-Abstracts data access with error handling:
+データアクセスを抽象化し、エラーハンドリングも実装:
 
 ```typescript
 export class HomeTextRepository
@@ -316,9 +315,9 @@ export class HomeTextRepository
 }
 ```
 
-## Quick Start
+## クイックスタート
 
-### Project Creation
+### プロジェクトの作成
 
 ```bash
 npx create-next2d-app my-app
@@ -327,34 +326,34 @@ npm install
 npm start
 ```
 
-### Auto-generate View/ViewModel
+### View/ViewModelの自動生成
 
 ```bash
 npm run generate
 ```
 
-This command parses the top properties in `routing.json` and generates corresponding View and ViewModel classes.
+このコマンドは`routing.json`のトッププロパティを解析し、対応するViewとViewModelクラスを生成します。
 
-## Best Practices
+## ベストプラクティス
 
-1. **Interface First**: Always depend on interfaces rather than concrete types
-2. **Single Responsibility Principle**: Each class should have only one responsibility
-3. **Dependency Injection**: Inject dependencies through constructors
-4. **Error Handling**: Handle errors appropriately in Repository layer
-5. **Type Safety**: Use explicit type definitions, avoid `any` type
+1. **インターフェース優先**: 具象型ではなく、常にインターフェースに依存
+2. **単一責任の原則**: 各クラスは1つの責務のみを持つ
+3. **依存性注入**: コンストラクタで依存を注入
+4. **エラーハンドリング**: Repository層で適切にエラーを処理
+5. **型安全性**: `any`型を避け、明示的な型定義を使用
 
-## Related Documentation
+## 関連ドキュメント
 
-### Basics
-- View/ViewModel - Screen display and data binding
-- Routing - URL-based screen transitions
-- Configuration Files - Environment and stage configuration
-- Animation Tool Integration - Leveraging Animation Tool assets
+### 基本
+- [View/ViewModel](/ja/reference/framework/view) - 画面表示とデータバインディング
+- [ルーティング](/ja/reference/framework/routing) - URLベースの画面遷移
+- [設定ファイル](/ja/reference/framework/config) - 環境設定とステージ設定
+- [Animation Tool連携](/ja/reference/framework/animation-tool) - Animation Toolアセットの活用
 
-### Next2D Player Integration
-- Next2D Player - Rendering engine
-- MovieClip - Timeline animation
-- Event System - User interaction
+### Next2D Player連携
+- [Next2D Player](/ja/reference/player) - レンダリングエンジン
+- [MovieClip](/ja/reference/player/movie-clip) - タイムラインアニメーション
+- [イベントシステム](/ja/reference/player/events) - ユーザーインタラクション
 
 ---
 
@@ -495,9 +494,9 @@ Animation ToolのJSONファイルは`routing.json`の`requests`で読み込み
 
 ## 関連項目
 
-- View/ViewModel
-- ルーティング
-- 設定ファイル
+- [View/ViewModel](/ja/reference/framework/view)
+- [ルーティング](/ja/reference/framework/routing)
+- [設定ファイル](/ja/reference/framework/config)
 
 ---
 
@@ -612,7 +611,7 @@ if (config.platform === "ios") {
 
 ## routing.json
 
-ルーティングの設定ファイルです。詳細は[ルーティング](#ルーティング)を参照してください。
+ルーティングの設定ファイルです。詳細は[ルーティング](/ja/reference/framework/routing)を参照してください。
 
 ```json
 {
@@ -830,8 +829,8 @@ npm run build -- --platform=android
 
 ## 関連項目
 
-- [ルーティング](#ルーティング)
-- [View/ViewModel](#view-と-viewmodel)
+- [ルーティング](/ja/reference/framework/routing)
+- [View/ViewModel](/ja/reference/framework/view)
 
 ---
 
@@ -986,6 +985,12 @@ Animation ToolのJSONを取得:
 ### キャッシュの利用
 
 `cache: true`を設定すると、データがキャッシュされます。キャッシュしたデータは画面遷移しても初期化されません。
+`app.getCache()`は`Map<string, unknown>`を返し、`requests`の`name`をキーにアクセスできます。
+
+キャッシュ利用時のポイント:
+
+- 同じキーのデータが既にある場合は、リクエスト処理側がキャッシュ値を優先利用できます。
+- キャッシュは自動クリアされないため、不要なデータは`delete`/`clear`で明示的に管理します。
 
 ```json
 {
@@ -1053,7 +1058,24 @@ export class HomeDataCallback
 
 ### app.gotoView()
 
-`app.gotoView()`で画面遷移を行います:
+`app.gotoView(name?: string)`で画面遷移を行います。戻り値は`Promise<void>`で、遷移先`requests`の完了、View/ViewModelの再バインド、`onEnter()`まで待機できます。
+
+`gotoView`のポイント:
+
+- `name`の型は`string`です（省略可能、デフォルト値は`""`）。
+- `name`には`routing.json`のキー（例: `home`、`quest/list`）を指定します。
+- `?id=123`のようなクエリ文字列を含めて渡せます。
+- 引数を省略した場合は、現在のURLから遷移先が解決されます（SPAの`popstate`時）。
+- 遷移開始時に前回の`response`マップはクリアされます。
+
+`gotoView`実行シーケンス（詳細）:
+
+1. 前回遷移で保持していた`response`マップを初期化します。
+2. `name`または現在URLから遷移先ルートを解決し、クエリを分解します。
+3. `all.spa: true`かつ通常遷移時はHistory API（`pushState`）でURL履歴を更新します。
+4. 遷移先`requests`を実行し、`name`キー単位で`response`/`cache`へ格納します。
+5. `requests.callback`と`gotoView.callback`を順次実行します。
+6. 旧Viewの`onExit`/unbind後に新View/ViewModelをbindし、`initialize`完了後に`onEnter`を呼び出します。
 
 ```typescript
 import { app } from "@next2d/framework";
@@ -1104,9 +1126,26 @@ export class TopViewModel extends ViewModel
 }
 ```
 
+### app.getContext()
+
+`app.getContext()`で実行中の`Context`を取得できます。`root`（ルート`Sprite`）、`view`、`viewModel`への参照を持ち、遷移中は`view`/`viewModel`が`null`の場合があります。
+
+```typescript
+import { app } from "@next2d/framework";
+
+const context = app.getContext();
+const root = context.root;
+```
+
 ## レスポンスデータの取得
 
-`requests`で取得したデータは`app.getResponse()`で取得できます:
+`app.getResponse()`は`Map<string, unknown>`を返します。`requests`で`name`を設定したレスポンスを、現在の画面遷移単位で取得できます。
+
+`getResponse`のポイント:
+
+- 1回の`gotoView`で取得したデータの一時ストアです。
+- 次の`gotoView`開始時に内容は初期化されます。
+- 値の型は`unknown`なので、型ガードまたは型アサーションを行って利用します。
 
 ```typescript
 import { app } from "@next2d/framework";
@@ -1221,8 +1260,8 @@ npm run generate
 
 ## 関連項目
 
-- [View/ViewModel](#view-と-viewmodel)
-- [設定ファイル](#設定ファイル)
+- [View/ViewModel](/ja/reference/framework/view)
+- [設定ファイル](/ja/reference/framework/config)
 
 ---
 
@@ -1523,7 +1562,15 @@ export class HomeView extends View<HomeViewModel>
 
 ## 画面遷移
 
-画面遷移には`app.gotoView()`を使用します。
+画面遷移には`app.gotoView(name?: string)`を使用します。戻り値は`Promise<void>`で、遷移先の`requests`実行、View/ViewModelの再バインド、`onEnter()`実行までの非同期処理を待機できます。
+
+`gotoView`のポイント:
+
+- `name`の型は`string`です（省略可能、デフォルト値は`""`）。
+- `name`には`routing.json`のキー（例: `home`、`quest/list`）を渡します。`?id=123`のようなクエリ文字列も付与できます。
+- 引数を省略した場合は現在のURLから遷移先を解決します（SPAの`popstate`時など）。
+- 遷移開始時に前画面の`response`マップは初期化され、遷移先の`requests`結果が`name`キーで再格納されます。
+- `config.json`で`all.spa: true`の場合、通常遷移ではHistory API（`pushState`）でURL履歴が更新されます。
 
 ```typescript
 import { app } from "@next2d/framework";
@@ -1549,9 +1596,34 @@ export class NavigateToViewUseCase
 }
 ```
 
+## コンテキストの取得
+
+`app.getContext()`は現在の実行コンテキスト（`Context`）を返します。`Context`には次の参照が含まれます。
+
+- `root`: Stage配下のルート`Sprite`
+- `view`: 現在バインドされているView（遷移中や起動直後は`null`の場合あり）
+- `viewModel`: 現在バインドされているViewModel（遷移中や起動直後は`null`の場合あり）
+
+```typescript
+import { app } from "@next2d/framework";
+
+const context = app.getContext();
+const root = context.root;
+
+if (context.view && context.viewModel) {
+    // 現在表示中のView / ViewModelにアクセス
+}
+```
+
 ## レスポンスデータの取得
 
-`routing.json`で設定した`requests`のデータは`app.getResponse()`で取得できます。
+`app.getResponse()`は`Map<string, unknown>`を返します。`routing.json`の`requests`で`name`を設定したレスポンスが、現在の画面遷移単位で格納されます。
+
+`getResponse`のポイント:
+
+- 1回の`gotoView`で取得したデータの一時ストアです。
+- 次の`gotoView`開始時に前回の内容はクリアされます。
+- 値の型は`unknown`なので、利用側で型ガードまたは型アサーションを行います。
 
 ```typescript
 import { app } from "@next2d/framework";
@@ -1569,7 +1641,13 @@ async initialize(): Promise<void>
 
 ## キャッシュデータの取得
 
-`cache: true`を設定したデータは`app.getCache()`で取得できます。
+`app.getCache()`は`Map<string, unknown>`を返します。`requests`で`cache: true`を設定したデータが遷移を跨いで保持されるため、マスターデータなどの再利用に向いています。
+
+`getCache`のポイント:
+
+- `requests`の`cache: true`かつ`name`キーを持つデータが保存対象です。
+- 同じキーが存在する場合、リクエスト処理側はキャッシュ値を優先利用できます。
+- キャッシュは自動クリアされないため、不要になったら`delete`や`clear`で明示的に管理します。
 
 ```typescript
 import { app } from "@next2d/framework";
@@ -1683,5 +1761,5 @@ export class YourViewModel extends ViewModel
 
 ## 関連項目
 
-- [ルーティング](#ルーティング)
-- [設定ファイル](#設定ファイル)
+- [ルーティング](/ja/reference/framework/routing)
+- [設定ファイル](/ja/reference/framework/config)

package/dist/references/player-specs.md

@@ -1,21 +1,20 @@
-# Next2D Player - API Reference
+# Next2D Player - APIリファレンス
 
-## Table of Contents
+## 目次
 
-1. [Overview](#next2d-player)
+1. [概要](#next2d-player)
 2. [DisplayObject](#displayobject)
-3. [Events](#イベントシステム)
+3. [イベントシステム](#イベントシステム)
 4. [MovieClip](#movieclip)
 5. [Shape](#shape)
-6. [Sound](#サウンド)
+6. [サウンド](#サウンド)
 7. [Sprite](#sprite)
 8. [TextField](#textfield)
-9. [Tween](#tweenアニメーション)
+9. [Tweenアニメーション](#tweenアニメーション)
 10. [Video](#video)
-11. [Filters](#フィルター)
+11. [フィルター](#フィルター)
 
 ---
-
 # Next2D Player
 
 Next2D Playerは、WebGL/WebGPUを用いた高速2Dレンダリングエンジンです。Flash Playerのような機能をWeb上で実現し、ベクター描画、Tweenアニメーション、テキスト、音声、動画など、さまざまな要素をサポートしています。
@@ -24,7 +23,6 @@ Next2D Playerは、WebGL/WebGPUを用いた高速2Dレンダリングエンジ
 
 - **高速レンダリング**: WebGL/WebGPUを活用した高速2D描画
 - **マルチプラットフォーム**: デスクトップからモバイルまで対応
-- **Flash互換API**: swf2jsから派生した馴染みやすいAPI設計
 - **豊富なフィルター**: Blur、DropShadow、Glow、Bevelなど多数のフィルターをサポート
 
 ## レンダリングパイプライン
@@ -217,7 +215,6 @@ stage.addChild(mc);
 - [サウンド](/ja/reference/player/sound) - 音声再生とサウンドエフェクト
 - [Tweenアニメーション](/ja/reference/player/tween) - プログラムによるアニメーション
 
-
 ---
 
 # DisplayObject
@@ -385,7 +382,6 @@ displayObject.clearGlobalVariable(); // 全てクリア
 - [MovieClip](/ja/reference/player/movie-clip)
 - [Sprite](/ja/reference/player/sprite)
 
-
 ---
 
 # イベントシステム
@@ -681,7 +677,6 @@ child.addEventListener(PointerEvent.POINTER_DOWN, handler, false);
 - [DisplayObject](/ja/reference/player/display-object)
 - [MovieClip](/ja/reference/player/movie-clip)
 
-
 ---
 
 # MovieClip
@@ -930,7 +925,6 @@ labels.forEach((label) => {
 - [Sprite](/ja/reference/player/sprite)
 - [イベントシステム](/ja/reference/player/events)
 
-
 ---
 
 # Shape
@@ -1375,7 +1369,6 @@ stage.addChild(shape);
 - [Sprite](/ja/reference/player/sprite)
 - [フィルター](/ja/reference/player/filters)
 
-
 ---
 
 # サウンド
@@ -1669,7 +1662,6 @@ SoundMixer.volume = 0.5;  // 50%
 
 - [イベントシステム](/ja/reference/player/events)
 
-
 ---
 
 # Sprite
@@ -1913,7 +1905,6 @@ stage.addChild(container);
 - [MovieClip](/ja/reference/player/movie-clip)
 - [Shape](/ja/reference/player/shape)
 
-
 ---
 
 # TextField
@@ -2281,7 +2272,6 @@ stage.addChild(inputField);
 - [DisplayObject](/ja/reference/player/display-object)
 - [イベントシステム](/ja/reference/player/events)
 
-
 ---
 
 # Tweenアニメーション
@@ -2660,7 +2650,6 @@ stopButton.addEventListener("pointerDown", () => {
 - [DisplayObject](/ja/reference/player/display-object)
 - [イベントシステム](/ja/reference/player/events)
 
-
 ---
 
 # Video
@@ -2890,7 +2879,6 @@ stage.addChild(video);
 - [DisplayObject](/ja/reference/player/display-object)
 - [イベントシステム](/ja/reference/player/events)
 
-
 ---
 
 # フィルター
@@ -3287,6 +3275,3 @@ sprite.filters = [
 - [DisplayObject](/ja/reference/player/display-object)
 - [MovieClip](/ja/reference/player/movie-clip)
 
-
----
-

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4BzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmFzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoEzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmFzD"}

package/dist/resources/index.js

@@ -6,11 +6,19 @@ const __dirname = path.dirname(__filename);
 function loadReference(filename) {
     // Search locations (in priority order):
     // 1. Bundled with package: dist/references/ (works after npm publish)
-    // 2. Development: .github/skills/references/ (relative to project root)
-    // 3. User's project: cwd/.github/skills/references/ (if user has specs locally)
+    // 2. Development submodule: next2d-development-assistant/skills/next2d-development-assistant/references/
+    // 3. Development submodule (legacy layout): next2d-development-assistant/.github/skills/references/
+    // 4. Development (legacy): .github/skills/references/ (relative to project root)
+    // 5. User's project submodule: cwd/next2d-development-assistant/skills/next2d-development-assistant/references/
+    // 6. User's project submodule (legacy layout): cwd/next2d-development-assistant/.github/skills/references/
+    // 7. User's project (legacy): cwd/.github/skills/references/
     const candidates = [
         path.join(__dirname, "..", "references", filename),
+        path.join(__dirname, "..", "..", "next2d-development-assistant", "skills", "next2d-development-assistant", "references", filename),
+        path.join(__dirname, "..", "..", "next2d-development-assistant", ".github", "skills", "references", filename),
         path.join(__dirname, "..", "..", ".github", "skills", "references", filename),
+        path.join(process.cwd(), "next2d-development-assistant", "skills", "next2d-development-assistant", "references", filename),
+        path.join(process.cwd(), "next2d-development-assistant", ".github", "skills", "references", filename),
         path.join(process.cwd(), ".github", "skills", "references", filename)
     ];
     for (const candidate of candidates) {

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next2d-development-mcp",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "MCP server for Next2D application development assistance",
   "type": "module",
   "author": "Toshiyuki Ienaga <ienaga@next2d.app>",
@@ -13,7 +13,7 @@
   "main": "./dist/index.js",
   "scripts": {
     "build": "tsc && npm run copy-refs",
-    "copy-refs": "node -e \"const fs=require('fs');const p=require('path');const src=p.join('.github','skills','references');const dst=p.join('dist','references');fs.mkdirSync(dst,{recursive:true});fs.readdirSync(src).filter(f=>f.endsWith('.md')).forEach(f=>fs.copyFileSync(p.join(src,f),p.join(dst,f)));console.log('Copied references to dist/references/')\"",
+    "copy-refs": "node -e \"const fs=require('fs');const p=require('path');const roots=[p.join('next2d-development-assistant','skills','next2d-development-assistant','references'),p.join('next2d-development-assistant','.github','skills','references'),p.join('.github','skills','references')];const src=roots.find((dir)=>fs.existsSync(dir));if(!src){throw new Error('Reference directory not found. Expected next2d-development-assistant/skills/next2d-development-assistant/references');}const dst=p.join('dist','references');fs.mkdirSync(dst,{recursive:true});fs.readdirSync(src).filter((f)=>f.endsWith('.md')).forEach((f)=>fs.copyFileSync(p.join(src,f),p.join(dst,f)));console.log('Copied references from '+src+' to dist/references/');\"",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
     "lint": "eslint src/ --ignore-pattern '*.test.ts'",