dify/web/AGENTS.md

## Frontend Workflow

- Refer to the `./docs/test.md` and `./docs/lint.md` for detailed frontend workflow instructions.

## Overlay Components (Mandatory)

- `./docs/overlay-migration.md` is the source of truth for overlay-related work.
- In new or modified code, use only overlay primitives from `@/app/components/base/ui/*`.
- Do not introduce deprecated overlay imports from `@/app/components/base/*`; when touching legacy callers, prefer migrating them and keep the allowlist shrinking (never expanding).

## Query & Mutation (Mandatory)

- `frontend-query-mutation` is the source of truth for Dify frontend contracts, query and mutation call-site patterns, conditional queries, invalidation, and mutation error handling.

## Automated Test Generation

- Use `./docs/test.md` as the canonical instruction set for generating frontend automated tests.
- When proposing or saving tests, re-read that document and follow every requirement.
- All frontend tests MUST also comply with the `frontend-testing` skill. Treat the skill as a mandatory constraint, not optional guidance.
docs: relocate frontend docs for agents and human (#31714) Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> 2026-01-29 09:58:10 +00:00			`## Frontend Workflow`

			- Refer to the `./docs/test.md` and `./docs/lint.md` for detailed frontend workflow instructions.

feat(web): add context menu primitive and dropdown link item (#33125) 2026-03-09 04:05:38 +00:00			`## Overlay Components (Mandatory)`

			- `./docs/overlay-migration.md` is the source of truth for overlay-related work.
			- In new or modified code, use only overlay primitives from `@/app/components/base/ui/*`.
			- Do not introduce deprecated overlay imports from `@/app/components/base/*`; when touching legacy callers, prefer migrating them and keep the allowlist shrinking (never expanding).

refactor(web): consolidate query/mutation guidance and deprecate use-base wrappers (#33456) Signed-off-by: yyh <yuanyouhuilyz@gmail.com> 2026-03-16 05:38:29 +00:00			`## Query & Mutation (Mandatory)`

			- `frontend-query-mutation` is the source of truth for Dify frontend contracts, query and mutation call-site patterns, conditional queries, invalidation, and mutation error handling.

frontend auto testing rules (#28679) Co-authored-by: CodingOnStar <hanxujiang@dify.ai> Co-authored-by: 姜涵煦 <hanxujiang@jianghanxudeMacBook-Pro.local> Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> 2025-11-26 07:18:07 +00:00			`## Automated Test Generation`

docs: relocate frontend docs for agents and human (#31714) Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> 2026-01-29 09:58:10 +00:00			- Use `./docs/test.md` as the canonical instruction set for generating frontend automated tests.
frontend auto testing rules (#28679) Co-authored-by: CodingOnStar <hanxujiang@dify.ai> Co-authored-by: 姜涵煦 <hanxujiang@jianghanxudeMacBook-Pro.local> Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> 2025-11-26 07:18:07 +00:00			`- When proposing or saving tests, re-read that document and follow every requirement.`
test: add comprehensive tests for CustomizeModal component (#29709) 2025-12-16 06:21:05 +00:00			- All frontend tests MUST also comply with the `frontend-testing` skill. Treat the skill as a mandatory constraint, not optional guidance.