#399

frontend/AGENTS.md

@@ -108,6 +108,22 @@ pass or the remaining failure is clearly blocked.
   third-party request outside the Rails API.
 - For blob responses, pass `responseType: 'blob'` so the wrapper does not camelCase the body.
 
+## Dialogues
+
+- Feature code must use `@/lib/dialogues/useDialogue` as the entrypoint for
+  dialogue work.
+- Reuse the existing common dialogue API and common dialogue component.
+- Do not import `@/components/ui/dialog` directly in feature code to build a
+  bespoke dialogue, and do not evade this rule with aliases such as
+  `Dialog as Dialogue`.
+- Keep business-specific form content in feature code, and keep the visual
+  and behavioural dialogue shell in common code.
+- Reuse the common confirmation flow from `useDialogue` instead of building a
+  feature-local confirmation dialogue.
+- Use British spelling `Dialogue` for project-defined dialogue identifiers.
+  Keep an exact third-party API spelling only at the external boundary where
+  compatibility requires it.
+
 ## Imports and aliases
 
 - The `@` alias points to `frontend/src`.