AGENTS.md

1# Agent Guide for camera_android_camerax
2 
3## Core Workflows
4 
5- **Check Environment**: Run [check-readiness](.agents/skills/check-readiness/SKILL.md)
6  when starting a new task or if you suspect environment issues.
7- **Regenerate Code**:
8  - Pigeon (`dart run pigeon --input pigeons/camerax_library.dart`): Run after
9    modifying `pigeons/camerax_library.dart`.
10  - Mocks (`dart run build_runner build -d`): Run after modifying mocked
11    classes or adding new mocks. (see [dart-generate-test-mocks](.agents/skills/dart-generate-test-mocks/SKILL.md))
12- **Verify Tests**: All tests must pass before landing. Add or update tests for
13  any new logic. For integration tests, see [flutter-add-integration-test](.agents/skills/flutter-add-integration-test/SKILL.md).
14- **Run Pre-Push Checks**: Run [pre-push-skill](.agents/skills/pre-push-skill/SKILL.md)
15  before pushing to prevent CI failures and code review blocks.
16 
17## Agent Guidelines
18 
19- Use [receiving-code-review](.agents/skills/receiving-code-review/SKILL.md)
20  to technically verify review feedback before blindly implementing suggestions,
21  especially if feedback seems technically questionable.
22- Use `/grill-me` or `/plan` for complex features before writing code.
23- Maintain high test coverage using [dart-add-unit-test](.agents/skills/dart-add-unit-test/SKILL.md)
24  and [dart-collect-coverage](.agents/skills/dart-collect-coverage/SKILL.md).
25- Avoid duplicating constant strings; reuse existing ones from adjacent code.
26- **Testing Guidelines**: You MUST read and follow all rules in [TESTING.md](TESTING.md) BEFORE writing or modifying any tests. This is CRITICAL for preventing CI flakiness.
27- **CRITICAL**: When spawning subagents, NEVER provide absolute file paths in prompts. ALWAYS use relative paths. Passing absolute paths breaks `Workspace: branch` isolation and causes state bleed into the active workspace.
28- **Validation**: Never run `.ci/scripts/*` or `script/tool_runner.sh` globally to validate local changes. They are slow and modify the entire repository. Always use targeted skills (like `dart-run-static-analysis` or `pre-push-skill`) to run the repo tool scoped to this package.
29