Cette arborescence est la source documentaire versionnée du projet. Ses documents sont relus avec le code dans les issues, branches et pull requests. Le wiki GitHub présente un parcours de lecture simplifié ; il ne remplace pas les documents canoniques du dépôt.
| Besoin | Document recommandé |
|---|---|
| Découvrir le produit et ses capacités réelles | README principal |
| Suivre l'avancement de la release active | Roadmap produit mesurable |
| Utiliser l'application en français | Guide utilisateur |
| Utiliser l'application en anglais | User guide |
| Sauvegarder, restaurer ou comprendre les instantanés | Guide des sauvegardes |
| Comprendre les choix structurants | Décisions d'architecture |
Connaître la suite après 1.0.0 |
Roadmap après la v1.0 |
| Comprendre un terme | Glossaire |
- A1 — Historique, cadrage et roadmap : état du produit, arbitrages et repères chronologiques.
- A2 — Complétion méthodologique : livrables, critères de sortie et bonnes pratiques pour un projet logiciel.
- B1 — Référence technique : architecture,
ProjectDocument, stockage, GitHub, sauvegardes et limites connues. - B2 — Automatisation agent–GitHub : méthode de travail et revues des pull requests.
- C — Glossaire : vocabulaire métier et technique.
- Release, déploiement et package : différences entre version publiée, GitHub Pages et archive distribuée.
- DR-001 — Cockpit, dépôts et Project Steward.
- DR-002 — Stockage local-first et sauvegardes portables.
- DR-003 — Étapes et chantiers parallèles.
- DR-004 — Roadmap mesurable et progression effective.
- DR-005 — Lecture privée GitHub limitée à la session.
- DR-006 — Première release et évolution après la v1.0.
- DR-007 — Réconciliation sûre des projets entre instantanés.
Une décision acceptée explique son contexte, ses limites et les solutions écartées. Elle ne doit pas annoncer comme livrée une capacité seulement prévue.
- Sauvegarde autonome et transports facultatifs : historique des lots R1/S1, preuves d'implémentation et validations différées.
- Évolutions après la version 1.0 : réconciliation et transport, compréhension de projets UFI/SUMP, méthode, personnalisation et accessibilité future.
Seul le périmètre explicitement délimité dans ROADMAP.md détermine le
pourcentage de la release en cours. Les objectifs futurs restent visibles sans
diminuer artificiellement ce pourcentage.
- Release
v1.0.0: notes de première publication, fonctionnalités, fichiers distribués et limites connues. - Guide d'installation statique : intégrité SHA-256, extraction, hébergement et précautions sur les données locales.
- Contrat Dashboard–Project Steward v1.
- Conventions d'origine et d'attention humaine.
- Exemple
.project-steward.yml. - Exemples JSON machine-lisibles.
- Proposition pour
ai-project-template. - Proposition pour
ai-project-steward.
Les fichiers companion-issues/ documentent des propositions pour les dépôts
compagnons ; ils ne signifient pas qu'une modification y a déjà été appliquée.
- Historique du seed GitHub : archive des premiers scripts de création d'issues.
codex-master-plan.md: plan historique volumineux, utile pour retrouver l'intention initiale mais non canonique pour la suite.ordered-issues-workflow.md: séquence initiale des issues F0–U3 ; conservée comme historique, pas comme backlog actif.review-findings-backlog.md: observations d'audits antérieurs ; chaque élément doit être revérifié avant réutilisation.
Pour une décision actuelle, consulter prioritairement ROADMAP.md, DR-006 et
la roadmap après 1.0.0 plutôt qu'un document de travail historique.
Le wiki GitHub possède son propre dépôt Git, imposé par GitHub. Il est utilisé comme miroir utilisateur en français : accueil, démarrage, progression, chantiers, sauvegardes, thèmes/accessibilité et limites connues. Les références techniques détaillées restent liées au dépôt principal.
wiki/Home.md: accueil synthétique du wiki utilisateur.wiki/_Sidebar.md: navigation latérale du wiki.scripts/wiki/build-wiki.mjs: génération des pages depuis leurs documents canoniques et adaptation des liens relatifs..github/workflows/sync-wiki.yml: publication automatique vers le dépôt wiki séparé après modification de la documentation surmain.
Le workflow manuel Seed GitHub Issues utilise :
.github/workflows/seed-issues.yml;scripts/github/create_github_issues.ps1;scripts/github/issues.ide-projectsmanager.next-batch.json.
Lancer d'abord le workflow avec dry_run = true, contrôler le résultat, puis
utiliser dry_run = false uniquement pour le lot réellement validé.