VESICA
IQDJC_IQ_2_1Brouillon

DJC_IQ_2_1 — Créer ou réviser un document du manuel

Instruction· Juridique & Conformité· émetteur VESICA DJC_PRO_2

DJC_IQ_2_1 — Créer ou réviser un document du manuel

Objet (la tâche précise)

Produire ou modifier un document de la pyramide documentaire de façon conforme : bon niveau, bon gabarit, codification unique, front-matter complet, provenance balisée, versioning tenu. C'est le geste de maîtrise documentaire appliqué fichier par fichier. [CORPUS]

Prérequis / matériel / sécurité

  • _MANUEL/_GABARITS.md (plan par niveau) sous les yeux. [CORPUS]
  • Le _REGISTRE.md pour vérifier l'unicité du code et les renvois. [CORPUS]
  • Le contenu métier validé par la Direction propriétaire (DJC ne rédige pas une procédure gaz sans DEX). [STANDARD]
  • Garde : patch chirurgical — sur un document existant, modifier le strict nécessaire, jamais réécrire l'ensemble. [CORPUS] (CLAUDE.md)

Étapes d'exécution

  1. Déterminer le niveau et le type : Processus (PRO) / Procédure (PQ) / Instruction (IQ) / Formulaire (FQ). [CORPUS]
  2. Attribuer le code DIR_<TYPE>_n : n local au processus, cohérent avec le DIR_PRO_n parent (PQ_n / IQ_n / FQ_n alignés). Vérifier l'unicité au registre. [CORPUS]
  3. Renseigner le front-matter complet (cf. gabarit) : code, type_artefact, direction, process, nom, emetteur: VESICA, statut: brouillon, vigueur, scope, references (pour PQ), maj. [CORPUS]
  4. Suivre le plan du niveau (sections imposées de _GABARITS.md) — ne pas inventer de sections hors gabarit. [CORPUS]
  5. Baliser la provenance de chaque affirmation non triviale : [CORPUS] / [STANDARD] / [À CONFIRMER] / [À COMPLÉTER]. [CORPUS]
  6. Vérifier les renvois croisés : UC-* (Recueil), ADR-* (03), M0-M4, autres DIR_* — pointer du réel, pas du fictif. [STANDARD]
  7. Versioning : si création → version initiale ; si révision → bumper version + maj. [CORPUS]
  8. Contrôle de pile : si on crée un PRO, vérifier que sa PQ et au moins une IQ sont prévues (sinon les lister en ## Roadmap). [CORPUS] (ADR-043)
  9. Slug de fichier : minuscules, sans accents (ex. djc_iq_2_1_creer_reviser_document_manuel.md). [CORPUS]
  10. Soumettre à approbation dirigeant avant statut: validé + inscription registre.

Règles, critères et seuils [= embryon du CATALOGUE]

  • Codification DIR_<TYPE>_n unique dans tout le manuel ; collision interdite. (source_ref: ADR-043 codification SMQ Bouygues adaptée) [CORPUS]
  • PQ_n / IQ_n / FQ_n doivent référencer le même DIR_PRO_n parent (cohérence de pile). (source_ref: _README.md conventions) [CORPUS]
  • Front-matter complet obligatoire ; un champ manquant = document non conforme, non inscriptible au registre. (source_ref: _GABARITS.md front-matter commun) [CORPUS]
  • Toute affirmation non triviale balisée par sa provenance ; une affirmation non balisée est traitée comme [À CONFIRMER]. (source_ref: _README.md conventions de provenance) [CORPUS]
  • Modification d'un document existant = patch chirurgical + bump version/maj ; réécriture complète réservée à une refonte assumée. (source_ref: CLAUDE.md « patch, jamais réécriture ») [CORPUS]
  • Slug minuscules sans accents ; le fichier ne contient qu'un seul document (1 artefact = 1 .md). (source_ref: instructions de rangement + 08 §7) [CORPUS]
  • Discipline de build : pas de livraison d'agent/workflow sans pile PRO→PQ→IQ (PQ minimale admise renvoyant aux textes). (source_ref: ADR-043 règle d'or) [CORPUS]

Points de contrôle / cas particuliers

  • Document SYS (technique, déjà construit) : manuel léger — fiche processus + renvoi aux workflows/ADR existants ; peu de PQ/IQ. Ne pas sur-documenter ce qui est déjà spécifié dans 02/07. [CORPUS]
  • Processus multi-Directions : si la Direction courante en est propriétaire → le rédiger + noter les co-intervenantes ; sinon → le mentionner en interface, ne pas le rédiger. [CORPUS]
  • Trou réel de contenu (info externe manquante) → [À COMPLÉTER] explicite + entrée dans _FEUILLE_DE_ROUTE.md, ne pas inventer de fait opposable. [CORPUS]
  • Renvoi plutôt que recopie : pour les normes/textes, citer la référence (PQ §Références) plutôt que recopier — léger par conception. [CORPUS]

Sortie / enregistrement produit

Un document .md conforme (front-matter + gabarit + provenance + code unique), prêt pour approbation, puis inscrit au _REGISTRE.md et ingéré au RAG. [CORPUS]

Agent responsable

Claude Code (bras droit, exécutant de la rédaction sur instruction dirigeant) ; à terme, Agent Documentaliste/Qualité pour les contrôles d'intégrité automatisés. Approbation finale = dirigeant. [CORPUS]