devmethod-ai 0.1.0 → 0.2.0

package/docs/media/visual-chain/devmethod-du-besoin-au-produit.fr.srt

@@ -0,0 +1,147 @@
+1
+00:00:00,000 --> 00:00:03,789
+Du besoin au design, des choix techniques au produit vérifié.
+
+2
+00:00:03,789 --> 00:00:06,211
+Voici Dev Method sur un projet concret.
+
+3
+00:00:06,917 --> 00:00:11,573
+D’abord, décrivez le produit et ce que son utilisateur doit pouvoir faire.
+
+4
+00:00:12,924 --> 00:00:19,739
+Frame fixe le périmètre : une bibliothèque personnelle, trois statuts, et une sauvegarde sur cet appareil.
+
+5
+00:00:20,596 --> 00:00:24,253
+Avec design, demandez trois directions pour le même écran.
+
+6
+00:00:26,712 --> 00:00:29,024
+Éditorial, Atelier ou Botanique.
+
+7
+00:00:29,024 --> 00:00:32,204
+Même contenu, trois personnalités visuelles.
+
+8
+00:00:33,056 --> 00:00:34,278
+Ici, le choix est A.
+
+9
+00:00:34,278 --> 00:00:37,270
+Codex développe cette direction en master screen.
+
+10
+00:00:40,166 --> 00:00:44,773
+Le master précise la typographie, les couleurs, les cartes et les boutons.
+
+11
+00:00:44,773 --> 00:00:46,702
+Il est approuvé avant la suite.
+
+12
+00:00:48,594 --> 00:00:53,610
+La commande suivante reste design : génère les écrans à partir de ce master.
+
+13
+00:00:56,045 --> 00:01:00,852
+Voici le formulaire d’ajout, généré avec le master comme référence visuelle.
+
+14
+00:01:02,182 --> 00:01:04,090
+Puis la vue des lectures terminées.
+
+15
+00:01:04,090 --> 00:01:07,035
+La même direction accompagne un autre état du produit.
+
+16
+00:01:09,191 --> 00:01:14,650
+Architecture compare les options selon les besoins, le coût et la maintenance.
+
+17
+00:01:14,650 --> 00:01:19,199
+Pour ce petit prototype local, HTML, CSS et JavaScript suffisent.
+
+18
+00:01:20,165 --> 00:01:23,065
+Les règles des livres restent séparées de l’interface.
+
+19
+00:01:23,065 --> 00:01:25,160
+Les données sauvegardées sont validées.
+
+20
+00:01:25,160 --> 00:01:28,919
+Une synchronisation entre appareils demanderait une nouvelle décision.
+
+21
+00:01:30,028 --> 00:01:34,242
+Le plan relie ces écrans aux actions à réaliser et aux vérifications attendues.
+
+22
+00:01:36,041 --> 00:01:40,848
+Ready vérifie le périmètre, les dépendances et les critères de réussite avant de coder.
+
+23
+00:01:42,046 --> 00:01:46,678
+Implement construit l’interface et ses vrais comportements à partir des références.
+
+24
+00:01:48,086 --> 00:01:49,361
+Passons au résultat.
+
+25
+00:01:49,361 --> 00:01:51,019
+On filtre la bibliothèque.
+
+26
+00:01:51,019 --> 00:01:52,230
+On ajoute un livre.
+
+27
+00:01:52,230 --> 00:01:55,418
+On commence sa lecture, puis on le marque terminé.
+
+28
+00:01:55,418 --> 00:01:58,988
+Après rechargement, les données sont toujours présentes.
+
+29
+00:02:08,202 --> 00:02:12,927
+Sur mobile, les mêmes actions restent accessibles dans une disposition adaptée.
+
+30
+00:02:14,208 --> 00:02:16,536
+Review examine le code et les risques.
+
+31
+00:02:16,536 --> 00:02:21,313
+Ici, la revue a conduit à corriger une alerte masquée et le maintien du focus.
+
+32
+00:02:22,443 --> 00:02:25,926
+Verify contrôle les parcours utiles et les résultats des tests.
+
+33
+00:02:28,639 --> 00:02:33,596
+On compare ensuite le navigateur aux références, puis on corrige les écarts importants.
+
+34
+00:02:36,378 --> 00:02:40,128
+La livraison locale conserve le résultat et son état de reprise.
+
+35
+00:02:42,393 --> 00:02:45,861
+Handoff conserve les décisions, les preuves et les limites.
+
+36
+00:02:45,861 --> 00:02:50,799
+Next retrouve ensuite la suite pertinente, ou constate que le périmètre est terminé.
+
+37
+00:02:51,507 --> 00:02:55,280
+Découvrez Dev Method sur GitHub et essayez cette chaîne sur votre projet.

