| name | doc-repair |
| description | Audite le vault Obsidian (PARA) : notes orphelines, frontmatter manquant, liens cassés. Génère un rapport de réparation. |
| version | 1.0.0 |
| platforms | ["linux","macos"] |
| metadata | {"hermes":{"tags":["vault","docs","audit","repair","para"],"related_skills":["note-taking","reverse-doc"],"model":"deepseek-v4-full","cron":"0 8 * * 0"}} |
doc-repair
Adaptation de doc-reset — ULK → Hermes. Carte :
docs/backlog/2026-06-28-SPEC-HERMES-DOC-REPAIR/CARD.md (P3, GitHub #263).
Audit non destructif du vault PARA : notes orphelines (aucun lien entrant), frontmatter
incomplet/manquant, Wikilinks cassés. Produit un plan de réparation, jamais une
réinitialisation. Audit-only par défaut.
Runtime & modèles
- DeepSeek V4 full : scan mécanique du vault, structuration du rapport (tier ULK haiku
→ DeepSeek full — un seul moteur, pas de sous-doseur).
- Pas de délégation coding : la skill lit des notes et écrit un rapport Markdown. Éditer
une note Markdown n'est pas du coding → reste DeepSeek. Aucune écriture de code source.
- cron : audit hebdo du vault, dimanche 08h (
0 8 * * 0).
Vault
- lecture de toutes les notes PARA + écriture du rapport
Resources/reports/doc-repair-YYYY-MM-DD.md (idempotent sur la date).
Procédure
- Lister le contenu du vault via l'outil fichier Hermes (dossiers PARA : Projects, Areas, Resources, Archives).
- Vérifier la présence des 4 dossiers PARA attendus.
- Identifier les notes sans frontmatter
title/type/status.
- Identifier les notes sans lien entrant (orphelines).
- Vérifier les Wikilinks (cibles inexistantes).
- Écrire le rapport : sections orphelines / frontmatter incomplet / liens cassés + actions correctives proposées.
Critères d'acceptation
Pièges
- Ne pas confondre « orpheline » et « note racine volontaire » (
README.md vault) — exclure les notes PARA de niveau 0.
- Ne pas réécrire le frontmatter automatiquement : proposer uniquement, laisser l'utilisateur valider.
- Un audit hebdo ne doit rien casser : politique audit-only stricte, même sous cron.
