living-documentation 8.13.0 → 8.15.0

package/dist/starter-doc/AI/PROJECT-INSTRUCTIONS.md

@@ -14,10 +14,9 @@ Before changing the project:
 4. Read `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` to know the development, build, test, lint, and setup commands.
 5. Read `memory/MEMORY.md` and load only the memory files relevant to the task.
 6. Read every rule in `DOCS_FOLDER/AI/rules/*.md`.
-7. Inspect existing ADRs: list `DOCS_FOLDER/ADRS/`, read only `description` and `tags` first, then open the full ADR only when relevant.
-8. Check whether the Living Documentation MCP server is available before creating or modifying documentation.
-
-Replace `DOCS_FOLDER` with the real documentation folder used by this project, for example `documentation`, `docs`, or `doc`.
+7. Read `DOCS_FOLDER/WORKLOG/current-task.md` if present to resume the state of the current task.
+8. Inspect existing ADRs: list `DOCS_FOLDER/ADRS/`, read only `description` and `tags` first, then open the full ADR only when relevant.
+9. Check whether the Living Documentation MCP server is available before creating or modifying documentation.
 
 ## Living Documentation MCP
 
@@ -52,6 +51,24 @@ Create or update a document when the change:
 
 Do not create durable documentation for trivial fixes, mechanical renames, or formatting-only changes.
 
+## Progress Tracking
+
+The `DOCS_FOLDER/WORKLOG/` folder holds the operational state of in-progress tasks and the resume points between AI assistants. It does not replace ADRs.
+
+`DOCS_FOLDER/WORKLOG/current-task.md` is the shared resume point. Every assistant must read it before resuming a task and update it before handing over when it has started, finished, interrupted, or left a known follow-up.
+
+The worklog must stay factual and useful for the next agent:
+
+- current status;
+- task in progress;
+- in-scope and out-of-scope items if needed;
+- files or areas concerned;
+- verifications performed;
+- remaining verifications;
+- next recommended action.
+
+Create a dedicated document under `DOCS_FOLDER/WORKLOG/` for an MVP ticket when more detailed tracking becomes necessary. Durable decisions stay in ADRs.
+
 ## ADRs
 
 ADRs are the log of architecture and design decisions. They should stay short, traceable, and useful for deciding what to change later.

package/dist/starter-doc/AI/default/AGENTS.md

@@ -9,8 +9,9 @@ Before making changes:
 3. Read `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` to know the development, build, test, lint, and setup commands.
 4. Read `memory/MEMORY.md` and load only useful memory files.
 5. Read rules in `DOCS_FOLDER/AI/rules/*.md`.
-6. Inspect ADRs in `DOCS_FOLDER/ADRS/` by reading `description` and `tags` first, then open the full ADR only when relevant.
-7. Check whether the `living-documentation` MCP is available and use it to create, update, and keep documentation reliable when the task touches a decision, rule, command, stack, or technical document.
+6. Read `DOCS_FOLDER/WORKLOG/current-task.md` if present to resume the state of the current task.
+7. Inspect ADRs in `DOCS_FOLDER/ADRS/` by reading `description` and `tags` first, then open the full ADR only when relevant.
+8. Check whether the `living-documentation` MCP is available and use it to create, update, and keep documentation reliable when the task touches a decision, rule, command, stack, or technical document.
 
 ## Living Documentation MCP
 

package/dist/starter-doc/AI/default/CLAUDE.md

@@ -9,8 +9,9 @@ Before making changes:
 3. Read `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` to know the development, build, test, lint, and setup commands.
 4. Read `memory/MEMORY.md` and load only useful memory files.
 5. Read rules in `DOCS_FOLDER/AI/rules/*.md`.
-6. Inspect ADRs in `DOCS_FOLDER/ADRS/` by reading `description` and `tags` first, then open the full ADR only when relevant.
-7. Check whether the `living-documentation` MCP is available and use it to create, update, and keep documentation reliable when the task touches a decision, rule, command, stack, or technical document.
+6. Read `DOCS_FOLDER/WORKLOG/current-task.md` if present to resume the state of the current task.
+7. Inspect ADRs in `DOCS_FOLDER/ADRS/` by reading `description` and `tags` first, then open the full ADR only when relevant.
+8. Check whether the `living-documentation` MCP is available and use it to create, update, and keep documentation reliable when the task touches a decision, rule, command, stack, or technical document.
 
 ## Living Documentation MCP
 

