Join the lifecycle where you are.
Every lifecycle runs on its assets: the statement, the tests, the code, the package, the records. Everybody starts with some of them already.
Start from the furthest thing you already have.
- If you already have an idea,start at RequirementsWrite the statement of the job. Everything after is checked against it.
- If you already have a prototype,start at Test, then CodeWrite the statement of the job from your prototype, then Test.
- If you already have working code,start at Package on-rampBring the statement and your programs; Package lists every program.
- If you already have a package or an image,start at Release on-ramp, then Deploy goes liveGive it an address and a signed build record, then deploy it.
- If you already have a remote agent with an A2A endpoint,register it with a platformIts Agent Card gives most of its Descriptor. Add what it refuses and what records it keeps. No package needed.
- If you already have an agent connected to a network through a node,it's already on; start at DocsFinish its Descriptor so people can find it.
- If you already have agents running on a platform,start at Run and ChangeWatch them, judge their work, and change them with a record.
Every asset fills in a little more of the picture.
Here they are in stage order. Dashed ones are optional. Solid ones are required. Every agent has a signed Descriptor and its registration, and every agent a platform runs also has the package and the signed records from Release on, each as it happens.
- Statement of the jobRequirementsoptional
- Architecture recordArchitecture and Designoptional
- DesignArchitecture and Designoptional
- Impact reportImpactoptional
- Catalog answersSourceoptional
- Test suiteTestoptional
- CodeCodeoptional
- Review findingsReviewoptional
- Security statementSecurity reviewoptional
- The packagePackage on-rampplatform-run
- Signed build recordRelease on-rampplatform-run
- Signed Descriptor and registrationDeploy goes liveevery agent
- Signed deployment recordDeploy goes liveplatform-run
- Conformance verdictConformanceplatform-run
- AttestationsConformanceplatform-run
- AcceptanceAcceptanceplatform-run
- AgentDocDocsplatform-run
- Published addressPublishplatform-run
- Retraction recordRetractplatform-run
- Receipts, usage and costCostplatform-run
- Graded judgmentsEvalplatform-run
- Incident recordsIncident responseplatform-run
- Change recordsUpdate, Reconfigure, Rollbackplatform-run
- Decommission recordDecommissionplatform-run
- optional: whatever your lifecycle makes before the package
- every agent: the signed Descriptor and its registration
- platform-run: every agent a platform runs has the package, and the records from Release on, as each happens
Here is every asset, its parts, and the stage that makes it.
| Asset | Its parts | Made at | Who has it |
|---|---|---|---|
| Statement of the job |
| Requirements | optional |
| Architecture record |
| Architecture and Design | optional |
| Design |
| Architecture and Design | optional |
| Impact report |
| Impact | optional |
| Catalog answers |
| Source | optional |
| Test suite |
| Test | optional |
| Code |
| Code | optional |
| Review findings |
| Review | optional |
| Security statement |
| Security review | optional |
| The package |
| Package on-ramp | platform-run |
| Signed build record |
| Release on-ramp | platform-run |
| Signed Descriptor and registration |
| drafted at Package on-ramp, bound and signed at Deploy goes live | every agent |
| Signed deployment record |
| Deploy goes live | platform-run |
| Conformance verdict |
| Conformance | platform-run |
| Attestations |
| Conformance, and by any attester after: see your checking tool | platform-run |
| Acceptance |
| Acceptance | platform-run |
| AgentDoc |
| Docs | platform-run |
| Published address |
| Publish | platform-run |
| Retraction record |
| Retract | platform-run |
| Receipts, usage and cost |
| Cost | platform-run |
| Graded judgments |
| Eval | platform-run |
| Incident records |
| Incident response | platform-run |
| Change records |
| Update Reconfigure Rollback | platform-run |
| Decommission record |
| Decommission | platform-run |
Only the ending is fixed.
Everything before the package is yours to shape. Every agent, wherever it runs, ends with a signed Descriptor and a registration that points at it. An agent a platform runs also has its Agent Package and the records each later stage leaves.