Skip to content

Add custom agents and Flutter accessibility agent documentation - #13837

Merged
jesskuras merged 7 commits into
flutter:mainfrom
jesskuras:custom-agent-docs
Sep 3, 2026
Merged

Add custom agents and Flutter accessibility agent documentation#13837
jesskuras merged 7 commits into
flutter:mainfrom
jesskuras:custom-agent-docs

Conversation

@jesskuras

@jesskuras jesskuras commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Description

This PR introduces documentation for Custom agents and the Flutter Accessibility (a11y) custom agent (flutter_a11y_agent) across the Flutter AI documentation:

  • /ai/get-started: Added Custom agents to the introductory core capabilities overview alongside Agent skills and the Dart & Flutter MCP server.
  • /ai/tools:
    • Added Custom agents to the tooling ecosystem overview and the "When to use what" comparison matrix.
    • Added a dedicated Custom agents section explaining how custom agents run in isolated contexts for focused workflows.
    • Documented the Flutter Accessibility agent capabilities (semantic labels, tap target sizing, contrast/visual checks, and automated code remediation).
    • Added usage instructions for invoking @flutter_a11y_agent in Antigravity.

Presubmit checklist

  • If you are unwilling, or unable, to sign the CLA, even for a tiny, one-word PR, please file an issue instead of a PR.
  • If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
  • This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
  • This PR uses semantic line breaks of 80 characters or fewer.

@jesskuras
[docs] Add custom agents and Flutter accessibility agent documentation
93167de 
- Add Custom agents to the core capabilities overview in /ai/get-started.
- Add Custom agents to the tooling ecosystem overview and comparison matrix in /ai/tools.
- Document the Flutter Accessibility (a11y) custom agent (flutter_a11y_agent) and its core review capabilities.
- Add usage instructions for invoking the accessibility agent in Antigravity.
@jesskuras
jesskuras requested review from a team and sfshaza2 as code owners August 31, 2026 23:00
gemini-code-assist[bot]
gemini-code-assist Bot reviewed Aug 31, 2026
View reviewed changes

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Flutter AI documentation to introduce "Custom agents" as a core capability and component of the ecosystem, specifically highlighting the Flutter Accessibility (a11y) agent and its usage in Google Antigravity. The feedback suggests replacing "dp" with "logical pixels" to align with Flutter's standard unit of measurement, and spelling out "accessibility" instead of using the abbreviation "a11y" in the summary table for better clarity.

Comment thread sites/docs/src/content/ai/tools.md Outdated
Comment thread sites/docs/src/content/ai/tools.md Outdated
@flutter-website-bot

flutter-website-bot commented Aug 31, 2026 •
edited
Loading

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit e350da6):

https://flutter-docs-prod--docs-pr13837-custom-agent-docs-21aimpia.web.app

@jesskuras
jesskuras marked this pull request as draft August 31, 2026 23:13
@flutter-website-bot

flutter-website-bot commented Aug 31, 2026 •
edited
Loading

Copy link
Copy Markdown
Collaborator

Staged preview of the updated flutter.dev site (updated for commit e350da6):

https://flutter-dev-230821--www-pr13837-custom-agent-docs-b1isg9sv.web.app

@jesskuras
jesskuras requested a review from mariamhas August 31, 2026 23:37
@jesskuras
jesskuras marked this pull request as ready for review August 31, 2026 23:37
gemini-code-assist[bot]
gemini-code-assist Bot reviewed Aug 31, 2026
View reviewed changes

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Flutter AI documentation to introduce "Custom agents" as a new component of the tooling ecosystem, specifically highlighting the Flutter Accessibility (a11y) agent in Google Antigravity. Feedback was provided regarding a split Markdown link, which should be kept on a single line to ensure correct rendering.

Comment thread sites/docs/src/content/ai/tools.md
jesskuras and others added 2 commits August 31, 2026 16:42
@jesskuras
Merge branch 'main' into custom-agent-docs
227bf7b
@jesskuras @gemini-code-assist
Update sites/docs/src/content/ai/tools.md
64e87a9 
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
mariamhas
mariamhas approved these changes Sep 3, 2026
View reviewed changes

@mariamhas mariamhas left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@lamek
lamek self-requested a review September 3, 2026 18:52
lamek
lamek approved these changes Sep 3, 2026
View reviewed changes

@lamek lamek left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

I added 2 thoughts and 1 suggestion.

Comment thread sites/docs/src/content/ai/get-started.md Outdated
Comment thread sites/docs/src/content/ai/tools.md Outdated
Comment thread sites/docs/src/content/ai/tools.md Outdated
@jesskuras
jesskuras merged commit d83fa84 into flutter:main Sep 3, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@lamek lamek lamek approved these changes
@mariamhas mariamhas mariamhas approved these changes
@sfshaza2 sfshaza2 Awaiting requested review from sfshaza2 sfshaza2 is a code owner
+1 more reviewer
@gemini-code-assist gemini-code-assist[bot] gemini-code-assist[bot] left review comments
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@jesskuras @flutter-website-bot @lamek @mariamhas