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 バージョンがシグナル フォームをサポートしている場合のみ、新しいプロジェクトではシグナル フォームを優先してください。詳細情報を確認してください。

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

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

• IF ユーザーが特定のバージョンをリクエストしている場合（例：Angular 15）、ローカル インストールをバイパスして、厳密に npx を使用してください。
• コマンド: npx @angular/cli@<requested_version> new <project-name>

ステップ 2: 既存の Angular インストールを確認します。

• IF 特定のバージョンがリクエストされていない場合、ターミナルで ng version を実行して、Angular CLI がシステムに既にインストールされているかどうかを確認してください。
• IF コマンドが成功して、インストール済みバージョンが返された場合は、ローカル/グローバル インストールを直接使用してください。
• コマンド: ng new <project-name>

ステップ 3: 最新版へのフォールバック

• IF 特定のバージョンがリクエストされていない場合、ng version コマンドが失敗した場合（Angular インストールが存在しないことを示す）、npx を使用して最新バージョンを取得する必要があります。
• コマンド: npx @angular/cli@latest new <project-name>

コンポーネント

Angular コンポーネントで作業するとき、タスクに基づいて次のリファレンスを参照してください。

• 基礎: 解剖学、メタデータ、コア概念、およびテンプレート制御フロー（@if、@for、@switch）。components.md を読んでください。
• 入力: シグナルベースの入力、変換、およびモデル入力。inputs.md を読んでください。
• 出力: シグナルベースの出力とカスタム イベント ベストプラクティス。outputs.md を読んでください。
• ホスト要素: ホスト バインディングとアトリビュート注入。host-elements.md を読んでください。

より詳細なドキュメントが上記のリファレンスで見つからない場合は、https://angular.dev/guide/components のドキュメントを参照してください。

反応性とデータ管理

状態とデータ反応性を管理する場合、Angular シグナルを使用し、次のリファレンスを参照してください。

• シグナル概要: コア シグナル概念（signal、computed）、反応的コンテキスト、および untracked。signals-overview.md を読んでください。
• 依存状態（linkedSignal）: ソース シグナルにリンクされた書き込み可能な状態を作成します。linked-signal.md を読んでください。
• 非同期反応性（resource）: シグナル状態に非同期データを直接フェッチします。resource.md を読んでください。
• 副作用（effect）: ロギング、サードパーティ DOM 操作（afterRenderEffect）、および副作用を使用しないテーム。effects.md を読んでください。

フォーム

ほとんどの場合、新しいアプリケーション では シグナル フォームを優先してください。フォーム決定を行うときは、プロジェクトを分析し、次のガイドラインを検討してください。

• アプリケーション バージョンがシグナル フォームをサポートしており、これが新しいフォームの場合、シグナル フォームを優先してください。

• 古いアプリケーションまたは既存のフォーム については、アプリケーションの現在のフォーム戦略と一致させてください。

• シグナル フォーム: フォーム状態管理用にシグナルを使用します。signal-forms.md を読んでください。

• テンプレート駆動フォーム: シンプルなフォーム用に使用します。template-driven-forms.md を読んでください。

• リアクティブ フォーム: 複雑なフォーム用に使用します。reactive-forms.md を読んでください。

依存性注入

Angular に依存性注入を実装するときは、次のガイドラインに従ってください。

• 基礎: 依存性注入の概要、サービス、および inject() 関数。di-fundamentals.md を読んでください。
• サービスの作成と使用: サービスの作成、providedIn: 'root' オプション、およびコンポーネントまたは他のサービスへの注入。creating-services.md を読んでください。
• 依存性プロバイダーの定義: 自動と手動のプロビジョニング、InjectionToken、useClass、useValue、useFactory、およびスコープ。defining-providers.md を読んでください。
• 注入コンテキスト: inject() が許可される場所、runInInjectionContext、および assertInInjectionContext。injection-context.md を読んでください。
• 階層型インジェクター: EnvironmentInjector と ElementInjector、解決ルール、修飾子（optional、skipSelf）、および providers と viewProviders。hierarchical-injectors.md を読んでください。

Angular Aria

Accordion、Listbox、Combobox、Menu、Tabs、Toolbar、Tree、Grid などのパターン用のアクセシブルなカスタム コンポーネントを構築する場合は、次のリファレンスを参照してください。

• Angular Aria コンポーネント: ヘッドレスで アクセシブルなコンポーネント（Accordion、Listbox、Combobox、Menu、Tabs、Toolbar、Tree、Grid）の構築と ARIA アトリビュートのスタイリング。angular-aria.md を読んでください。