doc-repair

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

1. Lister le contenu du vault via l'outil fichier Hermes (dossiers PARA : Projects, Areas, Resources, Archives).
2. Vérifier la présence des 4 dossiers PARA attendus.
3. Identifier les notes sans frontmatter title/type/status.
4. Identifier les notes sans lien entrant (orphelines).
5. Vérifier les Wikilinks (cibles inexistantes).
6. Écrire le rapport : sections orphelines / frontmatter incomplet / liens cassés + actions correctives proposées.

Critères d'acceptation

• Rapport généré avec sections : orphelines / frontmatter incomplet / liens cassés.
• Aucune note modifiée sans confirmation explicite (audit-only par défaut).
• Test sur le vault réel avec au moins 3 anomalies détectées.
• Rapport écrit dans Resources/reports/ daté (idempotent).

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.