angular-best-practices-rule-creator

ルール作成エージェント

プロジェクトの規約に厳密に従い、Angular のベストプラクティスに関する新しいルールと、必要に応じてライブラリスキルを作成します。

機能

1. 新しいルールの作成

ルールの作成を依頼された場合：

1. ルールファイル名からプレフィックスを特定します（例：material-imports.md → プレフィックス material）
2. packages/angular-best-practices-build/src/config.ts の sectionMap でセクション番号を確認します
3. プレフィックスに基づいて、ファイルを適切な rules/ サブディレクトリに配置します：
   • test-* → rules/testing/
   • a11y-*、ui-*、loading-*、dialogs-*、theming-* → rules/ui/
   • http-*、mapper-* → rules/data/
   • ts-* → rules/typescript/
   • opt-*、bundle-*、async-* → rules/optimization/
   • arch-* → rules/core/
   • その他すべて（signals、components、forms、rxjs、ngrx、material、primeng、spartan、transloco など）→ rules/angular/
4. rules/_template.md からテンプレートをコピーします
5. 以下のルールに従って、フロントマターと本文を記入します：
   • タイトル： 動詞 + 対象（例：「シグナル入力を使用する」）
   • 説明： 最大1文
   • コードブロック： 最大0〜2個（誤りと正しい例、または正しい例のみ）
   • 各コードブロックのコード： 最大3〜5行
   • 全体の長さ： 50行未満（理想は30〜40行）
   • インストールコマンド、設定のダンプ、フォルダー構成は含めないでください
6. angular-best-practices-rules-reviewer スキルで検証します

2. 新しいライブラリスキルの作成

新しいオプションのライブラリスキルの作成を依頼された場合：

1. 次に利用可能なセクション番号を選択します（config.ts の SECTION_TITLES を確認）
2. packages/angular-best-practices-build/src/config.ts を更新します：
   • sectionMap にプレフィックス → セクション番号を追加します
   • SECTION_TITLES にセクションタイトルを追加します
   • SECTION_IMPACTS にセクションの影響度を追加します
   • OPTIONAL_SKILLS 配列に項目を追加します
3. rules/_sections.md にセクション定義を追加します
4. フロントマター（name、description、metadata、tags、globs）を含む skills/<skill-name>/SKILL.md を作成します。SKILL.md の品質基準については .claude/skills/angular-best-practices-rules-reviewer/references/skill-best-practices.md を確認してください。
5. スキルのプレフィックスを使って、rules/angular/ に初期ルールファイルを作成します
6. npm run build を実行し、AGENTS.md ファイルを生成します

プレフィックス → セクション対応（現在）

プレフィックス	セクション	タイトル
async, opt-async	1	ウォーターフォールの排除
bundle	2	バンドルの最適化
opt, performance	3	JavaScript のパフォーマンス
ts	4	TypeScript のベストプラクティス
signal	5	シグナルとリアクティビティ
component	6	コンポーネントのパターン
rxjs	7	RxJS のパターン
cd	8	変更検知
template	9	テンプレートの最適化
ssr	10	SSR とハイドレーション
form	11	フォーム
ngrx	12	NgRx の状態管理
signalstore	13	SignalStore
tanstack	14	TanStack Query
arch	15	アーキテクチャ
test	16	テスト
core, di, error-handling, observability, pattern, routing, security	17	インフラストラクチャ
ui, a11y, loading, dialogs, theming	18	UI とアクセシビリティ
http, mapper	19	データ処理
material	20	Angular Material
primeng	21	PrimeNG
spartan	22	Spartan UI
transloco	23	国際化

ファイルの配置

サブディレクトリ	プレフィックス
rules/angular/	signal, component, rxjs, cd, template, ssr, form, ngrx, signalstore, tanstack, material, primeng, spartan, transloco
rules/testing/	test
rules/ui/	ui, a11y, loading, dialogs, theming
rules/typescript/	ts
rules/optimization/	opt, bundle, async, performance
rules/core/	arch, core, di, error-handling, observability, pattern, routing, security
rules/data/	http, mapper

テンプレートの参照

---
title: Verb + Subject
impact: MEDIUM
impactDescription: Brief metric (e.g., "2-10x faster", "O(n) to O(1)")
tags: tag1, tag2
---

## Verb + Subject

One sentence explaining the rule.

**Incorrect:**

\`\`\`typescript
// 3-5 lines max
\`\`\`

**Correct:**

\`\`\`typescript
// 3-5 lines max
\`\`\`

ビルドコマンド

npm run build                    # Regenerate all AGENTS.md files
npm run build:skip-validation    # Skip validation during development