package/dist/starter-doc/AI/rules/track-current-work.md

@@ -0,0 +1,23 @@
+---
+id: track-current-work
+title: Track the current task in WORKLOG
+severity: required
+description: AI assistants must read and maintain the current-task worklog to enable reliable handoff between agents.
+tags: ["worklog", "handoff", "ai-agents", "progress", "documentation"]
+appliesTo: ["**/*"]
+---
+
+Before resuming or modifying the project, read `DOCS_FOLDER/WORKLOG/current-task.md` if the file exists.
+
+When a task is started, interrupted, finished, or left with known follow-ups, update `DOCS_FOLDER/WORKLOG/current-task.md` with:
+
+- the current status;
+- the task in progress;
+- the files or areas concerned;
+- the verifications performed;
+- the remaining verifications;
+- the next recommended action.
+
+For an MVP ticket that has actually started, create or update a dedicated document under `DOCS_FOLDER/WORKLOG/` if the tracking no longer fits clearly in `current-task.md`.
+
+The worklog does not replace ADRs: it describes operational progress and resume points, not durable decisions.

package/dist/starter-doc/WORKLOG/current-task.md

@@ -0,0 +1,57 @@
+---
+**date:** 2026-01-02
+**status:** Idle
+**description:** Shared resume point between AI assistants to track the current task, its status, the files touched, the verifications, and the next action.
+**tags:** worklog, handoff, progress, resume, ai-agents
+---
+
+# Current task
+
+This document is the shared resume point between AI assistants. Every agent must read it before continuing a task and update it before handing over.
+
+## Current status
+
+Idle
+
+## Current task
+
+No application implementation task is currently in progress.
+
+## Last action performed
+
+Added the progress-tracking convention between AI assistants:
+
+- created this current worklog;
+- created the mandatory rule `track-current-work`;
+- added the worklog read step in `AGENTS.md`, `CLAUDE.md` and `PROJECT-INSTRUCTIONS.md`.
+
+## Next recommended action
+
+Start Ticket 01: initialize the React + TypeScript + Vite + Tailwind frontend project, then update this worklog with the files created, the verifications run, and any resume points.
+
+## Files or areas concerned
+
+- `AGENTS.md`
+- `CLAUDE.md`
+- `DOCS_FOLDER/AI/PROJECT-INSTRUCTIONS.md`
+- `DOCS_FOLDER/AI/rules/track-current-work.md`
+- `DOCS_FOLDER/WORKLOG/current-task.md`
+- `DOCS_FOLDER/PRODUCT/`
+- `DOCS_FOLDER/TECHNICAL/`
+- `DOCS_FOLDER/ROADMAP/`
+- `DOCS_FOLDER/ADRS/`
+- `DOCS_FOLDER/AI/PROJECT-STACK.md`
+- `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md`
+
+## Recent verifications
+
+- Living Documentation MCP available.
+- `WORKLOG/current-task` visible in the MCP inventory.
+- `AI/rules/track-current-work` visible in the MCP inventory.
+- ADRs created with metadata and accuracy `1`.
+- `PROJECT-STACK` with metadata and accuracy `1`.
+- No ADR below the reliability threshold.
+
+## Resume notes
+
+The repository does not contain any application code yet. Do not assume the existence of `package.json`, `src/`, npm scripts, tests, or Tailwind configuration before Ticket 01.

package/dist/starter-doc-fr/AI/PROJECT-INSTRUCTIONS.md

@@ -14,8 +14,9 @@ Avant de modifier le projet :
 4. Lire `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` pour connaître les commandes de développement, build, test, lint et setup.
 5. Lire `memory/MEMORY.md` et charger seulement les fichiers mémoire utiles à la tâche.
 6. Lire toutes les règles dans `DOCS_FOLDER/AI/rules/*.md`.
-7. Inspecter les ADR existants : lister `DOCS_FOLDER/ADRS/`, lire d'abord `description` et `tags`, puis ouvrir l'ADR complet seulement s'il est pertinent.
-8. Vérifier si le MCP `living-documentation` est disponible avant de créer ou modifier de la documentation.
+7. Lire `DOCS_FOLDER/WORKLOG/current-task.md` si présent pour reprendre l'état de la tâche courante.
+8. Inspecter les ADR existants : lister `DOCS_FOLDER/ADRS/`, lire d'abord `description` et `tags`, puis ouvrir l'ADR complet seulement s'il est pertinent.
+9. Vérifier si le MCP `living-documentation` est disponible avant de créer ou modifier de la documentation.
 
 ## Rôle du MCP Living Documentation
 
