agent-directives 0.4.0 → 0.4.1

package/manifest.json

@@ -388,7 +388,7 @@
       "type": "rule",
       "path": "rules/angular/coding-style.md",
       "description": "Concrete Angular coding-style patterns — signals, dependency injection with inject(), change detection, RxJS usage, and TypeScript strictness for Angular code.",
-      "version": "1.0.0",
+      "version": "1.1.0",
       "required": false,
       "category": "angular",
       "tools": [
@@ -407,7 +407,7 @@
       "type": "rule",
       "path": "rules/angular/components-and-templates.md",
       "description": "Concrete patterns for building modern Angular components, signal-based inputs/outputs, OnPush change detection, and v17+ control-flow templates.",
-      "version": "1.1.0",
+      "version": "1.2.0",
       "required": false,
       "category": "angular",
       "tools": [
@@ -428,7 +428,7 @@
       "type": "rule",
       "path": "rules/angular/patterns.md",
       "description": "Concrete Angular application patterns — smart/dumb component split, service-layer ownership, routing/guards/resolvers, HTTP interceptors, and reactive state with signals or RxJS.",
-      "version": "1.0.0",
+      "version": "1.1.0",
       "required": false,
       "category": "angular",
       "tools": [
@@ -453,7 +453,7 @@
       "type": "rule",
       "path": "rules/angular/project-structure.md",
       "description": "Concrete Angular workspace, file-naming, feature-folder, and provider-bootstrapping standards for agents working in Angular applications.",
-      "version": "1.1.0",
+      "version": "1.2.0",
       "required": false,
       "category": "angular",
       "tools": [
@@ -475,7 +475,7 @@
       "type": "rule",
       "path": "rules/angular/security.md",
       "description": "Concrete Angular security rules — XSS prevention, HttpClient discipline, secret handling, route guards, and SSR safety.",
-      "version": "1.0.0",
+      "version": "1.1.0",
       "required": false,
       "category": "angular",
       "tools": [
@@ -501,7 +501,7 @@
       "type": "rule",
       "path": "rules/angular/testing.md",
       "description": "Concrete Angular testing patterns — TestBed configuration, signal-input harnesses, router and HTTP testing utilities, and behavior-first test design.",
-      "version": "1.1.0",
+      "version": "1.2.0",
       "required": false,
       "category": "angular",
       "tools": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-directives",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Reusable agent directives, skills, and CLI tooling for AI coding workflows",
   "license": "MIT",
   "author": "Rob Simpson <rsimpson2@me.com>",

package/rules/angular/coding-style.md

@@ -1,7 +1,7 @@
 ---
 name: angular-coding-style
 description: Concrete Angular coding-style patterns — signals, dependency injection with inject(), change detection, RxJS usage, and TypeScript strictness for Angular code.
-version: 1.0.0
+version: 1.1.0
 required: false
 category: angular
 tools:
@@ -15,6 +15,7 @@ source_urls:
   - https://angular.dev/guide/di
   - https://angular.dev/guide/components/dependency-injection
   - https://rxjs.dev/guide/operators
+  - https://github.com/angular/angular/tree/main/skills/dev-skills/angular-developer/references
 applies_to:
   - src/app/**/*.ts
   - src/**/*.ts
@@ -147,6 +148,17 @@ search$ = this.query$.pipe(
 - Imports ordered: Angular core/common, third-party, project absolute (`@/...`), project relative (`./...`). Match the project's existing convention if it differs.
 - Member order inside a class: signal fields → injected dependencies → inputs/outputs → other state → constructor (if any) → lifecycle hooks → public methods → private methods. Adjust to project style if it has a stronger local convention.
 
+## Deep-Dive Reference Materials
+
+Coding agents should fetch the raw text of these references programmatically when writing or modifying reactivity, dependency injection, and general code style:
+
+- **Signals Overview:** Core signal concepts (`signal`, `computed`), reactive contexts, `untracked`, and async boundaries. Read [signals-overview.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/signals-overview.md)
+- **Dependent State (`linkedSignal`):** Creating writable state linked to source signals. Read [linked-signal.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/linked-signal.md)
+- **Async Reactivity (`resource`):** Fetching asynchronous data directly into signal state. Read [resource.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/resource.md)
+- **Side Effects (`effect`):** Syncing signals to imperative APIs, cleanup, and `afterRenderEffect`. Read [effects.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/effects.md)
+- **DI Fundamentals:** Dependency injection overview, services, and the `inject()` function. Read [di-fundamentals.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/di-fundamentals.md)
+- **Injection Context:** Allowed execution contexts for `inject()` and `runInInjectionContext`. Read [injection-context.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/injection-context.md)
+
 ## Anti-patterns to refuse
 
 - Constructor-injected dependencies on a project that has already adopted `inject()`.

package/rules/angular/components-and-templates.md

@@ -1,7 +1,7 @@
 ---
 name: angular-components-and-templates
 description: Concrete patterns for building modern Angular components, signal-based inputs/outputs, OnPush change detection, and v17+ control-flow templates.
-version: 1.1.0
+version: 1.2.0
 required: false
 category: angular
 tools:
@@ -16,6 +16,7 @@ source_urls:
   - https://angular.dev/guide/signals
   - https://angular.dev/guide/components/inputs
   - https://angular.dev/guide/components/outputs
+  - https://github.com/angular/angular/tree/main/skills/dev-skills/angular-developer/references
 applies_to:
   - src/app/**/*.component.ts
   - src/app/**/*.component.html
@@ -121,6 +122,17 @@ Use the built-in block syntax. Always provide `track` in `@for`.
 - Signals and the `async` pipe drive change detection on `OnPush` components automatically. Do not reach for `ChangeDetectorRef.markForCheck()` or `detectChanges()` unless you have a documented, narrow reason.
 - Do not mutate input objects in place when `OnPush` is in effect — produce new references.
 
+## Deep-Dive Reference Materials
+
+Coding agents should fetch the raw text of these references programmatically when editing related UI and components:
+
+- **Component Fundamentals:** Standalone anatomy, template control flow (`@if`, `@for`). Read [components.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/components.md)
+- **Inputs:** Signal-based inputs, transforms, and model inputs. Read [inputs.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/inputs.md)
+- **Outputs:** Signal-based outputs and custom event best practices. Read [outputs.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/outputs.md)
+- **Host Elements:** Host bindings and attribute injection. Read [host-elements.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/host-elements.md)
+- **Component Styling:** Reusable component styles and encapsulation. Read [component-styling.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/component-styling.md)
+- **Tailwind CSS:** Integrating and styling components with Tailwind. Read [tailwind-css.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/tailwind-css.md)
+
 ## Anti-patterns to refuse
 
 - `@Component({ standalone: false })` on new components without an NgModule that already owns it.

package/rules/angular/patterns.md

@@ -1,7 +1,7 @@
 ---
 name: angular-patterns
 description: Concrete Angular application patterns — smart/dumb component split, service-layer ownership, routing/guards/resolvers, HTTP interceptors, and reactive state with signals or RxJS.
-version: 1.0.0
+version: 1.1.0
 required: false
 category: angular
 tools:
@@ -15,6 +15,7 @@ source_urls:
   - https://angular.dev/guide/http
   - https://angular.dev/guide/di
   - https://angular.dev/guide/signals
+  - https://github.com/angular/angular/tree/main/skills/dev-skills/angular-developer/references
 applies_to:
   - src/app/**/*.component.ts
   - src/app/**/*.component.html
@@ -272,6 +273,18 @@ Under SSR, never touch `window`, `document`, `localStorage`, or `navigator` dire
 [aria-disabled="true"] { opacity: 0.5; cursor: not-allowed; }
 ```
 
+## Deep-Dive Reference Materials
+
+Coding agents should fetch the raw text of these references programmatically when writing or modifying general architectural patterns, forms, routing, or HTTP mechanics:
+
+- **Form Management:** Signal-based forms (v21+), template-driven, and reactive forms. Read [signal-forms.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/signal-forms.md), [template-driven-forms.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/template-driven-forms.md), and [reactive-forms.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/reactive-forms.md)
+- **Route Definitions:** URL paths, static vs dynamic segments, wildcards, and redirects. Read [define-routes.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/define-routes.md)
+- **Route Loading & Outlets:** Lazy loading strategies and named `<router-outlet>` routing. Read [loading-strategies.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/loading-strategies.md) and [show-routes-with-outlets.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/show-routes-with-outlets.md)
+- **Navigation & Access Control:** Declarative or programmatic routing, and route security with guards. Read [navigate-to-routes.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/navigate-to-routes.md) and [route-guards.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/route-guards.md)
+- **Pre-fetching & Lifecycle:** Route resolvers (`ResolveFn`) and navigation lifecycle stages. Read [data-resolvers.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/data-resolvers.md) and [router-lifecycle.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/router-lifecycle.md)
+- **Rendering Strategies:** SSR with hydration, SSG (prerendering), and CSR. Read [rendering-strategies.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/rendering-strategies.md)
+- **Transition Animations:** Customizing View Transitions API routes. Read [route-animations.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/route-animations.md)
+
 ## Anti-patterns to refuse
 
 - `HttpClient` injected into a presentational component.

package/rules/angular/project-structure.md

@@ -1,7 +1,7 @@
 ---
 name: angular-project-structure
 description: Concrete Angular workspace, file-naming, feature-folder, and provider-bootstrapping standards for agents working in Angular applications.
-version: 1.1.0
+version: 1.2.0
 required: false
 category: angular
 tools:
@@ -14,6 +14,7 @@ source_urls:
   - https://angular.dev/tools/cli
   - https://angular.dev/reference/configs/workspace-config
   - https://angular.dev/guide/ngmodules/standalone
+  - https://github.com/angular/angular/tree/main/skills/dev-skills/angular-developer/references
 applies_to:
   - angular.json
   - package.json
@@ -126,6 +127,17 @@ export const routes: Routes = [
 - Do not add React, Vue, or other-framework conventions to an Angular project. If shared code must straddle frameworks, isolate it behind a framework-neutral library.
 - Match the project's existing module system (ESM vs CommonJS) and import style. Use path aliases from `tsconfig.json` where the project already defines them.
 
+## Deep-Dive Reference Materials
+
+Coding agents should fetch the raw text of these references programmatically when planning workspace boundaries, scaffolding, dependency injection structures, or upgrades:
+
+- **CLI Scaffolding:** CLI command syntax and scaffolding options. Read [cli.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/cli.md)
+- **Creating Services:** Generating services, the `providedIn: 'root'` option, and injection guidelines. Read [creating-services.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/creating-services.md)
+- **Defining Providers:** Token definition patterns (`InjectionToken`, `useValue`, `useFactory`). Read [defining-providers.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/defining-providers.md)
+- **Hierarchical Injectors:** Understanding injector layers (`EnvironmentInjector`, `ElementInjector`), resolution rules, and `viewProviders`. Read [hierarchical-injectors.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/hierarchical-injectors.md)
+- **Migrations & Upgrades:** Modernizing older code bases via automated migrations. Read [migrations.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/migrations.md)
+- **Angular MCP Server:** Supported features and configuration of the Model Context Protocol language tools. Read [mcp.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/mcp.md)
+
 ## Anti-patterns to refuse
 
 - A single `shared/` directory accumulating unrelated services, pipes, components, and constants.

package/rules/angular/security.md

@@ -1,7 +1,7 @@
 ---
 name: angular-security
 description: Concrete Angular security rules — XSS prevention, HttpClient discipline, secret handling, route guards, and SSR safety.
-version: 1.0.0
+version: 1.1.0
 required: false
 category: angular
 tools:
@@ -14,6 +14,7 @@ source_urls:
   - https://angular.dev/api/platform-browser/DomSanitizer
   - https://angular.dev/guide/http/security
   - https://angular.dev/guide/ssr
+  - https://github.com/angular/angular/tree/main/skills/dev-skills/angular-developer/references
 applies_to:
   - src/app/**/*.component.ts
   - src/app/**/*.component.html
@@ -136,6 +137,12 @@ Configure CSP headers server-side. Specifically:
 - Treat `npm audit` / `pnpm audit` / `yarn audit` findings as real signals. Resolve high-severity issues before shipping touched code paths.
 - Do not pin to versions with known active CVEs as a workaround for a feature change.
 
+## Deep-Dive Reference Materials
+
+Coding agents should fetch the raw text of these references programmatically when verifying accessibility standards and headless component configurations:
+
+- **Angular Aria Components:** Building headless, accessible components (Accordion, Listbox, Combobox, Menu, Tabs, Toolbar, Tree, Grid) and styling ARIA attributes. Read [angular-aria.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/angular-aria.md)
+
 ## Anti-patterns to refuse
 
 - `bypassSecurityTrust*` on a value derived in any way from user input.

package/rules/angular/testing.md

@@ -1,7 +1,7 @@
 ---
 name: angular-testing
 description: Concrete Angular testing patterns — TestBed configuration, signal-input harnesses, router and HTTP testing utilities, and behavior-first test design.
-version: 1.1.0
+version: 1.2.0
 required: false
 category: angular
 tools:
@@ -15,6 +15,7 @@ source_urls:
   - https://angular.dev/guide/testing/services
   - https://angular.dev/guide/testing/http
   - https://material.angular.io/cdk/test-harnesses/overview
+  - https://github.com/angular/angular/tree/main/skills/dev-skills/angular-developer/references
 applies_to:
   - src/app/**/*.spec.ts
   - src/app/**/*.test.ts
@@ -199,6 +200,15 @@ describe('UserService', () => {
 - Avoid brittle template snapshots unless the project already uses them and the assertion is intentionally structural.
 - Do not migrate the project's test runner, assertion library, or harness choices as part of a feature change.
 
+## Deep-Dive Reference Materials
+
+Coding agents should fetch the raw text of these references programmatically when writing or modifying tests:
+
+- **Testing Fundamentals:** Best practices for unit testing, async patterns, and `TestBed`. Read [testing-fundamentals.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/testing-fundamentals.md)
+- **Component Harnesses:** CDK component harnesses for robust, layout-insulated test assertions. Read [component-harnesses.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/component-harnesses.md)
+- **Router Testing:** Testing navigation scenarios via `RouterTestingHarness`. Read [router-testing.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/router-testing.md)
+- **End-to-End Testing:** Cypress-based browser/integration test structures. Read [e2e-testing.md](https://raw.githubusercontent.com/angular/angular/main/skills/dev-skills/angular-developer/references/e2e-testing.md)
+
 ## Anti-patterns to refuse
 
 - Setting signal inputs by assignment (`component.user = ...`) instead of `componentRef.setInput()`.