Angular Developer

# Angular 開発者 ガイドライン

## アクティブ化するとき

- 任意の Angular プロジェクトまたはコードベースで作業しているとき
- 新しい Angular プロジェクト、アプリケーション、またはライブラリを作成またはスキャフォールディングするとき
- コンポーネント、サービス、ディレクティブ、パイプ、ガード、またはリソルバーを生成するとき
- Angular シグナル、`linkedSignal`、または `resource` で反応性を実装するとき
- Angular フォーム（シグナル フォーム、リアクティブ フォーム、またはテンプレート駆動）で作業するとき
- 依存性注入、ルーティング、遅延ロード、またはルート ガードをセットアップするとき
- アクセシビリティ（ARIA）、アニメーション、またはコンポーネント スタイリングを追加するとき
- Angular 固有のテスト（ユニット、コンポーネント ハーネス、E2E）を作成またはデバッグするとき
- Angular CLI ツール作成または Angular MCP サーバーを構成するとき

1. ガイダンスを提供する前に、常にプロジェクトの Angular バージョンを分析してください。ベスト プラクティスと利用可能な機能はバージョン間で大きく異なる場合があります。Angular CLI を使用して新しいプロジェクトを作成する場合、ユーザーによるプロンプトがない限り、バージョンを指定しないでください。

2. コードを生成するときは、メンテナンス性とパフォーマンスのため、Angular のスタイル ガイドと Angular のベスト プラクティスに従ってください。Angular CLI を使用して、コンポーネント、サービス、ディレクティブ、パイプ、およびルートをスキャフォールディングして、一貫性を確保します。

3. コード生成を完了したら、`ng build` を実行してビルド エラーがないか確認してください。エラーがある場合は、エラー メッセージを分析して修正してから続行してください。生成されたコードが正しく機能することを確認するために、このステップをスキップしないことが重要です。

## 新しいプロジェクトの作成

ユーザーがガイドラインを提供しない場合は、新しい Angular プロジェクトを作成するときに、これらのデフォルトを使用してください。

1. ユーザーが別途指定しない限り、Angular の最新の安定バージョンを使用してください。
2. 対象の Angular バージョンがシグナル フォームをサポートしている場合のみ、新しいプロジェクトではシグナル フォームを優先してください。[詳細情報](../../../../skills/angular-developer/references/signal-forms.md)を確認してください。

**`ng new` の実行ルール:**
新しい Angular プロジェクトを作成するよう求められたとき、以下の厳密な手順に従って正しい実行コマンドを決定する必要があります。

**ステップ 1: ユーザーが明示的にバージョンを指定しているか確認します。**

- **IF** ユーザーが特定のバージョンをリクエストしている場合（例：Angular 15）、ローカル インストールをバイパスして、厳密に `npx` を使用してください。