AGENTS.md

1---
2trigger: always_on
3---
4 
5This is the source code for the Angular framework. This guide outlines standard practices for AI agents working in this repository.
6 
7## Environment
8 
9- Use `pnpm` for package management.
10- Use `pnpm bazel test //target` to run tests.
11 
12## Key Documentation
13 
14- [Building and Testing](contributing-docs/building-and-testing-angular.md): definitive guide for running targets.
15- [Coding Standards](contributing-docs/coding-standards.md): style guide for TypeScript and other files.
16- [Commit Guidelines](contributing-docs/commit-message-guidelines.md): format for commit messages and PR titles.
17 
18## Testing
19 
20- **Zoneless & Async-First:** Assume a zoneless environment where state changes schedule updates asynchronously.
21  - **Do NOT** use `fixture.detectChanges()` to manually trigger updates.
22  - **ALWAYS** use the "Act, Wait, Assert" pattern:
23    1. **Act:** Update state or perform an action.
24    2. **Wait:** `await fixture.whenStable()` to allow the framework to process the scheduled update.
25    3. **Assert:** Verify the output.
26- To keep tests fast, minimize the need for waiting:
27  - Use `useAutoTick()` (from `packages/private/testing/src/utils.ts`) to fast-forward time via the mock clock.
28- When waiting is necessary, use real async tests (`it('...', async () => { ... })`) along with:
29  - `await timeout(ms)` (from `packages/private/testing/src/utils.ts`) to wait a specific number of milliseconds.
30  - `await fixture.whenStable()` to wait for framework stability.
31 
32## Pull Requests
33 
34- Use the `gh` CLI (GitHub CLI) for creating and managing pull requests.
35