Skip to content

DOC

Exporter docs en vault Obsidian

Transformer docs/ en vault Obsidian complète avec wikilinks, MOC et Kanban boards

Exporter docs en vault Obsidian

Contexte

Vous avez généré la documentation du projet (via Shuri, Friday, etc.) et vous voulez l’ouvrir dans Obsidian avec structure complète, wikilinks bidirectionnels, Map of Content (MOC) et tous les todos convertis en boards Kanban.

Prérequis

  • docs/ directory avec fichiers markdown (spec.md, todo.md, architecture, etc.)
  • Obsidian installé localement (client de bureau)
  • Accès Write sur docs/
  • Python 3 (optionnel, pour optimisations)

Étapes

1. Initialisation du vault Obsidian

Invquez obsidian-vault :

/ulk:obsidian-vault

ou

Créer vault Obsidian

obsidian-vault scanne docs/ et crée .obsidian/ s’il n’existe pas.

2. Scan et inventaire

obsidian-vault exécute Phase 1 :

find docs/ -type f -name "*.md" 2>/dev/null | sort
find docs/ -type d 2>/dev/null | sort

Rapport :

=== État de /docs ===

📂 Structure :
docs/
├── spec.md
├── todo.md
├── architecture/
│   ├── patterns.md
│   └── stack.md
└── guides/

📄 Fichiers .md     : 8
📁 Sous-dossiers    : 3
📋 Fichiers todo    : 2 (todo.md, guides/deployment-todo.md)
⚠️  Sans frontmatter : 2

3. Configuration Obsidian

obsidian-vault crée .obsidian/ :

ls -la docs/.obsidian/

Configuration minimale :

.obsidian/
├── app.json           (Obsidian app settings)
├── plugins.json       (Plugins enabled: kanban)
├── hotkeys.json       (Keybindings)
└── community-plugins/ (kanban-plugin)

4. Transformation des fichiers

obsidian-vault convertit chaque .md :

Avant (standard markdown) :

# Spec

See also : [](./architecture/patterns.md)

Après (Obsidian wikilinks) :

---
created: 2026-04-14
updated: 2026-04-14
tags: [architecture, reference]
---

# Spec

See also : [[patterns]]

Avantages wikilinks :

  • Graphe bidirectionnel automatique
  • Navigation click : Cmd+Click ouvre fichier lié
  • Backlinks panel : voir qui référence ce fichier

5. Conversion todos en boards Kanban

Chaque todo.md ou fichier avec sections ## Todo, ## P0, ## Backlog :

Avant :

# Backlog

## P0
- [ ] Auth setup
- [ ] Database

Après :

---
kanban-plugin: board
---

# Backlog

## P0
- [ ] Auth setup
- [ ] Database

## P1
- [ ] Dashboard

## Done

Affichage Obsidian : board Kanban interactif, drag-and-drop items entre colonnes.

6. Génération du MOC (Map of Content)

obsidian-vault crée docs/_HOME.md :

---
title: Home
created: 2026-04-14
aliases: [Index, Overview]
---

# Project Documentation

## Quick Start
- [[spec|Project Specification]]
- [[todo|Backlog & Tasks]]

## Architecture
- [[patterns|Design Patterns]]
- [[stack|Technology Stack]]

## Guides
- [[deployment|Deployment Guide]]
- [[testing|Testing Strategy]]

---

## Graph View
[All documents linked bidirectionally]

---

Last updated: 2026-04-14

MOC sert de point d’entrée central (ouvrir Obsidian = voir _HOME.md d’abord).

7. Activation et vérification

Ouvrez Obsidian et chargez le vault :

File > Open vault as folder
Select: /path/to/project/docs/

Vérifications :

✅ .obsidian/ existe et initié
✅ Wikilinks fonctionnent (Cmd+Click)
✅ Kanban boards affichent items
✅ Backlinks panel fonctionne
✅ Graph view charge tous les fichiers
✅ MOC centralise la navigation

Exemple de sortie

Rapport obsidian-vault :

=== Vault Obsidian Initialisé ===

✅ Configuration créée   : docs/.obsidian/
✅ Wikilinks convertis   : 8 fichiers
✅ Kanban boards créés   : 2 (todo.md + guides/deployment-todo.md)
✅ MOC généré            : docs/_HOME.md
✅ Frontmatter uniformisé: 8/8 fichiers

📊 Statistiques :
  Fichiers     : 8 markdown
  Wikilinks    : 24 liens bidirectionnels
  Kanban cards : 47 tasks distribuées
  Graphe       : Fully connected

💡 Prochaines étapes :
  1. Ouvrir Obsidian et charger docs/ comme vault
  2. Cliquer sur _HOME.md comme accueil
  3. Utiliser Kanban boards pour gestion sprint
  4. Consulter Graph view pour dépendances entre docs

Structure finale dans Obsidian :

docs/
├── _HOME.md              (MOC central)
├── spec.md              (with wikilinks [[pattern]], [[stack]])
├── todo.md              (kanban-plugin: board)
├── architecture/
│   ├── patterns.md
│   └── stack.md
└── .obsidian/           (configuration vault)

Variantes

  • Variante A — Preservation config existante : Si .obsidian/ existe, obsidian-vault met à jour docs sans réinitialiser.
  • Variante B — Themes & plugins : Ajouter manuellement thèmes Obsidian (ex: Dark Matter) et plugins (ex: dataview, smart typography).
  • Variante C — Sync locale : Utiliser Obsidian Sync ou Git pour garder docs/ synchronisé entre machines.
  • Variante D — Lovecraft orchestration : Utiliser lovecraft (47) en mode vault complet pour coordonner avec memory loop.

Agents enchaînés

Flux typique : shuri (01) spec+todo → obsidian-vault (39) vault setup → lovecraft (47) memory loop.

Troubleshooting

SymptômeCause probableRésolution
.obsidian/ non crééPermissions insuffisantesVérifier Write access sur docs/
Wikilinks ne se résolvent pasObsidian app pas à jourMettre à jour Obsidian (Cmd+Shift+P > Check version)
Kanban plugin absentInstallation incomplèteRelancer obsidian-vault, activer kanban manuellement dans plugins
MOC ne s’affiche pas_HOME.md not createdVérifier que docs/ avait du contenu à scaner
Graphe videAucun wikilink détectéVérifier conversion en [[fichier]] (pas [texte](path))

Voir aussi

  • agents/docs/39-obsidian-vault.md — agent complet
  • agents/orchestrators/47-lovecraft.md — orchestration docs Obsidian + memory loop
  • agents/_shared/memory-protocol.md — persistence à travers sessions
  • docs/guides/use-cases/15-friday-session-capture.md — contexte LLM avant vault