dify-docs

Use when editing or auditing the Service API specs in the Dify docs repo ({en,zh,ja}/api-reference/openapi_service.json), or on any task touching API endpoint parameters, responses, error codes, status codes, or examples.

Use when preparing documentation updates for a Dify release. User provides two version references to compare (e.g., v1.13.2 and v1.13.3, or v1.13.2 and main). Covers API reference, help documentation, environment variable changes, and UI i18n glossary impact.

Use when writing, rewriting, or auditing environment variable documentation for Dify self-hosted deployment. Applies to en/self-host/deploy/configuration/environments.mdx. Covers the full process from codebase tracing to user-facing descriptions.

Check formatting compliance in changed Chinese and Japanese documentation against writing-guides/formatting-guide.md, tools/translate/formatting-zh.md, and tools/translate/formatting-ja.md. Use after finalizing a translation batch, or when the user says "check formatting (zh/ja)", "check CJK formatting", or "format audit" on translated content.

Check formatting compliance in changed English documentation against writing-guides/formatting-guide.md. Use after finalizing a draft, or when the user says "check formatting", "format audit", "format check" on English content.

Use when drafting or editing any page under `en/cli/` in dify-docs. Covers reader segments, the writing rules, content ownership, and codebase-verification rules for the Dify CLI (`difyctl`) doc set. Triggers: "draft a CLI page", "write difyctl docs", "edit a page in en/cli/".

Research a Dify feature before writing or optimizing documentation. Use when starting any doc task that requires understanding a feature's implementation, user pain points, or community feedback. Triggers: 'research this feature', 'investigate the code for', 'what do users say about', 'let's understand how X works before writing', or any documentation task where the current docs are being rewritten or significantly expanded.

Use when writing, improving, or reviewing Dify user guide documentation. Covers pages in en/{cloud,self-host}/use-dify/, en/develop-plugin/, and en/self-host/deploy/. Triggers: "write docs for [feature]", "improve this page", "review this documentation section".

Audit terminology consistency across documentation against the codebase UI labels and the glossary. Covers full files, not just diffs; excludes env var docs. Use after finalizing a draft, or when the user says "check terminology", "check terms", "verify glossary", or "terminology audit".

Post-writing verification from the reader's perspective. Invoke after completing any documentation task to simulate a real user reading the document for the first time.