docs: add Signal Forms and v22 guidance to AI best-practices and llms.txt

Jad31 · atscott · commit 248e9c146df0 · 2026-06-09T13:59:56.000-07:00
Update the AI codegen resources for Angular v22: - best-practices.md: OnPush is the default in v22+ (don't set it explicitly), recommend Signal Forms, and recommend the @service decorator. - llms.txt: add a Signal Forms reference, the httpResource guide, and an Accessibility section linking the Angular Aria overview.
diff --git a/adev/src/llms.txt b/adev/src/llms.txt
@@ -64,6 +64,7 @@ Angular — Deliver web apps with confidence 🚀
 - [Setting up the HttpClient](https://angular.dev/guide/http/setup)
 - [Making requests](https://angular.dev/guide/http/making-requests)
 - [Intercepting requests](https://angular.dev/guide/http/interceptors)
+- [Reactive data fetching with httpResource](https://angular.dev/guide/http/http-resource)
 - [Testing](https://angular.dev/guide/http/testing)
 
 ## Forms
@@ -73,6 +74,10 @@ Angular — Deliver web apps with confidence 🚀
 - [Template driven forms](https://angular.dev/guide/forms/template-driven-forms)
 - [Validate forms input](https://angular.dev/guide/forms/form-validation)
 - [Building dynamic forms](https://angular.dev/guide/forms/dynamic-forms)
+- [Signal Forms](https://angular.dev/guide/forms/signals/overview)
+
+## Accessibility
+- [Angular Aria overview](https://angular.dev/guide/aria/overview)
 
 ## Routing
 - [Routing overview](https://angular.dev/guide/routing)
diff --git a/packages/core/resources/best-practices.md b/packages/core/resources/best-practices.md
@@ -10,6 +10,7 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 
 - Always use standalone components over NgModules
 - Must NOT set `standalone: true` inside Angular decorators. It's the default in Angular v20+.
+- Do NOT set `changeDetection: ChangeDetectionStrategy.OnPush` explicitly. `OnPush` is the default in Angular v22+.
 - Use signals for state management
 - Implement lazy loading for feature routes
 - Do NOT use the `@HostBinding` and `@HostListener` decorators. Put host bindings inside the `host` object of the `@Component` or `@Directive` decorator instead
@@ -29,7 +30,8 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 - Use `computed()` for derived state
 - Use `linkedSignal()` for state derived from multiple reactive sources that must stay synchronized
 - Prefer inline templates for small components
-- Prefer Reactive forms instead of Template-driven ones
+- Prefer Signal Forms (`@angular/forms/signals`) for new forms. They are stable in Angular v22+ and provide signal-based state, type-safe field access, and schema-based validation
+- When not using Signal Forms, prefer Reactive forms instead of Template-driven ones
 - Do NOT use `ngClass`, use `class` bindings instead
 - Do NOT use `ngStyle`, use `style` bindings instead
 - When using external templates/styles, use paths relative to the component TS file.
@@ -52,4 +54,5 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 
 - Design services around a single responsibility
 - Use the `providedIn: 'root'` option for singleton services
+- Prefer the `@Service` decorator over `@Injectable({providedIn: 'root'})` for new singleton services (Angular v22+)
 - Use the `inject()` function instead of constructor injection
