Funk-lab

232 commits 10 branches 0 tags 10 MiB

Author	SHA1	Message	Date
ALI YESILKAYA	a7b5c44e82	docs(rag): chunk dense « nœuds + OS » pour fermer le trou de grounding (cas Q3) (#33 ) Hermès répondait « la doc ne le précise pas » à « combien de nœuds K8s + OS » alors que talos.md § Architecture contenait l'info — mais en TABLE : nomic embed mal une table face à une question en langage naturel (pas de « 3 »/« trois », OS implicite), donc le chunk ne remontait pas dans le top-k. Fix = phrase en prose dense en tête de la section (compte explicite + OS + rôles + les 2 hôtes AlmaLinux hors cluster). Le chunk passe #1 (score 0.743 vs ~0.69 avant). Validé après re-ingest : - « combien de nœuds K8s + OS » → « 3 nœuds, tous sous Talos Linux v1.13.0 » (docs=6) - « combien de machines + OS » → réponse nuancée (3 Talos + 2 AlmaLinux hors cluster) Leçon RAG : préfixer toute table dense d'une phrase en prose pour l'ancrage des questions naturelles « combien / quel ». Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-20 21:41:13 +02:00
alkatrazz	5bcf95b82e	docs: réorganisation complète de admin/ en 4 domaines thématiques Structure avant : 20 fichiers à plat dans admin/ — difficile à naviguer. Structure après : 4 sous-répertoires thématiques + index clair. Réorganisation : admin/ops/ → cluster.md, ansible.md, systeme.md admin/infra/ → reseau.md, nfs.md, dnsmasq.md, ssh.md admin/k8s/ → talos.md, argocd.md, monitoring.md admin/ia/ → llama_server.md, rocm.md, litellm.md, hermes.md Suppressions : - ask-agent.md : contenu fusionné dans ia/hermes.md (section ask-agent) - lm_studio.md : obsolète (LM Studio remplacé par llama-server) Mises à jour contenu : - ia/hermes.md : fusion complète avec ask-agent.md (profils, skills, SOUL.md, ask-agent CLI, dépannage) — doc unifiée sans redondance - ops/cluster.md : section GitOps réduite à 2 lignes + lien argocd.md - incidents.md : tableau de résumé en tête + 4 nouveaux incidents (Grafana OOMKilled, AlertManager null receiver, llama-server 501, nftables règle après drop) - README.md : réécrit — navigation rapide + index par domaine Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-14 00:47:58 +02:00

Author

SHA1

Message

Date

ALI YESILKAYA

a7b5c44e82

docs(rag): chunk dense « nœuds + OS » pour fermer le trou de grounding (cas Q3) (#33 )

Hermès répondait « la doc ne le précise pas » à « combien de nœuds K8s + OS »
alors que talos.md § Architecture contenait l'info — mais en TABLE : nomic embed
mal une table face à une question en langage naturel (pas de « 3 »/« trois », OS
implicite), donc le chunk ne remontait pas dans le top-k.

Fix = phrase en prose dense en tête de la section (compte explicite + OS + rôles +
les 2 hôtes AlmaLinux hors cluster). Le chunk passe #1 (score 0.743 vs ~0.69 avant).

Validé après re-ingest :
- « combien de nœuds K8s + OS » → « 3 nœuds, tous sous Talos Linux v1.13.0 » (docs=6)
- « combien de machines + OS » → réponse nuancée (3 Talos + 2 AlmaLinux hors cluster)

Leçon RAG : préfixer toute table dense d'une phrase en prose pour l'ancrage des
questions naturelles « combien / quel ».

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-20 21:41:13 +02:00

alkatrazz

5bcf95b82e

docs: réorganisation complète de admin/ en 4 domaines thématiques

Structure avant : 20 fichiers à plat dans admin/ — difficile à naviguer.
Structure après : 4 sous-répertoires thématiques + index clair.

Réorganisation :
  admin/ops/    → cluster.md, ansible.md, systeme.md
  admin/infra/  → reseau.md, nfs.md, dnsmasq.md, ssh.md
  admin/k8s/    → talos.md, argocd.md, monitoring.md
  admin/ia/     → llama_server.md, rocm.md, litellm.md, hermes.md

Suppressions :
  - ask-agent.md : contenu fusionné dans ia/hermes.md (section ask-agent)
  - lm_studio.md : obsolète (LM Studio remplacé par llama-server)

Mises à jour contenu :
  - ia/hermes.md : fusion complète avec ask-agent.md (profils, skills,
    SOUL.md, ask-agent CLI, dépannage) — doc unifiée sans redondance
  - ops/cluster.md : section GitOps réduite à 2 lignes + lien argocd.md
  - incidents.md : tableau de résumé en tête + 4 nouveaux incidents
    (Grafana OOMKilled, AlertManager null receiver, llama-server 501,
    nftables règle après drop)
  - README.md : réécrit — navigation rapide + index par domaine

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-14 00:47:58 +02:00

Renamed from admin/talos.md (Browse further)

2 commits