package/docs/media/visual-chain/execution.fr.md

@@ -0,0 +1,30 @@
+# Exécution réelle après génération des images
+
+Le master approuvé et les deux images dérivées étaient présents avant le code. Le dossier neuf ne contenait pas l’ancien prototype. Les étapes d’architecture, plan et préparation sont regroupées dans cette instruction.
+
+```text
+$project-foundation implement VISUAL-1
+Lis BRIEF.md et inspecte réellement les trois images de references/. Réalise le prototype décrit à partir de ces images, sans ancien code fourni. Fais la préparation et le plan proportionnés inline, implémente, teste puis relis et corrige les défauts locaux. Pas de navigateur : le parent le vérifie. Garde une mission compacte, pas un document par étape. Respecte la typographie légère et le master approuvé. Réponse finale française150 mots maximum avec preuves et prochaine commande.
+```
+
+## Sortie Codex CLI
+
+VISUAL-1 est implémenté dans [app/](<projet>/app) avec :
+
+- bibliothèque responsive fidèle au master ;
+- couvertures recadrées depuis `master.png` ;
+- filtres, transitions d’état et ajout par dialogue accessible ;
+- persistance `localStorage` protégeant les données invalides ;
+- état vide et erreurs visibles.
+
+Preuves : 6/6 tests Node réussis dans [domain.test.mjs](<projet>/tests/domain.test.mjs), contrôles syntaxiques réussis, aucune requête externe. Relecture effectuée et recadrage responsive corrigé. `CONTRIBUTING.md` est absent, sans blocage. Le rendu navigateur reste volontairement non vérifié par cette mission.
+
+Prochaine commande : `$project-foundation verify VISUAL-1`
+
+## Vérification parent postérieure
+
+Après correction CSS de hidden et conservation du focus lors des transitions : 6 tests Node réussis. Chrome confirme 3 livres initiaux, alerte masquée normalement, filtre terminé, rouvrir et état vide, dialogue, ajout, persistance après reload, mobile390px sans débordement, données locales illisibles non écrasées. Aucun pageerror dans le parcours normal. Captures inspected desktop/mobile/modal.
+
+Livraison locale seulement. La scène integrate est une commande type associée à cette livraison, pas une preuve de déploiement.
+
+Le CLI a omis le document de mission demandé. Le parent a créé le checkpoint MISSION.md après vérification ; ce test supervisé ne prouve pas une tenue autonome parfaite du contexte.

package/docs/media/visual-chain/image-prompts.json

@@ -0,0 +1,9 @@
+{
+  "tool": "image_gen",
+  "master": "../../../examples/visual-pilot/editorial-mockup-v1.png",
+  "prompts": [
+    "Use case: ui-mockup. Generate a high fidelity French Lisière desktop screen derived from the attached APPROVED MASTER, not a new artistic direction. Output a single flat browser UI canvas, landscape 1536x1024, no device frame, no headings outside UI. Exact same ivory background, elegant regular-weight serif typography, thin rules, rust red primary button, book cover artwork and library header as master. Show the ADD BOOK state: center an elegant compact modal titled 'Ajouter un livre' over the dimmed existing library. Fields labeled 'Titre' and 'Auteur', filled 'Les heures claires' and 'Camille Laurent'. Footer actions 'Annuler' outlined and 'Ajouter' solid rust. Close × upper right. Main library stays subtly visible behind, no new navigation or functionality. Match reference identity and practical interface geometry. Crisp legible French text, consistent controls, no invented product features.",
+    "Use case: ui-mockup. Generate a high fidelity French Lisière desktop screen derived from the attached APPROVED MASTER, not a new artistic direction. Output single flat UI canvas landscape1536x1024 no devices or external titles. Preserve ivory, regular serif type, rust accents, thin separators, header 'Lisière' and 'Bibliothèque personnelle', heading 'Mes lectures', subtitle, upper right '+ Ajouter un livre', exact filters 'Tous', 'À lire', 'En cours', 'Terminés'. Show TERMINÉS selected with rust underline. A single completed book card uses the same 'Les jours tranquilles' cover artwork, title 'Les jours tranquilles', author 'Élise Martin', status pill 'Terminé', outlined action 'Rouvrir'. Spacious editorial layout aligned to master desktop grid, no new navigation or other content. Footer 'Lire, c’est habiter un peu plus grand.' and 'Démonstration · Livres fictifs'. Make this an obvious consistent derivative screen of the reference."
+  ],
+  "correction": "Add-book initial result duplicated the mobile panel; corrected with image_gen to retain a single desktop background. Final add-book-v1.png was visually inspected."
+}

