# AI FIRST — Meetup 19/10 — Personal-OS

**Le sujet — Un Personal OS : vos notes, vos tâches et votre agenda au même endroit, et une IA qui prépare vos journées à partir de ce que vous lui donnez.**

> Brief du meetup AI FIRST du 19/10 : construire en 2 heures un Personal OS local (journal, tâches, agenda) dont l'IA travaille avec des skills qu'on ajoute comme des fichiers, et voir par la pratique que la réponse dépend du contexte qu'on lui prépare.

- **Document** : Brief du meetup
- **Format** : Build de 2 heures. Trois paliers attendus, plus un bonus hors session.
- **Périmètre** : Tenir un journal, des tâches et un agenda dans des fichiers à soi, puis faire travailler une IA dessus avec des skills : plan du jour, capture, coach, et celles que vous ajoutez.
- **Hors périmètre** : Synchronisation entre appareils, partage à plusieurs, application mobile, écriture dans votre vrai calendrier, transcription audio.
- **Prérequis** : Une IA appelable depuis votre code : Claude Code, Codex, Antigravity (via Gemini CLI) ou une clé Groq gratuite. Voir § 00, dix minutes.

---

## § 00 — Avant de commencer

Votre Personal OS a besoin d'appeler une IA depuis votre machine. **Choisissez une des deux options ci-dessous et vérifiez-la avant de lire le sujet.** Dix minutes, à faire avant d'arriver.

