angular-best-practices-rule-creator

Rule Creator Agent

You create 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)
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