package/docs/media/visual-chain/reference-hashes.json

@@ -0,0 +1,5 @@
+{
+  "master.png": "f6cd5677f25db809c05deeb703efdfcb8ccc9e6df24d5d5acc7295dffc1384e3",
+  "add-book-v1.png": "c9067bdace97d9a424f0cb521e6e4c3b85adc74067f0939aeb11aad559480bc5",
+  "completed-v1.png": "849d09a1916d491cddf4f737430e5ce981a5721be8ef6005ef233f3fbf1a1b99"
+}

package/docs/media/visual-chain/scenes.json

@@ -0,0 +1,232 @@
+[
+  {
+    "kind": "intro",
+    "title": "De l’idée à l’application",
+    "voice": "Du besoin au design, des choix techniques au produit vérifié. Voici Dev Method sur un projet concret.",
+    "duration": 6.911338,
+    "command": "",
+    "request": "",
+    "asset": "",
+    "output": ""
+  },
+  {
+    "kind": "text",
+    "title": "Décrire le produit",
+    "voice": "D’abord, décrivez le produit et ce que son utilisateur doit pouvoir faire.",
+    "duration": 6,
+    "command": "$project-foundation explore",
+    "request": "Une bibliothèque personnelle pour suivre mes lectures.",
+    "asset": "",
+    "output": "Ajouter un livre · Suivre sa lecture · Retrouver ses données"
+  },
+  {
+    "kind": "text",
+    "title": "Cadrer une première version",
+    "voice": "Frame fixe le périmètre : une bibliothèque personnelle, trois statuts, et une sauvegarde sur cet appareil.",
+    "duration": 7.5150570000000005,
+    "command": "$project-foundation frame",
+    "request": "Définis une première version utile et ses limites.",
+    "asset": "",
+    "output": "Ajouter · Filtrer · Changer de statut · Conserver les livres localement"
+  },
+  {
+    "kind": "image",
+    "title": "Demander trois directions",
+    "voice": "Avec design, demandez trois directions pour le même écran.",
+    "duration": 6,
+    "command": "$project-foundation design",
+    "request": "Propose trois directions visuelles comparables.",
+    "asset": "directions",
+    "output": ""
+  },
+  {
+    "kind": "options",
+    "title": "Comparer, puis choisir",
+    "voice": "Éditorial, Atelier ou Botanique. Même contenu, trois personnalités visuelles.",
+    "duration": 6.191519,
+    "command": "",
+    "request": "",
+    "asset": "directions",
+    "output": ""
+  },
+  {
+    "kind": "choice",
+    "title": "Choisir A — Éditorial",
+    "voice": "Ici, le choix est A. Codex développe cette direction en master screen.",
+    "duration": 7,
+    "command": "$project-foundation design",
+    "request": "Je choisis A. Finalise le master screen.",
+    "asset": "master",
+    "output": ""
+  },
+  {
+    "kind": "image",
+    "title": "Le master fixe la référence",
+    "voice": "Le master précise la typographie, les couleurs, les cartes et les boutons. Il est approuvé avant la suite.",
+    "duration": 8,
+    "command": "",
+    "request": "",
+    "asset": "master",
+    "output": ""
+  },
+  {
+    "kind": "derive",
+    "title": "Décliner le master",
+    "voice": "La commande suivante reste design : génère les écrans à partir de ce master.",
+    "duration": 7,
+    "command": "$project-foundation design",
+    "request": "Décline ce master : bibliothèque, ajout et lectures terminées.",
+    "asset": "master",
+    "output": ""
+  },
+  {
+    "kind": "image",
+    "title": "Écran 02 — Ajouter un livre",
+    "voice": "Voici le formulaire d’ajout, généré avec le master comme référence visuelle.",
+    "duration": 6,
+    "command": "",
+    "request": "",
+    "asset": "add",
+    "output": ""
+  },
+  {
+    "kind": "image",
+    "title": "Écran 03 — Lectures terminées",
+    "voice": "Puis la vue des lectures terminées. La même direction accompagne un autre état du produit.",
+    "duration": 7,
+    "command": "",
+    "request": "",
+    "asset": "completed",
+    "output": ""
+  },
+  {
+    "kind": "text",
+    "title": "Choisir les technologies",
+    "voice": "Architecture compare les options selon les besoins, le coût et la maintenance. Pour ce petit prototype local, HTML, CSS et JavaScript suffisent.",
+    "duration": 10.707799999999999,
+    "command": "$project-foundation architecture",
+    "request": "Compare les options techniques adaptées à ce périmètre.",
+    "asset": "",
+    "output": "Prototype retenu : HTML + CSS + JavaScript · Stockage local au navigateur"
+  },
+  {
+    "kind": "text",
+    "title": "Organiser le code",
+    "voice": "Les règles des livres restent séparées de l’interface. Les données sauvegardées sont validées. Une synchronisation entre appareils demanderait une nouvelle décision.",
+    "duration": 9.453923,
+    "command": "$project-foundation architecture",
+    "request": "Définis les responsabilités, les risques et les compromis.",
+    "asset": "",
+    "output": "Interface ↔ Règles métier ↔ Sauvegarde locale · Limite : un appareil"
+  },
+  {
+    "kind": "text",
+    "title": "Préparer la réalisation",
+    "voice": "Le plan relie ces écrans aux actions à réaliser et aux vérifications attendues.",
+    "duration": 6,
+    "command": "$project-foundation plan",
+    "request": "Prépare une première tranche à partir des écrans.",
+    "asset": "",
+    "output": "Bibliothèque + filtres → Formulaire → Statuts + sauvegarde"
+  },
+  {
+    "kind": "text",
+    "title": "Vérifier que la tranche est prête",
+    "voice": "Ready vérifie le périmètre, les dépendances et les critères de réussite avant de coder.",
+    "duration": 6,
+    "command": "$project-foundation ready VISUAL-1",
+    "request": "Vérifie que cette tranche est prête.",
+    "asset": "",
+    "output": "Références disponibles · Interactions définies · Tests attendus"
+  },
+  {
+    "kind": "text",
+    "title": "Transformer les images en code",
+    "voice": "Implement construit l’interface et ses vrais comportements à partir des références.",
+    "duration": 6,
+    "command": "$project-foundation implement VISUAL-1",
+    "request": "Implémente les écrans et leurs interactions.",
+    "asset": "",
+    "output": "Nouvelle implémentation à partir du master et des images dérivées"
+  },
+  {
+    "kind": "app",
+    "title": "L’application fonctionne",
+    "voice": "Passons au résultat. On filtre la bibliothèque. On ajoute un livre. On commence sa lecture, puis on le marque terminé. Après rechargement, les données sont toujours présentes.",
+    "duration": 20,
+    "command": "",
+    "request": "",
+    "asset": "",
+    "output": ""
+  },
+  {
+    "kind": "image",
+    "title": "Aussi sur mobile",
+    "voice": "Sur mobile, les mêmes actions restent accessibles dans une disposition adaptée.",
+    "duration": 6,
+    "command": "",
+    "request": "",
+    "asset": "mobile",
+    "output": ""
+  },
+  {
+    "kind": "text",
+    "title": "Relire et corriger",
+    "voice": "Review examine le code et les risques. Ici, la revue a conduit à corriger une alerte masquée et le maintien du focus.",
+    "duration": 8,
+    "command": "$project-foundation review VISUAL-1",
+    "request": "Relis la tranche et signale les défauts à corriger.",
+    "asset": "",
+    "output": "Corrections réelles : affichage de l’alerte · Focus après changement de statut"
+  },
+  {
+    "kind": "text",
+    "title": "Vérifier le résultat",
+    "voice": "Verify contrôle les parcours utiles et les résultats des tests.",
+    "duration": 6,
+    "command": "$project-foundation verify VISUAL-1",
+    "request": "Vérifie les parcours, les erreurs et le rendu.",
+    "asset": "",
+    "output": "6 tests Node réussis · Parcours Chrome · Sauvegarde · Mobile"
+  },
+  {
+    "kind": "compare",
+    "title": "Comparer au design",
+    "voice": "On compare ensuite le navigateur aux références, puis on corrige les écarts importants.",
+    "duration": 7,
+    "command": "",
+    "request": "",
+    "asset": "desktop",
+    "output": ""
+  },
+  {
+    "kind": "text",
+    "title": "Livrer une tranche terminée",
+    "voice": "La livraison locale conserve le résultat et son état de reprise.",
+    "duration": 6,
+    "command": "$project-foundation integrate VISUAL-1",
+    "request": "Consigne la livraison locale et la reprise.",
+    "asset": "",
+    "output": "Prototype local · Parcours vérifiés · Références conservées"
+  },
+  {
+    "kind": "text",
+    "title": "Reprendre sans repartir de zéro",
+    "voice": "Handoff conserve les décisions, les preuves et les limites. Next retrouve ensuite la suite pertinente, ou constate que le périmètre est terminé.",
+    "duration": 9.105623999999999,
+    "command": "$project-foundation handoff",
+    "request": "Prépare un point de reprise fidèle à la livraison.",
+    "asset": "",
+    "output": "Décisions + résultat + limites → $project-foundation next"
+  },
+  {
+    "kind": "end",
+    "title": "Votre idée. Une chaîne visible.",
+    "voice": "Découvrez Dev Method sur GitHub et essayez cette chaîne sur votre projet.",
+    "duration": 6,
+    "command": "",
+    "request": "",
+    "asset": "",
+    "output": ""
+  }
+]

