---
title: "Tutoriel workflow : boucle de travail et étage captation"
subtitle: "Produire (brief → agent → résultat) puis capter (Flux · Journal · Carte) — deux étages, un même Fil :4477"
date: 2026-09-30
time: "20:00"
author: VFG / Fil (Chronowflow)
publishedBy: code
status: pub
tags: ["fil", "chronowflow", "devblog", "workflow", "tutoriel", "presence", "captation"]
---

Fil n’est pas « un outil de plus à remplir ». Il a **deux étages** qui se lisent dans cet ordre : d’abord **produire** (tu déclares une tâche et tu lances l’agent), ensuite **capter** (la machine émet déjà, Fil range sans que tu ressaisisses). Ce billet synthétise les tutoriels [basique](https://github.com/FGDidou/Chronowflow/blob/main/docs/WORKFLOW-BASIQUE.md) et [complet](https://github.com/FGDidou/Chronowflow/blob/main/docs/WORKFLOW-COMPLET.md) pour un lecteur qui veut le parcours sans rouvrir toute la doc.

## Les deux étages

| Étage | Rôle | Vues |
| --- | --- | --- |
| **1. Produire** | Une tâche, un brief, un agent, un résultat | Guide · Projets · Tâche · Présence |
| **2. Capter** | Ce que la machine émet déjà | Flux · Journal · Carte · Inbox |

**Fil ne remplace pas ton agent.** Il prépare le brief, suit l’exécution et garde la trace. C’est toi qui lances le travail dans le client (Claude Code, Cursor, Codex…) et qui valides le résultat.

Huit vues au total : Guide · Présence · Flux · Journal · Projets · Tâche · Inbox · Carte. L’onglet **Guide** rejoue le parcours court dans l’UI.

## Étage 1 — du brief au résultat

1. **Démarrer** — lanceur présence Chronos (ou `npm run dev` en développement) → **http://127.0.0.1:4477**. Après un changement de code, le lanceur sert un **build de production** : reconstruire puis redémarrer, sinon l’ancien processus garde le port.
2. **Projets** — nom + **dossier exact** de travail (ex. `D:\GitRepos\Chronowflow`). Ce chemin alimente aussi la source **git** de l’étage 2 ; sans projet enregistré, git reste vide et Fil **ne fabrique aucun commit**.
3. **Tâche** — prochaine action + contexte → **Copier le brief** → coller dans l’agent ouvert **dans le dossier du projet**.
4. **Présence** — vérifier client, dossier, titre, compteur d’outils ; **Confirmer** la suggestion de liaison (jamais auto-appliquée).
5. **Livrer** — écrire le **Résultat**, statut terminée. La fin d’un agent **ne termine pas** une tâche : l’ordonnancement reste manuel.

| État Présence | Signification |
| --- | --- |
| Actif | Activité reçue récemment (moins de 15 s) |
| Silencieux | Pas d’événement ≥ 15 s — **reste visible** ; le calcul peut continuer |
| Terminé | Fin reçue ; retrait après 60 s |
| Interrompu / échec | Fin anormale ; retrait après 5 min |

Un silence **ne masque jamais** une exécution. Seul un état terminal reçu, après rétention, retire la tuile. L’historique Chronos reste intact.

## Étage 2 — ce que Fil aspire sans déclaration

| Source | Statut registre |
| --- | --- |
| Chronos · Pulse · Git · Blog | `live` (blog souvent hors collecte Flux) |
| Telegram · IdeaPit | `declared` — **jamais** présentés comme fonctionnels |

Chaîne unique : classer → taguer → scorer. **Rien n’est détruit** : le papier peint devient `bruit`, compté, plafonné. Journal : bruit / ambiance **repliés** (ex. mesure session captation : « 141 items / 68 projets » → « 4 de travail / 3 projets ») mais consultables. Minutes actives = **durées mesurées seulement**.

Couverture honnête : Chronos / Pulse / Git annoncent **partiel** quand c’est le cas. Un journal court **ne prouve pas** une journée vide.

**Santé** : `aucun item` ≠ `hors ligne` ; source non interrogée ≠ archive vide observée ; panne Chronos → Pulse continue, lecture **périmée** visible.

**Carte** : fils automatiques `projet → session → items` + fusion de titres proches inter-sources (compteur « doublons fusionnés » dans le bandeau — voir billet fils nestés).

**Anti-dispersion** : focus (pénalité visible, jamais masquante) · budget par source (ligne compteur épinglée) · Top-20 + Voir plus · alerte dispersion sur travail/échanges seulement. Ordre : filtre → focus/score → tri → budget → pagination.

## Où vivent les données

| Donnée | Où | Survit au reload |
| --- | --- | --- |
| Projets, tâches, résultats, liaisons, triage Inbox | `fil.workspace.v1` (navigateur) | oui |
| Items de flux | reconstruits à chaque collecte | non — par conception |
| Dismiss / cleared | vue locale navigateur | oui ; Chronos intact |

Chronos est le seul ledger durable. Fil ne l’écrit jamais. Privacy : pas de prompt brut, press-papiers, corps de message ; titres bornés.

### Preuve (documentée dans les tutoriels / STATUS)

| Contrôle | Où c’est affirmé |
| --- | --- |
| Scénario `tests/workflow.browser.mjs` | WORKFLOW-BASIQUE — profil jetable, liaison, résultat, retrait 60 s |
| Scénario `tests/capture.browser.mjs` | WORKFLOW-COMPLET / plan prioritaire — captation, panne, mobile |
| Compteur tests produit (STATUS) | **279** après fils nestés (ne pas confondre avec 246 / 247 / 249 des lots antérieurs) |

### Non exécuté dans ce billet

- Rejeu doctor / smoke Chronos / Playwright au moment de la rédaction éditoriale.
- Certification que le lanceur présence et tous les upstreams sont up sur le poste lecteur.
- Digests de jours clos, sync multi-appareils, relance d’agent depuis l’UI (limites produit documentées).

## Diagnostic express

```powershell
powershell -NoProfile -File D:\VFG_PT__\FG_Chronos\scripts\doctor-agent-presence.ps1
node D:\VFG_PT__\FG_Chronos\scripts\smoke-agent-workflow.mjs
```

Hors ligne → relancer le start + doctor. Connecté mais vide → nouveau message depuis un client hooké. Mauvaise suggestion → ne pas confirmer. « Lecture périmée » → amont tombé, reprise auto. Couverture partielle → attendu tant que Chronos ancien ou fenêtres Pulse/Git bornées.

## Une phrase pour la suite

La boucle de travail **écrit l’intention** ; la captation **lit la réalité** — les deux tutoriels existent pour qu’on ne confonde jamais les deux étages, ni un journal court avec une journée vide.

---

*Sources : `docs/WORKFLOW-BASIQUE.md`, `docs/WORKFLOW-COMPLET.md`, `STATUS.md`, `docs/PLAN-PRIORITAIRE-2026-09-15.md`. Miroir : `Chronowflow/docs/devblog/`.*