@@ -50,6 +51,24 @@ Créer ou mettre à jour un document lorsque le changement :
 
 Ne pas créer de documentation durable pour les corrections triviales, renommages mécaniques ou changements de formatage.
 
+## Suivi de progression
+
+Le dossier `DOCS_FOLDER/WORKLOG/` contient l'état opérationnel des tâches en cours et les points de reprise entre assistants IA. Il ne remplace pas les ADR.
+
+`DOCS_FOLDER/WORKLOG/current-task.md` est le point de reprise partagé. Tout assistant doit le lire avant de reprendre une tâche et le mettre à jour avant de rendre la main lorsqu'il a commencé, terminé, interrompu ou laissé une suite connue.
+
+Le worklog doit rester factuel et utile pour l'agent suivant :
+
+- statut courant ;
+- tâche en cours ;
+- scope inclus et exclu si nécessaire ;
+- fichiers ou zones concernés ;
+- vérifications réalisées ;
+- vérifications restantes ;
+- prochaine action recommandée.
+
+Créer un document dédié dans `DOCS_FOLDER/WORKLOG/` pour un ticket MVP lorsqu'un suivi plus détaillé devient nécessaire. Les décisions durables restent dans les ADR.
+
 ## ADR
 
 Les ADR sont le journal des décisions d'architecture et de conception. Ils doivent rester courts, traçables et utiles pour décider quoi modifier plus tard.

package/dist/starter-doc-fr/AI/default/AGENTS.md

@@ -9,8 +9,9 @@ Avant toute modification :
 3. Lire `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` pour connaître les commandes de développement, build, test, lint et setup.
 4. Lire `memory/MEMORY.md` et charger seulement les fichiers mémoire utiles à la tâche.
 5. Lire toutes les règles dans `DOCS_FOLDER/AI/rules/*.md`.
-6. Inspecter les ADR dans `DOCS_FOLDER/ADRS/` en lisant d'abord `description` et `tags`, puis ouvrir l'ADR complet seulement s'il est pertinent.
-7. Vérifier si le MCP `living-documentation` est disponible et l'utiliser pour créer, mettre à jour et fiabiliser la documentation lorsque la tâche touche une décision, une règle, une commande, la stack ou un document technique.
+6. Lire `DOCS_FOLDER/WORKLOG/current-task.md` si présent pour reprendre l'état de la tâche courante.
+7. Inspecter les ADR dans `DOCS_FOLDER/ADRS/` en lisant d'abord `description` et `tags`, puis ouvrir l'ADR complet seulement s'il est pertinent.
+8. Vérifier si le MCP `living-documentation` est disponible et l'utiliser pour créer, mettre à jour et fiabiliser la documentation lorsque la tâche touche une décision, une règle, une commande, la stack ou un document technique.
 
 ## MCP Living Documentation
 

package/dist/starter-doc-fr/AI/default/CLAUDE.md

@@ -9,8 +9,9 @@ Avant toute modification :
 3. Lire `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` pour connaître les commandes de développement, build, test, lint et setup.
 4. Lire `memory/MEMORY.md` et charger seulement les fichiers mémoire utiles à la tâche.
 5. Lire toutes les règles dans `DOCS_FOLDER/AI/rules/*.md`.
-6. Inspecter les ADR dans `DOCS_FOLDER/ADRS/` en lisant d'abord `description` et `tags`, puis ouvrir l'ADR complet seulement s'il est pertinent.
-7. Vérifier si le MCP `living-documentation` est disponible et l'utiliser pour créer, mettre à jour et fiabiliser la documentation lorsque la tâche touche une décision, une règle, une commande, la stack ou un document technique.
+6. Lire `DOCS_FOLDER/WORKLOG/current-task.md` si présent pour reprendre l'état de la tâche courante.
+7. Inspecter les ADR dans `DOCS_FOLDER/ADRS/` en lisant d'abord `description` et `tags`, puis ouvrir l'ADR complet seulement s'il est pertinent.
+8. Vérifier si le MCP `living-documentation` est disponible et l'utiliser pour créer, mettre à jour et fiabiliser la documentation lorsque la tâche touche une décision, une règle, une commande, la stack ou un document technique.
 
 ## MCP Living Documentation
 

