agent-zero/skills/a0-development/AGENTS.md
Alessandro 4b49386f96 Refactor a0-development into grounded references
Split the monolithic a0-development skill into a lean entry point plus focused reference files for runtime, DOX, tools, extensions, API/WebUI, profiles, prompts, skills, projects, and plugin workflow.

Update the skill DOX ownership for the new references directory and clarify the root framework-vs-agent Python runtimes plus port-discovery guidance.

Verified with git diff --check, targeted skill/tool tests under PYTHONPATH, and live localhost:32769 skill loading/read_file checks before committing.
2026-06-23 17:51:43 +02:00

1.6 KiB

Development Skill DOX

Purpose

  • Own the broad Agent Zero development guide used by agents extending the framework.
  • Keep architecture, tools, extensions, API, agents, prompts, projects, plugins, runtime, and skills guidance in sync with the repository.

Ownership

  • SKILL.md owns the concise development entry point, routing workflow, path conventions, and reference map.
  • references/ owns detailed source-grounded development references loaded on demand.

Local Contracts

  • Keep paths and examples current with source files and DOX contracts.
  • Route plugin-specific tasks to the plugin router or specialist plugin skills.
  • Do not duplicate long contracts that belong in narrower AGENTS.md files when a reference is enough.
  • Reference files must identify current source or DOX anchors and avoid hardcoded default WebUI ports.

Work Guidance

  • Update this skill after durable framework workflow, extension, tool, API, prompt, or profile changes.
  • Keep examples operational and compatible with the current helper classes.
  • Keep SKILL.md lean; move detailed schemas, examples, and topic-specific guidance to references/.

Verification

  • Manually read SKILL.md and changed reference files for stale architecture references, broken relative paths, and specialist-skill duplication.
  • Load the skill after reference-map changes and confirm skills_tool exposes the expected reference file tree.

Child DOX Index

Direct child DOX files:

Child Scope
references/AGENTS.md Source-grounded development references loaded by this skill.