workflow-new-agent

To define new agent roles in Volon workflows, you generate stage-based artifacts for purpose, scope, context, interface, plan, and tasks. This automated approach ensures reproducible role design by applying idempotent steps that conform to project workflow contracts.

Idempotent agent artifacts are documentation and task files generated safely without overwriting existing work. They matter because applying idempotent checks during stage-based generation prevents duplicate artifacts when defining or updating automated worker roles in a Volon development workflow.

You create an automated worker agent by running a stage-based generation process that produces role addenda, interface specs, implementation plans, and task files. This yields orchestrator-ready documentation while automatically refreshing the PCC and updating bootstrap state.

Defining a new Volon agent does not require updating bootstrap state manually. The generation process automatically reads project metadata like volon.yaml and updates the bootstrap state via PCC refresh, ensuring the new role integrates seamlessly without manual state tracking.

The best way to avoid duplicate artifacts when onboarding a reviewer agent is using idempotent, stage-based generation. This method checks existing work before producing purpose, scope, and task files, ensuring artifacts are never overwritten and the PCC remains clean.