Angular Coding Standards

Version-aware Angular development patterns.

Pre-Edit Analysis

Trước khi edit Angular code, read: → C:\Users\BLogic\.cursor\skills\project-scanner\SKILL.md

Quality gates cho high-risk edits (change signature, shared service, delete/rename).

Setup

Step 0: Scan Existing Patterns (Nếu project có code)

Trước khi tạo mới, scan project để follow convention đang dùng:

Glob: **/*.service.ts → Xem service pattern
Glob: **/*.component.ts → Xem component pattern  
Glob: **/*.model.ts → Xem model/interface pattern
Grep: FormGroup → Xem form pattern

Step 1: Detect Angular Version

Read package.json and find @angular/core version:

"@angular/core": "^17.0.0"  // → v17
"@angular/core": "~15.2.0"  // → v15

Step 2: Load Appropriate Patterns

Based on detected version, read the relevant files:

Version	Files to Read
v13-14	base.md + module-based.md
v15-16	base.md + standalone.md + signals.md (preview)
v17	base.md + standalone.md + signals.md + control-flow.md
v18-19+	base.md + standalone.md + signals.md + control-flow.md + advanced-v18-19.md

Quick Reference

Naming Conventions (All Versions)

Type	Convention	Example
Signal	Prefix $	$user, $state
Observable	Suffix $	isLoading$, data$
Private	Prefix _	_destroyed$, _load()

Core Principles

Priority	Principle	Guideline
🥇	Angular-native first	95% dùng Angular built-in (reactive forms, validators, pipes, directives). 5% custom code khi Angular không hỗ trợ
🥈	Performance	OnPush, signals, object mapping > array loop, minimal subscriptions
🥉	Readability	Simple code, dễ đọc, dễ sửa cho dev khác. OOP + SOLID

Decision Flow

Có vấn đề cần giải quyết?
    ↓
Angular có built-in? (FormControl, Pipe, Directive, Validator...)
    ├─ YES → Dùng Angular (95%)
    └─ NO  → Tạo custom với SOLID pattern (5%)

File Index

• base.md - Common patterns all versions
• module-based.md - NgModule patterns (v13-14)
• standalone.md - Standalone components (v15+)
• signals.md - Signals API (v16+)
• control-flow.md - @if/@for/@defer (v17+)
• advanced-v18-19.md - Signal inputs, linkedSignal (v18+)