agent-zero/plugins/_discovery/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

808 B

Plugin Discovery DOX

Purpose

  • Own contextual plugin discovery cards and welcome-screen promotions.

Ownership

  • plugin.yaml owns metadata and always-enabled status.
  • extensions/ owns backend or WebUI discovery contributions.
  • webui/discovery-store.js owns discovery UI state and actions.

Local Contracts

  • Discovery cards must be accurate, dismissible where appropriate, and avoid advertising already-complete setup.
  • CTA actions must match supported welcome-screen action contracts.
  • Keep card IDs unique and plugin-prefixed.

Work Guidance

  • Prefer backend status checks before surfacing setup or integration prompts.

Verification

  • Smoke-test welcome-screen discovery cards, ordering, dismissal, and CTA behavior after changes.

Child DOX Index

No child DOX files.