package/docs/missions/visual-workflow.md

@@ -0,0 +1,46 @@
+# Visual workflow and proportionate delivery pilot
+
+Canonical local mission record. Scope: incorporate the previously reviewed mission-tracking change; implement the reusable visual-creation procedure; forward-test a small change with an agent; demonstrate visual direction through implementation with a user-selected reference. No Rolevidence changes, merge, deployment or npm publication.
+
+## Criteria and evidence
+
+| ID | Criterion | Current evidence | Status |
+| --- | --- | --- | --- |
+| V1 | Existing design command routes new directions and preserves approved references | design-to-code/references/visual-creation.md; project-foundation routing | Implemented; linked resources resolve and installation includes procedure |
+| V2 | Visible comparable directions and actual user selection | examples/visual-pilot/directions-v1.png generated with built-in image tool | A selected explicitly by user |
+| V3 | Selected image mockup with approval/version | examples/visual-pilot/editorial-mockup-v1.png generated and inspected | Approved explicitly by user |
+| V4 | Interactive implementation, desktop/mobile captures and mismatch detection | app/ implemented; browser-check.cjs passed in Chrome; desktop-actual.png and mobile-actual.png inspected; color mismatch detected and restored | Passed with disclosed fidelity limits |
+| P1 | Agent completes a small fix without per-stage documents or redundant checks | Actual subagent fixed one predicate; 2/2 tests pass in one run; only requested report created, no stage documents. See examples/visual-pilot/quick-filter/AGENT-RESULT.md | Passed for this case |
+| P2 | Updated kit installs with valid resources and regression checks pass | npm ci (cached), npm test 72/72, check:docs, pack --dry-run; fresh Codex install 44 files, doctor ok | Passed |
+
+## Visual brief
+
+Fictional Lisière personal reading library, for readers tracking books and next reading actions. No accounts, backend, purchases or external data. One main library screen with status filters, adding a book and changing reading status. Desktop and mobile. The visible board proposes A editorial ivory/ink/rust with serif hierarchy, B compact cobalt utilitarian geometry, C airy sage/forest botanical illustration. A was selected explicitly by the user.
+
+Generated board v1 contains presentation additions (navigation, author names, decorative copy) that are proposals, not approved scope. Its “Lire” label must be resolved in the final contract: the demo tracks reading and does not supply book content. Final controls will use truthful tracking actions unless scope is changed. Book metadata is fictional.
+
+## Asset provenance
+
+Direction board: built-in image generation, 2026-09-13. No supplied visual reference. Prompt asked for three equal panels of the same French library screen and mobile previews, titled Éditorial, Atelier and Botanique; same three fictional books, status filters and add action; different typography, density and imagery. Saved asset: ../../examples/visual-pilot/directions-v1.png. This is a selection board, not an approved implementation reference. Detailed prompt is stored beside the asset.
+
+## Resume
+
+The user selected A and approved detailed mockup v1. The supervised pilot is complete locally. A future independent visual test must use a fresh agent/session; this pilot does not establish autonomous or cross-host reliability. GitHub branch push is now authorized; merge and npm publication are not.
+
+## Verification limits
+
+The generic skill-creator Python validator could not run because PyYAML is absent in both available Python runtimes. Repository installation/regression tests and Markdown link checks passed; these are not equivalent to behavioral validation of the entire visual procedure. The first npm ci attempt could not complete with the isolated cache/network constraints; retry using the existing npm cache offline succeeded without changing the lockfile. No npm publication, merge or new product deployment. Current evidence applies to this local change set with the approved editorial mockup.
+
+## Selected mockup v1
+
+Built-in image tool, reference directions-v1.png panel A. Preserves ivory/ink/rust and serif hierarchy. Removes speculative navigation and changes Lire to Commencer / Marquer terminé. Desktop three columns; mobile stacked cover/detail rows. Image inspected: controls and labels are present; mobile font sizing and header spacing require browser checks, not inferred accessibility. Generated cover lettering has minor raster artifacts and is not authoritative metadata. Final text comes from semantic HTML. The user subsequently approved this exact mockup before implementation.
+
+## Completed browser pilot
+
+The user explicitly approved editorial-mockup-v1.png. Vanilla HTML/CSS/JS prototype implemented under examples/visual-pilot/app, no added runtime dependencies. Real localStorage persistence, add dialog, status transitions and filters. No loading spinner: synchronous local operation; storage failure has a visible warning; empty filters have recovery guidance. No book reading content is implied.
+
+Chrome headless test passed: initial three books, empty completed filter, starting then completing a book, adding, persistence across reload, Escape and focus return, no mobile overflow at 390px, no JS page errors. Intentional rust-to-blue mismatch detected by a targeted color assertion then removed by reload. This is a bounded mismatch probe, not an independent general visual reviewer. Desktop 1100x1000 and mobile 390x844 captures inspected against the approved board. Three-column/stacked hierarchy, rust/ivory palette and approved covers retained; cover images render from the approved image as CSS sprites. System Georgia rendering, heading size and spacing differ from the raster; no pixel-perfect claim. Full-page mobile capture scrolls beyond 844px as expected. Keyboard test covers dialog close/focus, not a full accessibility audit.
+
+Prototype and implementation are one artifact. To run: python3 -m http.server 8765 --bind 127.0.0.1 --directory examples/visual-pilot/app. Tests require an externally available Playwright and Chrome; run node examples/visual-pilot/browser-check.cjs with PLAYWRIGHT_MODULE if necessary. No package dependency or host configuration was changed. Development server remains on loopback for user preview.
+
+Scope complete locally: procedure, simple agent test, actual image generation, user choice, approved detailed mockup, interactive browser prototype and comparison. No publication or merge. This one supervised Codex pilot does not prove cross-host operation, general quality improvement or BMAD superiority.

