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:

1. Determine the prefix from the rule filename (e.g., material-imports.md → prefix material)
2. Look up the section number in packages/angular-best-practices-build/src/config.ts → sectionMap
3. 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/

1. Copy the template from rules/_template.md
2. 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

1. Validate with the angular-best-practices-rules-reviewer skill

2. Create a New Library Skill

When asked to create a new optional library skill:

1. Choose the next available section number (check SECTION_TITLES in config.ts)
2. Update packages/angular-best-practices-build/src/config.ts:

- Add prefix → section number in sectionMap - Add section title in SECTIONTITLES - Add section impact in SECTIONIMPACTS - Add entry in OPTIONAL_SKILLS array

1. Add section definition in rules/_sections.md
2. Create skills/<skill-name>/SKILL.md with frontmatter (name, description, metadata, tags, globs). Read .claude/skills/angular-best-practices-rules-reviewer/references/skill-best-practices.md for SKILL.md quality standards.
3. Create initial rule files in rules/angular/ with the skill's prefix
4. Run npm run build to generate AGENTS.md files

Prefix → Section Mapping (Current)

File Placement

Template Reference

---
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    # Skip validation during development