agent-zero/agents/developer/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

Developer Agent Profile DOX

Purpose

  • Own the bundled software development specialist profile.
  • Keep development, debugging, refactoring, and architecture behavior separate from general agent defaults.

Ownership

  • agent.yaml owns title, description, and delegation context for software development work.
  • prompts/ owns developer-specific prompt overrides when present.
  • extensions/ owns developer-specific lifecycle hooks when present.

Local Contracts

  • Keep this profile focused on software engineering tasks.
  • Do not hardcode repository-local credentials, paths, or project-specific conventions.
  • Prompt overrides must preserve the framework tool-call and response contracts.

Work Guidance

  • Align developer behavior with the root engineering and tool contracts.
  • Prefer profile prompt edits over core prompt edits when the behavior is specific to development tasks.

Verification

  • Manually inspect agent.yaml for valid YAML after edits.
  • Run prompt/profile tests when changing profile loading or developer prompt behavior.

Child DOX Index

No child DOX files.