dify/dify-agent/AGENTS.md

Agent Guide

Read surrounding docstrings and non-obvious comments before changing behavior. They are local contracts; update them only when their owned behavior changes, and keep them aligned with the current code. Read docs/dify-agent/index.md when changing the public runtime contract.

Commands

Run package commands from dify-agent/:

• Lint: make check
• Format and fix lint: make fix
• Type check: make typecheck
• Tests: make test

Use the package's uv environment and Pydantic v2 APIs. Inspect current dependency source or official documentation before integrating, implementing, or mocking an API whose runtime contract is not established locally.

Tests And Boundaries

• Keep local tests under tests/local/ and mirror the src/ package structure.
• Test stable behavior and real dependency boundaries. Do not use local mocks to claim real network, framework wiring, serialization, or third-party runtime coverage.
• Keep tests, public docs, and local contracts aligned with behavior changes.
• Preserve the existing runtime and layer owners; do not add generic utilities or compatibility boundaries to bypass them.