agent-zero/docker/base/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.2 KiB

Docker Base Image DOX

Purpose

  • Own the Agent Zero base image build context.
  • Build the operating system, package, Python, SearXNG, SSH, and bootstrap layers reused by runnable images.

Ownership

  • Dockerfile owns base image layering and installation order.
  • build.txt owns maintainer build and push command notes.
  • fs/ins/ owns installation scripts copied into the image.
  • Files under fs/ are copied to container root during the base build.

Local Contracts

  • Preserve cache-friendly package and runtime installation stages.
  • Keep locale and timezone defaults compatible with the root Docker contract.
  • Do not add secrets, user data, or local environment files to the image context.
  • Installation scripts must be noninteractive and suitable for multi-architecture buildx runs.

Work Guidance

  • Keep base dependencies here only when they are common to runnable Agent Zero images.
  • Coordinate Python runtime changes with root Docker documentation and runnable image setup.

Verification

  • Build docker/base when changing Dockerfile or install scripts.
  • Run a runnable image smoke check when base runtime behavior changes.

Child DOX Index

No child DOX files.