Skip to content
Agent Friendly Code

What to put in an AGENTS.md for Angular

Agents learned Angular from NgModules, zone.js and *ngIf. Standalone is the default since v20, new apps are zoneless since v21, and new CLI projects test with Vitest; Angular publishes its own AI rules file to start from.

By Himanshu Singh · Updated · How we score →

Which commands should it list?

  • ng servedev server
  • ng buildthe @angular/build:application builder by default
  • ng testVitest in new projects; Karma still supported
  • ng generate component <name>or ng g; scaffolds where the CLI expects
  • npx @angular/cli mcpthe CLI's experimental MCP server

Write them as your repo runs them, with its package manager and flags, plus how to run one test.

What layout should it explain?

  • The Angular major, and whether the app is zoneless or still loads zone.js.
  • The test runner, Vitest or Karma, so tests use the right APIs.
  • Which project in angular.json is the app, and where feature folders and shared libraries live.

What do agents get wrong?

  • Don't set standalone: true; it is the default since v20.
  • Use @if, @for and @switch, not *ngIf, *ngFor and *ngSwitch.
  • Signals for state and computed() for derived state.
  • Zoneless is the default since v21; don't rely on zone.js to trigger change detection.

From the official docs: angular.dev/develop-with-ai (new tab) · angular.dev/mcp (new tab) · angular.dev/zoneless (new tab) · angular.dev/testing (new tab) · angular.dev/generate (new tab) · angular.dev/releases (new tab). The rest of the file is the same for any project: what goes in an AGENTS.md.

Angular repos with an AGENTS.md or CLAUDE.md (4)

Built on Angular; 4 pass the AGENTS.md check in full.

Angular repos with an AGENTS.md or CLAUDE.md
RepoFileLengthStarsLanguageScore
bitwarden/clients.claude/CLAUDE.md 3,393 chars14.3k ★TypeScript83.2
NG-ZORRO/ng-zorro-antdAGENTS.md 2,263 chars9.2k ★TypeScript89.5
taiga-family/taiga-uiAGENTS.md 10,530 chars4.1k ★TypeScript83.2
opf/openprojectAGENTS.md 4,767 chars17.6k ★Ruby85.9

By language: TypeScript AGENTS.md examples

More examples: Next.js · React · FastAPI · Flutter · Android · .NET · Rails · Vue · Laravel · Django · React Native · Spring Boot · iOS · all examples