package/examples/clair-from-zero/AGENT-EVALUATION.md

@@ -0,0 +1,15 @@
+# Relevé de l’essai Clair
+
+Date : 2026-09-13. Dossier initial : kit fraîchement installé, aucune application. Source du produit : brief transmis par l’agent parent, dont la sélection détaillée des écrans est déléguée. Le relevé est une observation de cette exécution, pas une comparaison de méthodes.
+
+Les lectures initiales et décisions ont précédé le code. Exploration/cadrage/design/architecture/plan/readiness ont été groupés en une tranche standard CLAIR-1, puis implémentation, tests et revue locale. Le seul enregistrement courant est `docs/missions/clair.md`. Ce rapport est un instantané ; aucun document par étape. Aucun imagegen, réseau, dépendance ou sous-agent utilisé. Le kit est resté intact ; le profil adopté est dans la mission pour respecter cette contrainte.
+
+Fichiers lus : START_HERE.md, AGENTS.foundation.md, PROJECT_PROFILE.md, ENGINEERING_POLICY.template.md ; SKILL.md de project-foundation, design-to-code, scoped-delivery et decision-architecture ; références work-sizing, operating-commands, mission-context, visual-creation, ux-contract, verification-and-cost ; modèle scoped-delivery/assets/MISSION.md ; kit-manifest.json. CONTRIBUTING.md et AGENTS.md étaient absents. Les autres modules ont été découverts par inventaire, sans être chargés.
+
+Fichiers créés : app/index.html, app/styles.css, app/app.mjs, app/domain.mjs, app/storage.mjs, tests/domain.test.mjs, docs/missions/clair.md et ce rapport. Livré : page française responsive ivoire/encre/rouille, ajout titre/note, validation, toggle, trois filtres, suppression/annulation, localStorage versionné et validé, alerte d’échec persistante/réessai, réinitialisation explicite après erreur de lecture, départ vide et ajout de trois tâches de démonstration marquées fictives.
+
+Exécuté : `node --test tests/*.test.mjs` — 6 tests passés, 0 échec ; `node --check app/app.mjs` — passé. Vérification des hashes SHA-256 des fichiers du manifeste installé — aucune différence. Revue locale du code et des limites ; aucune installation ni ressource distante.
+
+Limites : cet agent n’a pas lancé de navigateur, capturé d’écran, testé l’interaction réelle ou vérifié le rendu mobile. Le parent en est chargé indépendamment. Les vérifications DOM/CSS effectuées sont des inspections du source. Aucune preuve d’intégration, de déploiement ou d’usage production. L’application conserve les priorités jusqu’à suppression ; aucune remise à zéro quotidienne ni synchronisation entre onglets. L’annulation porte sur la dernière suppression et disparaît après rechargement. La démo peut être ajoutée plusieurs fois volontairement.
+
+Lancer : `python3 -m http.server 8766 --bind 127.0.0.1 --directory app`. Prochaine commande méthode : `$project-foundation verify CLAIR-1`.

