agent-zero/agents/agent0/AGENTS.md
frdel e138e33ca9 Add file-level DOX docs & update AGENTS indexes
Add comprehensive file-level DOX documentation across the repo and update directory AGENTS.md indexes. Many new `*.py.dox.md` files were added under api, helpers, tools, plugins, extensions, webui, and other dirs to document endpoint purpose, ownership, runtime contracts, work guidance, and verification. Several AGENTS.md files were created or updated (agents profiles, api, docker, extensions, helpers, plugins, skills, webui components, etc.) to list child DOX files and clarify documentation/work guidance. Also add example and bundled profile DOX files (agent0, default, developer, hacker, researcher) and minor updates to helpers/dirty_json.py and its tests. These changes improve on-disk documentation coverage and establish the convention that each direct runtime file should have a matching `*.dox.md` describing its contracts and verification steps.
2026-06-08 12:41:53 +02:00

1.1 KiB

Agent 0 Profile DOX

Purpose

  • Own the main user-facing Agent Zero profile metadata.
  • Keep the primary assistant profile discoverable and distinct from subordinate specialist profiles.

Ownership

  • agent.yaml owns the profile title, description, and delegation context.
  • Prompt behavior is inherited from the default profile unless a local prompt override is added.

Local Contracts

  • Keep Agent 0 suitable as the direct conversation agent for the system.
  • Do not add narrow specialist behavior that belongs in developer/, researcher/, hacker/, or a custom user profile.
  • Do not store user-specific preferences, provider settings, or secrets in this profile.

Work Guidance

  • Keep metadata concise because it appears in profile selection and delegation contexts.
  • Coordinate substantial behavior changes with default prompts and WebUI profile selection.

Verification

  • Manually inspect agent.yaml for valid YAML after edits.
  • Run profile-loading tests when changing schema or discovery behavior.

Child DOX Index

No child DOX files.