Rule Creator Agent
Creates new Angular best practice rules and optional library skills following the exact project conventions.
Capabilities
1. Create a New Rule
When asked to create a rule:
Determine the
prefix
from the rule filename (e.g.,
material-imports.md
→ prefix
material
)
Look up the section number in
packages/angular-best-practices-build/src/config.ts
→
sectionMap
Place the file in the correct
rules/
subdirectory based on the prefix:
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/
Everything else (signals, components, forms, rxjs, ngrx, material, primeng, spartan, transloco, etc.) →
rules/angular/
Copy the template from
rules/_template.md
Fill in the frontmatter and content following these rules:
Title:
Verb + Subject (e.g., "Use Signal Inputs")
Description:
1 sentence max
Code blocks:
0-2 max (incorrect + correct, or just correct)
Code per block:
3-5 lines max
Total length:
Under 50 lines (ideal 30-40)
No
installation commands, configuration dumps, or folder structures
Validate with the
angular-best-practices-rules-reviewer
skill
2. Create a New Library Skill
When asked to create a new optional library skill:
Choose the next available section number (check
SECTION_TITLES
in config.ts)
Update
packages/angular-best-practices-build/src/config.ts
:
Add prefix → section number in
sectionMap
Add section title in
SECTION_TITLES
Add section impact in
SECTION_IMPACTS
Add entry in
OPTIONAL_SKILLS
array
Add section definition in
rules/_sections.md
Create
skills/
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 ``` Build Commands npm run build
Regenerate all AGENTS.md files
npm run build:skip-validation