package/examples/clair-from-zero/MISSION.md

@@ -0,0 +1,41 @@
+# Clair — mission canonique
+
+2026-09-13, livraison standard, propriétaire : agent de réalisation.
+
+## Sources et profil adopté
+Le brief transmis par le parent fait autorité : application française locale, HTML/CSS/JS sans dépendances ni comptes, direction ivoire/encre/rouille et sérif ; choix détaillés délégués. Les fichiers du kit restent intacts, notamment PROJECT_PROFILE.md : ce paragraphe porte le profil adopté conformément à la contrainte de préservation. CONTRIBUTING.md et AGENTS.md sont absents. ENGINEERING_POLICY.template.md est un modèle ; le JavaScript demandé prend priorité sur sa recommandation TypeScript.
+
+Stack : modules JavaScript natifs, CSS, HTML ; Node pour les tests purs ; Python pour le serveur local. Commandes : `node --test tests/*.test.mjs` ; `python3 -m http.server 8766 --bind 127.0.0.1 --directory app`. Aucun déploiement, réseau, installation ou génération d’images autorisé. Données : titres, notes et état d’achèvement stockés sous clair.tasks.v1 dans localStorage, conservés jusqu’à suppression ou effacement du navigateur ; aucune synchronisation ni télémétrie.
+
+## Framing, design et architecture — décisions avant code
+Valeur : choisir et suivre les priorités du jour sans configuration. Direction existante explicite, choix d’écran délégué ; aucune image ou maquette séparée nécessaire. Prototype HTML final choisi comme support. Grand titre éditorial, date, compteur, liste principale et formulaire latéral ; mobile en une colonne avec formulaire avant la liste. Palette #f7f3eb, #292923, #97472f ; Georgia système et sans-sérif système. États : vide, filtres vides, tâches actives/terminées, validation, suppression/annulation, stockage indisponible/corrompu.
+
+Choix structurel dans le cadre délégué : module pur pour validation/transitions/schéma, adaptateur localStorage, contrôleur DOM. Une page monolithique serait plus courte mais rendrait les invariants difficiles à tester isolément. Aucun framework utile au périmètre. Les titres/notes ne deviennent jamais du HTML. Échec d’écriture : garder la session en mémoire et afficher une alerte persistante avec réessai ; erreur de lecture : ne pas écraser les données sans action explicite de réinitialisation. Suppression réversible de la dernière tâche, sans expiration temporelle. Pas de réinitialisation automatique à minuit.
+
+## Plan et readiness (avant implémentation)
+Une tranche CLAIR-1 couvre AC1 ajout titre/note et validation ; AC2 toggle/filtres ; AC3 suppression/annulation ; AC4 persistance/schema/erreurs ; AC5 vide + démo explicitement fictive ; AC6 responsive/clavier/focus. Contrats prêts, dépendances résolues. Tests prévus sur invariants et stockage ; vérification navigateur déléguée au parent et non revendiquée par cet agent. Limites de titre 160 caractères et note 500, données versionnées et validées à la lecture. Fin de périmètre après réalisation locale et tests ; pas de fonctionnalités hors brief.
+
+## Evidence et état
+État courant après vérification parent : CLAIR-1 réalisé et vérifié dans Chrome desktop/mobile. Les étapes explorations/cadrage/design/architecture/plan/readiness ont été groupées, pas de document par étape.
+
+## Résultat local et evidence — 2026-09-13
+CLAIR-1 réalisé dans `app/`. État lors du retour de l’agent : implémentation locale terminée, acceptation navigateur alors en attente. Aucun commit, PR ou déploiement.
+
+| Critère | Preuve exécutée | Résultat |
+|---|---|---|
+| AC1 | `node --test tests/*.test.mjs`, cas validation | passé : blanc, trim, bornes titre/note |
+| AC2 | même commande, toggle/filtres | passé : immutabilité et ordre |
+| AC3 | même commande, suppression/annulation | passé : position, ajout intermédiaire, absence et doublon |
+| AC4 | même commande, schéma/adapter | passé : round-trip Unicode, JSON invalide, version, types, IDs dupliqués, exceptions lecture/écriture |
+| AC5 | revue du contrôleur et HTML | démarrage vide sans données ; bouton de démo explicitement fictif, notes marquées ; navigateur non exécuté |
+| AC6 | revue CSS/DOM | labels, focus visible, annonces, règles 700/1000 px et réduction de mouvement présentes ; comportement/rendu navigateur non vérifiés |
+
+Commande `node --check app/app.mjs` passée. Six tests, zéro échec. Revue locale de ses propres fichiers : contenu utilisateur inséré via textContent, stockage traité au bord, aucune ressource distante, aucun secret, actions couvertes dans le contrôleur. Cette inspection ne démontre pas l'accessibilité complète. Vérification SHA-256 des fichiers installés contre kit-manifest.json : aucun changement. Aucun test navigateur réalisé par cet agent, aucune comparaison pixel ou audit automatique revendiqué.
+
+Prochaine action exacte : parent, exécuter la vérification desktop/mobile et des parcours de CLAIR-1 sur le serveur local. Commande méthode recommandée : `$project-foundation verify CLAIR-1`.
+
+## Vérification indépendante du parent
+
+Interactions Chrome vérifiées : vide, validation, ajout/note, toggle/filtres, rechargement, suppression/annulation, démo, saisie clavier, absence de débordement à 390px, échec de stockage avec conservation en mémoire et alerte. Captures desktop/mobile inspectées. Les animations sont désactivées pour les captures afin de ne pas photographier une barre de progression en transition. Aucun audit complet d’accessibilité.
+
+Constat méthode : l’agent avait conservé une ancienne ligne « implémentation en cours » avant son résultat final. Le parent l’a réconciliée ici ; ce besoin de correction empêche de présenter la tenue du statut comme entièrement autonome. Le rapport agent est un instantané historique. Prochaine action : aucune implémentation restante dans ce périmètre ; intégration et vidéo suivies dans le dépôt DevMethod.

