Angular Best Practices

for AI agents & LLMs

Concise, actionable Angular best practices optimized for AI agents and LLMs. 151 rules across 23 categories, each under 50 lines.

Install

Select the skills you need. Core rules are always included.

Terminal
$ npx skills add alfredoperez/angular-best-practices

How It Works

  rules/*.md          →  build system  →  AGENTS.md
  (granular files)       (validate &      (single file per skill,
                          concatenate)     consumed by AI agents)

  Install via:  npx skills add alfredoperez/angular-best-practices
  Agents read:  AGENTS.md at the project root
  Format:       Each rule is < 50 lines, 2 code blocks max

Rules are stored as individual markdown files, validated for conciseness, then compiled into a single AGENTS.md that AI coding assistants (Claude Code, Cursor, VS Code Copilot) read at the project root.

Rule Categories

1Eliminating Waterfalls2CRITICAL
2Bundle Optimization5CRITICAL
3JavaScript Performance14HIGH
4TypeScript Best Practices14MEDIUM
5Signals & Reactivity12HIGH
6Component Patterns6HIGH
7RxJS Patterns7HIGH
8Change Detection4HIGH
9Template Optimization3HIGH
10SSR & Hydration10HIGH
11Forms5MEDIUM
12NgRx State Management5HIGH
13SignalStore4HIGH
14TanStack Query4HIGH
15Architecture3HIGH
16Testing9HIGH
17Infrastructure19MEDIUM
18UI & Accessibility7MEDIUM
19Data Handling5MEDIUM
20Angular Material4MEDIUM
21PrimeNG3MEDIUM
22Spartan UI3MEDIUM
23Transloco3MEDIUM

Rule Format

---
title: Verb + Subject
impact: MEDIUM
impactDescription: Brief metric
tags: tag1, tag2
---

## Verb + Subject

One sentence explaining the rule.

**Incorrect:**
```typescript
// 3-5 lines max
```

**Correct:**
```typescript
// 3-5 lines max
```

Every rule follows this template: frontmatter with impact metadata, one-sentence description, and at most two code blocks (incorrect + correct). Total file length must be under 50 lines.

Design Philosophy

Concise

Each rule is under 50 lines. AI context windows are expensive — every token must earn its place.

Granular

One file per rule. Easy to add, review, and maintain. No monolithic guides.

Actionable

Incorrect → Correct patterns. AI agents can apply these rules directly to code without interpretation.

Submit a RuleBrowse All Rules

Works With

Claude CodeCursorVS Code CopilotWindsurfAny AGENTS.md-compatible agent