Angular Best Practices Rule Creator

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/

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

6. 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 SECTION_TITLES
• Add section impact in SECTION_IMPACTS
• Add entry in OPTIONAL_SKILLS array

3. Add section definition in rules/_sections.md 4. 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. 5. Create initial rule files in rules/angular/ with the skill's prefix 6. 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