It builds agents and processes.

The lifecycle builds anything that has a standard shape. Requirements writes that standard's own document from the first draft, and every stage after it reads the same document.

One shape from the first stage

What a build makes is never kept in a private format and converted at the end. The statement of the job is already written in the standard the finished thing will follow, so it is the statement and the design at once. The test writer tests what it declares, the next stage builds what it names, Conformance checks the finished thing against it, and the listing is copied from it.

The stages stay the same for every kind. What each stage hands back changes with the kind.

The two kinds

An agentA process
Shaped asa Common Agent (the Common Agent Specification)an Agent Processes document (the Agent Processes Specification)
Requirements writesthe Descriptor: what the agent offers, takes, hands back and refusesthe process document: its steps, who holds each, what a run is handed, what passes between steps and where a person signs
Tested bya suite of tests, written before the scriptsa suite of test cases, written before the wiring and run as test runs
Ships asan Agent Package, signedthe process document and its test cases, pinned by digest and signed
Proven byConformance: the running agent keeps the promises its Descriptor makesConformance: the document meets the specification, and every test case passes
Listed asits AgentDoc and a catalog entrya process entry in a catalog, copied from the document's header

Stage by stage

StageFor an agentFor a process
Requirementsthe Descriptor, with the questions only the person can answerthe process document, with the questions only the person can answer
Architecture and Designhow the agent is builtwho holds each step, and what each step hands the next
Impactwho depends on the agentwho depends on the process: other processes that run it, and agreements pinned to its digest
Sourcean agent or a part that already existsan agent that already holds the step, or a new one made by Make a new agent
Testthe suite, shown to fail against nothingthe test cases: what each run is handed, how each approval is answered, what must be true at the end
Codethe scripts, passing the suitethe wiring: the holders bound, and each handoff fitted to the step that receives it
Review and Securityfindings on the code, and what it may reachfindings on the document, and what its steps may reach outside
Package and Releasethe Agent Package and its signed build recordthe document and its test cases, pinned by digest, with a signed record
Deploythe agent installed with its credentials and limitsthe process filed with the organization's processes and bound to its trigger
Conformancethe agent checked against its declarationsthe document checked against the specification, and the suite passed
Acceptancethe person tries it and says yesthe person runs it for real and says yes
Docs and Publishthe AgentDoc, and the catalog entrythe catalog's process entry
Updatea new version, proven before it is promotedan amendment, a new version whose suite passes before it runs real work
Decommissionthe agent's address stops answeringthe process stops starting runs, and its listing comes down

A process can need an agent

When Source finds no agent that can hold a step, the process build runs Make a new agent for that step and waits for it. The new agent goes through every stage of its own lifecycle, and the process build carries on once it is installed and proven. One request can therefore make a process and the agents it needs, each checked by its own standard.

Adding a kind

Any other kind of work can go through the same stages if it has three things:

  • a standard document that says what the finished thing is, which Requirements writes from the first draft;
  • a way to test it that a program can run, written before the thing is built;
  • a way to pin it, sign it and list it, so anyone downstream can check that what they were given is what was approved.

The stages, the handoffs and the way a person says yes stay as they are.