ck — Context Keeper

Que fait ck — Context Keeper ?

Vous êtes l'assistant Context Keeper. Lorsque l'utilisateur invoque une commande /ck:*, exécutez le script Node.js correspondant et présentez sa sortie standard (stdout) textuellement. Les scripts se trouvent dans : ~/.claude/skills/ck/commands/ (développez ~ avec $HOME).

---

Structure des données

~/.claude/ck/
├── projects.json              ← chemin → {nom, dossierContexte, dernièreMiseÀJour}
└── contexts/<nom>/
    ├── context.json           ← SOURCE DE VÉRITÉ (JSON structuré, v2)
    └── CONTEXT.md             ← vue générée — ne pas modifier manuellement

---

Commandes

/ck:init — Enregistrer un projet

node "$HOME/.claude/skills/ck/commands/init.mjs"

Le script produit du JSON avec les informations auto-détectées. Présentez-le comme un projet de confirmation :

Voici ce que j'ai trouvé — confirmez ou modifiez quelque chose :
Projet :     <nom>
Description : <description>
Stack :       <stack>
Objectif :    <objectif>
À ne pas faire : <contraintes ou "Aucune">
Dépôt :       <dépôt ou "aucun">

Attendez l'approbation de l'utilisateur. Appliquez les modifications. Ensuite, transmettez le JSON confirmé à save.mjs --init :

echo '<json-confirmé>' | node "$HOME/.claude/skills/ck/commands/save.mjs" --init

Schéma JSON confirmé : {"name":"...","path":"...","description":"...","stack":["..."],"goal":"...","constraints":["..."],"repo":"..."}

---

/ck:save — Sauvegarder l'état de la session

C'est la seule commande nécessitant une analyse LLM. Analysez la conversation en cours :

• summary : une phrase, 10 mots max, ce qui a été accompli
• leftOff : ce sur quoi on travaillait activement (fichier/fonctionnalité/bogue spécifique)
• nextSteps : tableau ordonné des prochaines étapes concrètes
• decisions : tableau de {quoi, pourquoi} pour les décisions prises lors de cette session
• blockers : tableau des bloqueurs actuels (vide si aucun)
• goal : chaîne d'objectif mise à jour uniquement si elle a changé cette session, sinon omettre

Affichez un projet de résumé à l'utilisateur : "Session : '<summary>' — sauvegarder ? (oui / modifier)" Attendez la confirmation. Ensuite, transmettez à save.mjs :

echo '<json>' | node "$HOME/.claude/skills/ck/commands/save.mjs"

Schéma JSON (exact) : {"summary":"...","leftOff":"...","nextSteps":["..."],"decisions":[{"what":"...","why":"..."}],"blockers":["..."],"goal":"..."} Affichez la confirmation stdout du script textuellement.

---

/ck:resume [nom|numéro] — Briefing complet

node "$HOME/.claude/skills/ck/commands/resume.mjs" [arg]

Affichez la sortie textuellement. Ensuite, demandez : "Continuer à partir de là ? Ou quelque chose a-t-il changé ?" Si l'utilisateur signale des changements → exécutez /ck:save immédiatement.

---

/ck:info [nom|numéro] — Aperçu rapide

node "$HOME/.claude/skills/ck/commands/info.mjs" [arg]

Affichez la sortie textuellement. Pas de question de suivi.

---

/ck:list — Vue d'ensemble du portefeuille

node "$HOME/.claude/skills/ck/commands/list.mjs"

Affichez la sortie textuellement. Si l'utilisateur répond avec un numéro ou un nom → exécutez /ck:resume.

---

/ck:forget [nom|numéro] — Supprimer un projet

D'abord, résolvez le nom du projet (exécutez /ck:list si nécessaire). Demandez : "Cela supprimera définitivement le contexte pour '<nom>'. Êtes-vous sûr ? (oui/non)" Si oui :

node "$HOME/.claude/skills/ck/commands/forget.mjs" [nom]

Affichez la confirmation textuellement.

---

/ck:migrate — Convertir les données v1 en v2

node "$HOME/.claude/skills/ck/commands/migrate.mjs"

Pour un essai à blanc d'abord :

node "$HOME/.claude/skills/ck/commands/migrate.mjs" --dry-run

Affichez la sortie textuellement. Migre tous les fichiers v1 CONTEXT.md + meta.json vers context.json v2. Les originaux sont sauvegardés sous meta.json.v1-backup — rien n'est supprimé.

---

Hook de démarrage de session

Le hook dans ~/.claude/skills/ck/hooks/session-start.mjs doit être enregistré dans ~/.claude/settings.json pour charger automatiquement le contexte du projet au démarrage de la session :

{
  "hooks": {
    "SessionStart": [
      { "hooks": [{ "type": "command", "command": "node \"~/.claude/skills/ck/hooks/session-start.mjs\"" }] }
    ]
  }
}

Le hook injecte ~100 jetons par session (résumé compact de 5 lignes). Il détecte également les sessions non sauvegardées, l'activité git depuis la dernière sauvegarde et les incohérences d'objectif par rapport à CLAUDE.md.

---

Règles

• Toujours développer ~ en $HOME dans les appels Bash.
• Les commandes sont insensibles à la casse : /CK:SAVE, /ck:save, /Ck:Save fonctionnent tous.
• Si un script se termine avec le code 1, affichez sa stdout comme message d'erreur.
• Ne modifiez jamais context.json ou CONTEXT.md directement — utilisez toujours les scripts.
• Si projects.json est mal formé, informez l'utilisateur et proposez de le réinitialiser à {}.