1. **Option 1, votre assistant de code.** Si vous utilisez déjà Claude Code, Codex ou Antigravity, votre application peut appeler l'IA en ligne de commande avec votre abonnement, sans clé d'API : elle lui passe un contexte et récupère sa réponse. Choisissez l'onglet de votre outil ci-dessous.
2. **Option 2, Groq.** Créez une clé gratuite sur [console.groq.com/keys](https://console.groq.com/keys) (« Create API Key »). Elle commence par `gsk_` et ne sera plus réaffichée : gardez-la de côté.
3. Vérifier l'option choisie avec la commande de son onglet. Pour Groq, remplacez `gsk_TA_CLE` par la vôtre.
4. Exporter votre agenda au format ICS depuis votre outil de calendrier, ou préparer quelques rendez-vous inventés pour la semaine. Les deux conviennent.
5. Rejoindre le Discord d'AI First sur [discord.gg/dwhBq7YXn](https://discord.gg/dwhBq7YXn), pour poser vos questions pendant le build et après.

Les assistants de code doivent répondre OK, Groq doit renvoyer une liste de modèles. Avec Groq, une erreur 401 veut dire que la clé est mal collée.

**Claude Code**

Avec un abonnement Claude. Installation : [page de démarrage](https://docs.anthropic.com/en/docs/claude-code/quickstart). En mode commande, `claude -p` lit aussi le contexte envoyé sur l'entrée standard.

```bash
claude -p "Réponds seulement OK"
```

**Codex**

Avec un abonnement ChatGPT. Installation : [Codex CLI](https://developers.openai.com/codex/cli), puis `codex login`. En mode commande, `codex exec` répond et rend la main.

```bash
codex exec "Réponds seulement OK"
```

**Antigravity**

Antigravity est un éditeur : il vous aide à construire, mais votre application ne peut pas l'appeler. Pour ça, installez [Gemini CLI](https://github.com/google-gemini/gemini-cli) et connectez-vous avec le même compte Google. En mode commande, `gemini -p` répond et rend la main.

```bash
gemini -p "Réponds seulement OK"
```

**Groq (macOS / Linux)**

```bash
curl -s https://api.groq.com/openai/v1/models -H "Authorization: Bearer gsk_TA_CLE"
```

**Groq (Windows)**

```powershell
Invoke-RestMethod -Uri https://api.groq.com/openai/v1/models -Headers @{Authorization="Bearer gsk_TA_CLE"} | Select-Object -ExpandProperty data | Select-Object id
```

### Ce qu'il faut savoir

| Point | Détail |
| --- | --- |
| Le mode commande | claude -p, codex exec et gemini -p répondent à une seule demande puis rendent la main : votre application les lance comme n'importe quel programme. Ils consomment votre abonnement, pas une clé. |
| Les skills de Claude Code | Claude Code a lui-même un système de skills : un dossier par skill, un fichier SKILL.md qui dit à quoi elle sert et ce qu'elle doit faire. C'est une bonne source d'inspiration pour le palier 2, pas une obligation. |
| Groq gratuit | Le quota est compté en tokens par minute. Un contexte de plusieurs pages peut le consommer en un appel : regardez les limites de chaque modèle sur console.groq.com avant de choisir. |
| Autre IA | Une autre IA appelable depuis votre code convient aussi. Le brief ne dépend pas du modèle choisi. |
| Vos vraies données | Des données inventées suffisent pour tout le brief. Si vous mettez votre vrai journal ou votre vrai agenda, choisissez ce que vous acceptez d'envoyer à une IA en ligne. |

> **Ce que vous envoyez à l'IA** — Tout ce que l'application envoie à l'IA vous est montré avant l'envoi. **Relisez-le comme un mail qui part à l'extérieur**. Une clé Groq ne se colle ni dans un dépôt public, ni dans un chat, ni dans un fichier de données.

---

## § 01 — Esprit de l'exercice

Demandez à une IA « qu'est-ce que je dois faire demain ? » : elle vous conseillera de lister vos priorités et de prévoir des pauses. Elle ne connaît ni votre devis en retard, ni votre réunion de jeudi. Ce qui lui manque, c'est le contexte. Le context engineering consiste à lui préparer les bonnes informations pour une tâche précise, en quatre gestes : **écrire** ce qui se passe, **sélectionner** ce qui sert, **résumer** plutôt que tout transmettre, **isoler** chaque mission avec son propre dossier. Ce soir, chacun de ces gestes devient une brique de votre Personal OS. Vous repartez avec une application qui tourne sur votre machine, et à laquelle vous ajoutez une skill comme on ajoute un fichier.

### Parti pris #1 — Deux choses imposées, le reste libre

Le sujet de la soirée, c'est le contexte. Deux points sont donc fixés : **vos données vivent dans des fichiers que vous lisez sans l'application**, et **une skill est un fichier** qui dit ce qu'elle fait et ce qu'elle lit. Pour tout le reste (langage, interface, application web, terminal ou bureau, découpage du code), ce brief dit *ce que* l'application doit faire, jamais *comment*. Partout où une décision se présente, elle vous appartient.

### Parti pris #2 — Une difficulté progressive

Trois paliers attendus et un bonus hors session. Le palier 1 donne une mémoire et un premier plan du jour ; le palier 2 rend les skills extensibles ; le palier 3 fait intervenir l'IA au bon moment et tient le contexte dans ses limites. Qui ne livre que le palier 1 a déjà une vraie réponse à « qu'est-ce que je dois faire demain ? ».

## § 02 — La mise en situation

*Mercredi soir. Léa, indépendante, prépare sa journée de jeudi. Elle a un point d'équipe à 14 h et rien de prêt.*

« Mes notes sont dans un carnet, mes tâches dans une appli que j'ouvre une fois par semaine, et l'agenda, c'est encore ailleurs. Lundi, j'ai écrit que je n'avais pas eu le temps de faire le devis Dupont. Mardi, pareil. Et ce soir, j'ai demandé à une IA de m'aider à organiser demain. Elle m'a répondu de bloquer des créneaux et de boire de l'eau. Normal, elle ne sait rien de ma semaine. »

« Ce que je veux, c'est un endroit à moi : mon journal, mes tâches et mon agenda, au même endroit. Le matin, qu'il me dise quoi faire en premier. Le vendredi, qu'il me dise si j'ai avancé sur la newsletter, mon vrai objectif du trimestre. Et je veux voir ce qu'il a lu avant de répondre. Le jour où j'ai une nouvelle idée, préparer mes rendez-vous clients par exemple, je veux pouvoir l'ajouter sans tout refaire. »

**C'est le besoin. À toi de le faire exister.**

## § 03 — Les paliers

Un seul métier : tenir la mémoire de votre travail, et en tirer pour chaque question le dossier qui sert. Le palier 1 est attendu de tous, et il suffit pour repartir avec un outil qui sert dès demain matin.

1. **Socle** — Attendu de tous
2. **Avancé** — Des skills qu'on ajoute
3. **Poussé** — Au bon moment, dans les limites
4. **Bonus** — Hors session, aucune attente

---

## Palier 1 — Socle — Attendu de tous

Premier geste : **écrire**. Puis un premier usage de l'IA, le plan du jour. À la fin de ce palier, Léa note une ligne dans son journal en quelques secondes, et l'application lui propose sa journée de demain à partir de ses tâches et de son agenda.

### Fonctionnalités

- **Tenir un journal.** Une entrée par pensée, compte rendu ou décision. Elle est datée au moment où on l'écrit.
- **Gérer ses tâches.** Une tâche a un titre, un statut et, si besoin, une échéance. Une tâche faite se marque d'un geste.
- **Voir son agenda.** Les rendez-vous de la semaine, importés d'un fichier ICS ou saisis à la main.
- **Dire qui on est.** Un fichier `moi.md` : votre métier, vos objectifs du moment, vos façons de travailler. Il change rarement.
- **Demander le plan du jour.** Un bouton ou une commande « Plan du jour » : l'IA reçoit les tâches en cours, l'agenda des sept prochains jours et le journal récent, et propose un ordre pour la journée, argumenté.

### Règles de gestion — Palier 1

| Domaine | Règle |
| --- | --- |
| Fichiers lisibles | Le journal, les tâches, l'agenda et moi.md sont des fichiers texte ou Markdown qu'on ouvre et qu'on comprend avec un simple éditeur, sans l'application. |
| Aller-retour | Un fichier modifié à la main hors de l'application est relu correctement à la réouverture. |
| Date | Une entrée du journal garde sa date de création, même quand on la modifie ensuite. |
| Statut | Une tâche est dans un seul statut à la fois. Une tâche faite reste consultable. |
| Échéance | Une tâche sans échéance est valide. Une tâche en retard et pas faite se repère sans chercher. |
| Agenda | L'application ne modifie jamais votre vrai calendrier. Importer deux fois le même fichier ne crée aucun doublon. |
| Fenêtre | Le plan du jour ne reçoit que l'agenda des sept prochains jours. Un rendez-vous passé n'y figure pas. |
| Transparence | Avant chaque appel, le contexte complet est affiché, exactement tel qu'il partira. Rien n'est ajouté entre l'affichage et l'envoi. |
| IA injoignable | Si l'IA ne répond pas, l'application le dit et le contexte reste affiché, prêt à copier dans l'outil de votre choix. Jamais un écran blanc. |
| Récent | **À TRANCHER (participant) :** que veut dire « journal récent » pour le plan du jour ? Hier seulement, les trois derniers jours, la semaine ? Moins de journal, l'IA rate le devis repoussé deux fois ; trop, elle s'y perd. Choisissez, et affichez la règle à côté du contexte. |

> **Note de cadrage** — Ni compte, ni serveur, ni synchronisation : tout vit sur votre machine. Ce palier se juge sur une démo simple : posez la question « qu'est-ce que je dois faire demain ? » à l'IA seule, puis à votre application. Si la deuxième réponse cite une vraie tâche et un vrai rendez-vous de votre semaine, le palier est réussi.

---

## Palier 2 — Avancé — Des skills qu'on ajoute

Deuxième et quatrième gestes : **sélectionner** et **isoler**. Le plan du jour devient une skill parmi d'autres. Chaque skill est un fichier qui dit sa mission et ce qu'elle a le droit de lire. À la fin de ce palier, Léa ajoute une skill sans toucher au code.

### Fonctionnalités

- **Une skill, un fichier.** Chaque skill est décrite dans un fichier : son nom, sa mission, ses instructions, et les sources qu'elle lit (journal, tâches, agenda, moi.md), avec leur portée, par exemple « le journal de la semaine ».
- **Capture.** On écrit une phrase en vrac, et la skill propose où la ranger : entrée de journal, nouvelle tâche, ou les deux. Rien n'est écrit avant votre validation.
- **Coach.** En fin de semaine, la skill lit le journal et les tâches de la semaine face aux objectifs de moi.md, et rend un bilan : ce qui a avancé, ce qui traîne, ce qui ne sert pas l'objectif.
- **Le bilan devient mémoire.** Troisième geste, **résumer** : le bilan du coach s'enregistre comme une entrée du journal, et c'est lui que le coach relit la semaine suivante, plutôt que tout le journal passé.
- **Votre skill.** Ajoutez au moins une skill à vous : préparer un rendez-vous, rédiger le point d'équipe, trier la boîte à idées. Ajouter le fichier suffit pour qu'elle apparaisse dans l'application.

### Règles de gestion — Palier 2

| Domaine | Règle |
| --- | --- |
| Fichier | Une skill se lit et se modifie dans un éditeur de texte. Une modification est prise en compte au prochain appel, sans relancer l'application. |
| Ajout | Ajouter une skill ne demande aucune modification du code de l'application. |
| Isolement | Une skill ne reçoit que les sources et la portée déclarées dans son fichier. Le plan du jour ne voit pas moi.md s'il ne l'a pas déclaré. |
| Qui lit quoi | L'application affiche, pour chaque skill, ce qu'elle lit : la matrice du talk d'ouverture, mais tirée de vos fichiers. |
| Capture | La capture n'écrit rien sans validation. Une phrase refusée ne laisse aucune trace. |
| Bilan | Un bilan enregistré porte la date de la semaine qu'il résume, et se repère comme un bilan dans le journal. |
| Skill cassée | Un fichier de skill vide, illisible ou qui déclare une source inconnue produit un message clair. Il n'empêche pas les autres skills de fonctionner, et aucun appel ne part sans instructions. |
| Même question | Changer les sources d'une skill change sa réponse, et on peut le montrer : même question, deux contextes, deux réponses. |
| Objectifs | **À TRANCHER (participant) :** le plan du jour reçoit-il aussi moi.md, où sont écrits vos objectifs du trimestre ? Si oui, il peut vous garder une demi-heure pour la newsletter même un jour plein de rendez-vous. Si non, il organise demain avec vos seules tâches et votre agenda, et la newsletter n'existe pas pour lui. Choisissez, et ajoutez ou non moi.md aux sources déclarées dans le fichier de la skill. |

> **Note de cadrage** — Aux démos, on regardera deux choses : une skill ajoutée devant tout le monde, fichier ouvert, sans toucher au code ; et la même question posée avec deux dossiers différents. Si une réponse est à côté, regardez d'abord ce que la skill a reçu.

---

## Palier 3 — Poussé — Au bon moment, dans les limites

L'IA n'attend plus qu'on l'appelle : elle intervient à des moments choisis. Et de nouvelles sources entrent dans l'application sans la réécrire. À la fin de ce palier, Léa ouvre son Personal OS le matin et trouve son plan déjà prêt, et l'application tient chaque dossier dans une taille raisonnable.

### Fonctionnalités

- **Des moments.** Une skill peut déclarer quand elle intervient : à la première ouverture du jour, le vendredi en fin de journée, une heure avant un rendez-vous. L'application la propose ou la lance à ce moment-là.
- **Une nouvelle source.** Ajoutez une source à côté du journal, des tâches et de l'agenda : vos contacts, une boîte à idées, vos lectures. Les skills peuvent la déclarer comme les autres.
- **Des liens.** Une entrée de journal peut citer une tâche, un rendez-vous ou une autre entrée, et le lien se suit. Le format vous appartient : `[[devis-dupont]]`, `[[task:devis-dupont]]`, `[[event:sync-dupont]]` ou autre chose. Une skill qui lit une tâche peut lire aussi les entrées qui la citent.
- **Un budget de contexte.** Chaque skill a une taille maximale de contexte. Quand ses sources dépassent, l'application coupe selon une règle annoncée, et le dit.

### Règles de gestion — Palier 3

| Domaine | Règle |
| --- | --- |
| Moments | Un moment est déclaré dans le fichier de la skill. Le changer ne demande aucune modification du code. |
| Une fois | Une skill liée à un moment ne se déclenche qu'une fois par moment. Rouvrir l'application trois fois le matin ne produit pas trois plans du jour. |
| Contrôle | Une intervention automatique se désactive d'un geste, skill par skill. |
| Source | Une nouvelle source est un fichier ou un dossier lisible sans l'application, comme les autres. |
| Format | Le format des liens est le même dans toutes les sources, et se lit tel quel dans le fichier, sans l'application. |
| Lien cassé | Un lien qui ne correspond à rien se voit comme un lien cassé. Il n'est ni supprimé, ni transformé en objet vide. |
| Budget | Le contexte affiché avant l'envoi indique sa taille et ce qui a été coupé. Rien n'est coupé en silence. |
| Rien à lire | Une skill dont les sources sont vides le signale au lieu d'appeler l'IA avec un dossier vide. |
| Hors ligne | Un moment qui tombe quand l'IA est injoignable ne bloque pas l'application. Le contexte est gardé, prêt à être envoyé plus tard ou copié. |
| Quoi couper | **À TRANCHER (participant) :** quand le dossier dépasse le budget, que retire-t-on d'abord ? Le journal le plus ancien, les tâches faites, ou on résume avant d'envoyer ? Couper est gratuit, résumer coûte un appel de plus. Choisissez, et affichez la règle. |

> **Note de cadrage** — Ce palier se montre en simulant le temps : changez la date ou l'heure de l'application et montrez le plan du jour qui arrive seul, puis le coach du vendredi. Montrez aussi un dossier qui dépasse son budget, et ce que l'application en a retiré.

---

## Palier 4 — Bonus — Hors session, aucune attente

Les pistes de suite commencent là où s'arrête le périmètre du soir : **synchroniser** son Personal OS entre son ordinateur et son téléphone sans perdre la main sur ses fichiers ; **capturer à la voix** et laisser la skill Capture ranger la transcription ; **ouvrir son Personal OS à d'autres outils**, par exemple en l'exposant comme serveur MCP pour que Claude Desktop lise votre journal ; **renvoyer vers l'agenda** les créneaux que le plan du jour a proposés. **À ne pas attaquer avant d'avoir consolidé le reste.**

Une question à garder pour la discussion de fin : *si votre coach donne une mauvaise réponse, de qui est-ce la faute, de l'IA, de la skill, ou du dossier que vous lui avez préparé ?*
