AGENTS.md

1# Agent Guide
2 
3Read 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.
4 
5## Commands
6 
7Run package commands from `dify-agent/`:
8 
9- Lint: `make check`
10- Format and fix lint: `make fix`
11- Type check: `make typecheck`
12- Tests: `make test`
13 
14Use 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.
15 
16## Tests And Boundaries
17 
18- Keep local tests under `tests/local/` and mirror the `src/` package structure.
19- Test stable behavior and real dependency boundaries. Do not use local mocks to claim real network, framework wiring, serialization, or third-party runtime coverage.
20- Keep tests, public docs, and local contracts aligned with behavior changes.
21- Preserve the existing runtime and layer owners; do not add generic utilities or compatibility boundaries to bypass them.
22