From b87d0e17db1c62e5cd08686b30df5cc95f83c2bf Mon Sep 17 00:00:00 2001
From: victorjourne <journe.victor@gmail.com>
Date: Thu, 11 Jun 2026 18:36:25 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20ajouter=20une=20checklist=20de=20v?=
 =?UTF-8?q?=C3=A9rification=20avant/pendant=20l'impl=C3=A9mentation=20d'un?=
 =?UTF-8?q?=20plan=20+=20r=C3=A9f=C3=A9rence=20API=20DsfrInput?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agents/skills/recettes-client/SKILL.md | 27 +++++++++++++++++++++
 AGENTS.md                               | 32 +++++++++++++++++++++++++
 2 files changed, 59 insertions(+)

diff --git a/.agents/skills/recettes-client/SKILL.md b/.agents/skills/recettes-client/SKILL.md
index 6f7c972..b0075b8 100644
--- a/.agents/skills/recettes-client/SKILL.md
+++ b/.agents/skills/recettes-client/SKILL.md
@@ -158,9 +158,36 @@ toaster.addMessage({ description: 'Saved', type: 'success', closeable: true, tit
 </template>
 ```
 
+## Form Inputs — DsfrInput
+
+Real `DsfrInputProps` (from `@gouvminint/vue-dsfr`, confirmed against `node_modules/@gouvminint/vue-dsfr/**/DsfrInput.types.d.ts`):
+
+| Prop | Type | Purpose |
+|------|------|---------|
+| `modelValue` | `string \| number` | v-model |
+| `label` | `string` | Field label |
+| `labelVisible` | `boolean` | Show/hide label |
+| `hint` | `string` | Help text |
+| `isInvalid` | `boolean` | Error state (red border + error styling) |
+| `isValid` | `boolean` | Success state |
+| `isTextarea` | `boolean` | Render as `<textarea>` |
+| `isWithWrapper` | `boolean` | Wrap in `.fr-input-group` |
+
+```vue
+<DsfrInput
+  v-model="email"
+  label="Email"
+  :is-invalid="!!errors.email"
+  :hint="errors.email ?? 'Format attendu : nom@domaine.fr'"
+/>
+```
+
+There is **no `native-validators` prop** — validation/error state is driven by `isInvalid` + `hint`/`errorMessage`, handled in your own validation logic (e.g. VeeValidate, Zod).
+
 ## Gotchas
 
 - **DSFR is mandatory** — Ministry of Interior projects must use VueDsfr, not a generic component library
+- **Package name is `@gouvminint/vue-dsfr`, not `@gouvfr/dsfr-vue`** — and components are prefixed `Dsfr*` (`DsfrInput`, `DsfrButton`), not `Fr*`. A plan referencing `@gouvfr/dsfr-vue`/`FrInput` is hallucinated — verify against `package.json` and `node_modules/@gouvminint/vue-dsfr` before coding (see the verification checklist in `AGENTS.md`)
 - **Vue component files need 2+ words** — `LoginForm.vue` not `Form.vue` (exception: `App.vue`)
 - **Jest DOM with Vitest** — do NOT install Jest, Jest DOM is compatible with Vitest directly
 - **Toaster timeouts must clean up** — always `clearTimeout` on remove to prevent memory leaks
diff --git a/AGENTS.md b/AGENTS.md
index 8d0c1cf..ce6e3ca 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -81,6 +81,38 @@ Conventional Commits format. French is acceptable.
 
 Each subproject has its own `AGENTS.md` with project-specific config. This file takes precedence for cross-project conventions.
 
+## Implementing a Plan
+
+Before and while implementing a plan (migration, feature, refactor) that touches external libraries:
+
+### 1. Verify dependencies actually exist
+
+- [ ] Check the plan's packages match what's installed (`package.json`, lockfile) — a plan can reference a package that doesn't exist on npm or isn't the one used by the project
+- [ ] Check installed versions match what the plan assumes (`pnpm list <pkg>`)
+- [ ] If a package isn't installed yet, confirm it exists on npm before adding it (`npm view <pkg>`)
+
+> Example: a plan referenced `@gouvfr/dsfr-vue` (`FrInput`, `FrButton`) — that package doesn't exist on npm. The project actually uses `@gouvminint/vue-dsfr` (`DsfrInput`, `DsfrButton`).
+
+### 2. Read the real type definitions before coding
+
+- [ ] Locate the `.d.ts` files for the library (`node_modules/<pkg>/**/*.d.ts`)
+- [ ] Read the actual component/function signature before writing code that uses it
+- [ ] Adapt the plan's code if the real API differs — don't copy-paste it as-is
+
+> Example: a plan used `<FrInput :native-validators="{ required: { errorMessage: '...', enable: true } }" />`, but `DsfrInputProps` (`node_modules/@gouvminint/vue-dsfr/types/components/DsfrInput/DsfrInput.types.d.ts`) has `isInvalid?: boolean` and no `native-validators`. See [recettes-client] for the real DsfrInput API.
+
+### 3. Build before committing
+
+- [ ] Run the project build / typecheck (`pnpm build`, `vue-tsc --noEmit`, `tsc --noEmit`) at the end of each task
+- [ ] Fix all type errors before committing
+- [ ] Never commit a state that breaks the build, even "temporarily"
+
+### 4. Test existing behavior before changing it
+
+- [ ] Run the app (`pnpm dev`) and check the current behavior of the feature being modified
+- [ ] Identify pre-existing bugs (e.g. a non-reactive toast, a frozen counter) — don't confuse them with regressions introduced by the plan
+- [ ] Either fix pre-existing bugs as part of the task, or note them explicitly as out of scope in the plan/PR
+
 ## Gotchas
 
 - Vue components need 2+ words (`BadgeTypeOrganisme.vue`, not `Badge.vue`)