Schéma du wiki

Ce fichier est le contrat. Le plugin kwikines le lit à chaque opération et l'injecte dans les prompts du modèle qui rédige les pages. Modifie-le : c'est ainsi qu'on change la façon dont le wiki est écrit — pas en modifiant le code.

Structure

<base>/
├── AGENTS.md          # ce fichier — le schéma
├── raw/               # sources brutes, IMMUABLES
└── wiki/
    ├── index.md       # catalogue : une ligne par page
    ├── log.md         # journal chronologique (append-only)
    ├── sources/       # une page par document ingéré
    ├── entities/      # une page par personne, lieu, organisation, produit
    ├── concepts/      # une page par notion, thème, méthode
    └── analyses/      # réponses de valeur durable, classées après coup

raw/ ne se modifie jamais, à une exception près : la conversion d'un .docx ou d'un .pdf y dépose le .md correspondant, à côté de l'original.

Règles de rédaction

Un sujet = une page. Si deux pages parlent du même sujet, elles fusionnent.
Fusionner, jamais écraser. Une page existante est renvoyée entière, enrichie des faits nouveaux. On ne supprime pas ce qui y était.
Tout fait est cité par un wikilink vers la page source dont il vient.
Ne rien inventer. Ce que la source ne dit pas ne s'écrit pas. Une incertitude s'écrit comme une incertitude.
Les contradictions se signalent, elles ne s'arbitrent pas. Une section ## Contradictions dans la page, et une ligne dans le journal.
Densité. Une page est une synthèse, pas une copie de la source ; la source reste dans raw/ pour qui veut le détail.

Frontmatter

Bloc YAML délimité par ---, en tête de chaque page. Listes en style flow, sur une seule ligne (tags: [x, y], jamais tags: puis des tirets) — c'est la seule forme qui ne casse pas le parseur.

Wikilinks

[[entities/marie-curie]] ou [[marie-curie]] — les deux fonctionnent, le dernier segment fait foi. Un lien vers une page absente est signalé comme lien cassé par kwikines_lint : soit on crée la page, soit on retire le lien.

Slugs en kebab-case, sans accent ni majuscule : theoreme-de-bayes.

Squelette d'une page

Une page de sources/ porte en plus le nom du fichier d'origine dans raw/, et un résumé de ce que le document apporte au wiki.

index.md et log.md

index.md : - [[categorie/slug]] — résumé d'une ligne, sous la rubrique de sa catégorie. Le plugin maintient ces lignes.
log.md : ## [AAAA-MM-JJ] type | sujet suivi de puces. Append-only : on ajoute, on ne réécrit pas.

Structure

<base>/
├── AGENTS.md          # ce fichier — le schéma
├── raw/               # sources brutes, IMMUABLES
└── wiki/
    ├── index.md       # catalogue : une ligne par page
    ├── log.md         # journal chronologique (append-only)
    ├── sources/       # une page par document ingéré
    ├── entities/      # une page par personne, lieu, organisation, produit
    ├── concepts/      # une page par notion, thème, méthode
    └── analyses/      # réponses de valeur durable, classées après coup

raw/ ne se modifie jamais, à une exception près : la conversion d'un .docx ou d'un .pdf y dépose le .md correspondant, à côté de l'original.

Règles de rédaction

Un sujet = une page. Si deux pages parlent du même sujet, elles fusionnent.

Fusionner, jamais écraser. Une page existante est renvoyée entière, enrichie des faits nouveaux. On ne supprime pas ce qui y était.

Tout fait est cité par un wikilink vers la page source dont il vient.

Ne rien inventer. Ce que la source ne dit pas ne s'écrit pas. Une incertitude s'écrit comme une incertitude.

Les contradictions se signalent, elles ne s'arbitrent pas. Une section ## Contradictions dans la page, et une ligne dans le journal.

Densité. Une page est une synthèse, pas une copie de la source ; la source reste dans raw/ pour qui veut le détail.