package/examples/clair-from-zero/README.md

@@ -0,0 +1,24 @@
+# Clair — an actual from-zero DevMethod pilot
+
+Clair is a fictional French personal-priorities app created by a separate Codex subagent in a new directory containing only the installed DevMethod kit. The parent provided a bounded brief and delegated the detailed editorial visual choices. No application code or previous implementation was supplied. This is a same-host subagent test, not a fresh standalone Codex/Claude session or a comparative benchmark.
+
+## Run
+
+From this directory:
+
+```sh
+python3 -m http.server 8766 --bind 127.0.0.1 --directory app
+node --test tests/*.test.mjs
+```
+
+Open http://127.0.0.1:8766. Stop the server with Ctrl-C. No npm dependencies, backend, external fonts, account or provider key. Browser storage uses `clair.tasks.v1`. The application starts empty; its demo button explicitly adds fictional tasks. Delete/undo covers the last deletion and does not survive reload. There is no cross-tab synchronization or daily reset.
+
+## What was observed
+
+The implementing agent grouped framing, design, architecture, planning and readiness in one mission. It created five app files, a test file, one mission and the requested evaluation snapshot; all installed kit files retained their hashes. Six logic/storage tests passed. The parent then exercised the actual Chrome UI: blank validation, add/note, completion/filters, persistence, delete/undo, demo, keyboard submission, 390px overflow and write-failure recovery.
+
+[Agent report](AGENT-EVALUATION.md) is a historical observation. [Mission](MISSION.md) includes parent checks and disclosed limitations. A stale status sentence left by the implementing agent was reconciled by the parent; this was not perfect autonomous bookkeeping. The design was delegated, so this test does not repeat the user-choice/image steps of the separate [Lisière pilot](../visual-pilot/README.md).
+
+Browser check from the DevMethod repository root: `node examples/clair-from-zero/browser-check.cjs`, with Playwright and Chrome available. Set PLAYWRIGHT_MODULE to an installed Playwright module path when needed. It writes captures under docs/media/from-zero/captures and uses a temporary browser profile.
+
+[French video and transcript](../../docs/media/from-zero/README.md) show this app's actual interactions and separately identify the Lisière visual pilot. Neither demonstration establishes general code quality, production readiness, lower costs or superiority over BMAD.