Adding a capability

Adding a capability

1. Put stable input/output types in shared only when multiple packages need them.
2. Add the capability to the narrowest package.
3. Keep external SDK types behind the relevant adapter.
4. Add deterministic unit tests, including failure and policy cases.
5. Expose it through the CLI or a dedicated transport adapter only after the runtime contract is stable.

Before making architectural or safety-sensitive changes, read the relevant Agent Skill — agent-zero-architecture and agent-zero-safety encode these rules in more depth.