package/dist/starter-doc-fr/AI/rules/track-current-work.md

@@ -0,0 +1,23 @@
+---
+id: track-current-work
+title: Suivre la tâche courante dans WORKLOG
+severity: required
+description: Les assistants IA doivent lire et maintenir le worklog de tâche courante pour permettre une reprise fiable entre agents.
+tags: ["worklog", "handoff", "agents-ia", "progression", "documentation"]
+appliesTo: ["**/*"]
+---
+
+Avant de reprendre ou modifier le projet, lire `DOCS_FOLDER/WORKLOG/current-task.md` si le fichier existe.
+
+Quand une tâche est commencée, interrompue, terminée ou laissée avec des suites connues, mettre à jour `DOCS_FOLDER/WORKLOG/current-task.md` avec :
+
+- le statut courant ;
+- la tâche en cours ;
+- les fichiers ou zones concernés ;
+- les vérifications réalisées ;
+- les vérifications restantes ;
+- la prochaine action recommandée.
+
+Pour un ticket MVP réellement commencé, créer ou mettre à jour un document dédié dans `DOCS_FOLDER/WORKLOG/` si le suivi ne tient plus clairement dans `current-task.md`.
+
+Le worklog ne remplace pas les ADR : il décrit l'avancement opérationnel et les points de reprise, pas les décisions durables.

package/dist/starter-doc-fr/WORKLOG/current-task.md

@@ -0,0 +1,57 @@
+---
+**date:** 2026-01-02
+**status:** Idle
+**description:** Point de reprise partagé entre assistants IA pour suivre la tâche courante, son statut, les fichiers touchés, les vérifications et la prochaine action.
+**tags:** worklog, handoff, progression, reprise, agents-ia
+---
+
+# Current task
+
+Ce document est le point de reprise entre assistants IA. Tout agent doit le lire avant de continuer une tâche et le mettre à jour avant de rendre la main.
+
+## Statut courant
+
+Idle
+
+## Tâche courante
+
+Aucune tâche d'implémentation applicative n'est en cours.
+
+## Dernière action réalisée
+
+Ajout de la convention de suivi de progression entre assistants IA :
+
+- création de ce worklog courant ;
+- création de la règle obligatoire `track-current-work` ;
+- ajout de la lecture du worklog dans `AGENTS.md`, `CLAUDE.md` et `PROJECT-INSTRUCTIONS.md`.
+
+## Prochaine action recommandée
+
+Démarrer le Ticket 01 : initialiser le projet frontend React + TypeScript + Vite + Tailwind, puis mettre à jour ce worklog avec les fichiers créés, les vérifications lancées et les éventuels points de reprise.
+
+## Fichiers ou zones concernés
+
+- `AGENTS.md`
+- `CLAUDE.md`
+- `DOCS_FOLDER/AI/PROJECT-INSTRUCTIONS.md`
+- `DOCS_FOLDER/AI/rules/track-current-work.md`
+- `DOCS_FOLDER/WORKLOG/current-task.md`
+- `DOCS_FOLDER/PRODUCT/`
+- `DOCS_FOLDER/TECHNICAL/`
+- `DOCS_FOLDER/ROADMAP/`
+- `DOCS_FOLDER/ADRS/`
+- `DOCS_FOLDER/AI/PROJECT-STACK.md`
+- `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md`
+
+## Vérifications récentes
+
+- MCP Living Documentation disponible.
+- `WORKLOG/current-task` visible dans l'inventaire MCP.
+- `AI/rules/track-current-work` visible dans l'inventaire MCP.
+- ADR créés avec métadonnées et accuracy `1`.
+- `PROJECT-STACK` avec métadonnées et accuracy `1`.
+- Aucun ADR sous le seuil de fiabilité.
+
+## Notes de reprise
+
+Le dépôt ne contient pas encore de code applicatif. Ne pas supposer l'existence de `package.json`, `src/`, scripts npm, tests ou configuration Tailwind avant le Ticket 01.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "living-documentation",
-  "version": "8.13.0",
+  "version": "8.15.0",
   "description": "Local Markdown documentation hub with a built-in MCP server — coding agents create ADRs, draw diagrams and detect drift while you code.",
   "main": "dist/src/server.js",
   "bin": {