| 1 | # Agent Editor |
| 2 | |
| 3 | Agent Editor provides the deterministic Easy modal and Advanced workspace for |
| 4 | Agent Zero profiles. It reads the existing layered profile architecture and |
| 5 | writes only sparse overrides in the selected Global or project profile layer. |
| 6 | |
| 7 | The editor never invokes a model. Tool and skill controls are backed by the |
| 8 | central runtime policy owners, and every save is previewed as exact file writes |
| 9 | and deletions before the same validated plan is applied. |
| 10 | |
| 11 | Easy and Advanced use the same segmented capability policy: On pins an item |
| 12 | allowed, Off pins it blocked, and Default follows the profile's Tools, MCPs, or |
| 13 | Skills default switch. Easy places each chooser below its default switch; |
| 14 | Advanced gives Tools, MCPs, and Skills separate searchable sections and adds |
| 15 | retained unavailable entries plus ACE-based prompt editing. |
| 16 | |
| 17 | Global agents and customizations live under `usr/agents/<profile-id>` and apply |
| 18 | across projects. Project-scoped agents and customizations live under |
| 19 | `usr/projects/<project>/.a0proj/agents/<profile-id>`, inherit the Global layer, |
| 20 | and can be removed without changing it. |
| 21 | |
| 22 | Manage agents can duplicate the effective profile into the selected scope and |
| 23 | toggle whether each profile is available there. Project availability reuses |
| 24 | `.a0proj/agents.json`; Global availability is a sparse profile override. |
| 25 | The selected scope must always keep at least one profile available. |
| 26 | The bundled `default` profile remains the internal inheritance baseline and is |
| 27 | not offered as a selectable or editable profile. |