From c437bd9528339a026044a72074a1370be047d7d7 Mon Sep 17 00:00:00 2001
From: Tiberiu Ichim <tiberiu.ichim@gmail.com>
Date: Sun, 22 Feb 2026 08:28:22 +0200
Subject: [PATCH] docs: document correct modal usage

---
 AGENTS.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 4028d8523..614f1a773 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -139,6 +139,13 @@ OpenAPI documentation available at `docs/openapi.json`
 - Sequelize models for database operations
 - No comments in code unless explicitly requested
 
+### UI Components & Modals
+
+- **Modals**: Do **NOT** use `<ui-modal>`. The correct component for creating modals in this project is `<modals-modal>`.
+  - When creating a new modal, it must be imported/registered in `client/layouts/default.vue` (e.g., `<modals-my-new-modal />`).
+  - The modal title should be placed inside a `<template #outer>` slot, following the design pattern of other modals.
+  - State for whether the modal is open or closed should be managed in `client/store/globals.js` and toggled via a Vuex mutation.
+
 ## Database Migrations
 
 Located in `server/migrations/`. Key migrations include: