docs(plan): from the basics to an intermediate level, with a delivery checklist

[thierryvm]

Summary

On 1 October 2026, @Thierry decided what Terminal Learning should become: the reference for learning the terminal, from zero up to an intermediate level, within the limits of what a faithful simulation can do.

• Job-specific tools are not simulated: offensive security, network analysis and OSINT.
• For those, the site points learners to the free platforms that already teach them.

This PR writes that plan down and adds the procedure that keeps each delivery complete.

• docs/strategy/2026-10-01-bases-vers-intermediaire.md (FR): the rationale, what is in and out of scope, and the reference shells (Git Bash, PowerShell 7 en-US, Ubuntu under WSL 2). It orders the work into lots 0 to 9, about 15 to 20 PRs for the core, and lists what has to change with every lot.
• docs/processes/curriculum-delivery-checklist.md (FR): a checklist in four stages (before, during, before the PR, after the PR) for any new command, lesson or module. It lists every place a public counter lives:
  • landingContent.ts;
  • index.html metadata and FAQ JSON-LD;
  • llms.txt and llms-full.txt;
  • README, CLAUDE.md, ARCHITECTURE and the exports README.
• ROADMAP: a new Phase 5d with all the lots. Phase 5c is reframed, since editors and scripting move into 5d. Phase 11b career branches are on hold, replaced by a "What next?" orientation page.
• plan.md: the same Phase 5d, in French.
• CLAUDE.md: a Phase 5d line, and a pointer to the checklist after every engine or curriculum change.
• release-sync-checklist: links to the new checklist and notes the counters in llms*.txt and index.html.

Docs only: 6 files and no runtime file, so this is Voie C with a smoke test of the preview. docLessonCount and landingTotals pass locally, since CLAUDE.md is one of the files they guard.

🤖 Generated with Claude Code

Résumé par Sourcery

Établir la stratégie du programme d’apprentissage pour débutants à intermédiaires et standardiser le processus de mise à disposition des futurs contenus d’apprentissage du terminal.

Nouvelles fonctionnalités :

• Documenter la feuille de route pour faire évoluer l’apprentissage du terminal des fondamentaux pour débutants vers un niveau intermédiaire, tout en préservant une simulation fidèle du shell et en orientant l’apprentissage spécifique aux métiers vers des laboratoires externes.
• Ajouter une liste de contrôle en quatre étapes pour la mise à disposition du programme, couvrant la validation, la documentation, les compteurs publics, la revue, la prévisualisation et la vérification en production.

Améliorations :

• Repenser les phases de la feuille de route afin d’intégrer les éditeurs et les scripts au nouveau programme intermédiaire, et mettre en attente les parcours professionnels au profit de recommandations d’apprentissage externes.
• Mettre à jour la planification du projet et les processus de publication afin de faire référence au nouveau périmètre du programme et à la liste de contrôle de mise à disposition.

Documentation :

• Ajouter le document de stratégie en français définissant le périmètre du programme, les lots d’implémentation, les dépendances, les shells de référence et les exigences de synchronisation pour chaque lot.
• Ajouter la liste de contrôle du processus de mise à disposition du programme en français et y faire référence depuis les consignes de synchronisation des publications.

Original summary in English

Summary by Sourcery

Establish the beginner-to-intermediate curriculum strategy and standardize the delivery process for future terminal learning content.

New Features:

• Document the roadmap for expanding Terminal Learning from beginner fundamentals to an intermediate level while preserving faithful shell simulation and directing job-specific learning to external labs.
• Add a four-stage curriculum delivery checklist covering validation, documentation, public counters, review, preview, and production verification.

Enhancements:

• Reframe roadmap phases to move editors and scripting into the new intermediate curriculum and place career branches on hold in favor of external learning guidance.
• Update project planning and release processes to reference the new curriculum scope and delivery checklist.

Documentation:

• Add the French strategy document defining the curriculum scope, implementation lots, dependencies, reference shells, and per-lot synchronization requirements.
• Add the French curriculum delivery process checklist and link it from the release synchronization guidance.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
terminal-learning	Ready	Preview	Oct 1, 2026 9:22pm UTC

[sourcery-ai]

Sorry @thierryvm, you've used your own review budget of 250,000 diff characters for the last 7 days.

You can request another review in 1 day and 22 hours by commenting @sourcery-ai review. Upgrade to get a review now.

[sourcery-ai]

Guide du réviseur

Cette PR, qui porte uniquement sur la documentation, établit la Phase 5d comme feuille de route pour passer des fondamentaux du terminal à un niveau intermédiaire, définit ses limites de fidélité et de portée pour les shells de référence, et introduit une checklist en quatre étapes afin de maintenir la synchronisation du programme, du simulateur, des compteurs publics, de la documentation, de la validation et de la vérification de mise en production pour chaque livraison.

Diagramme de flux de la mise en œuvre du programme de la Phase 5d

flowchart LR
    A[Plan a focused lot] --> B[Capture real shell outputs]
    B --> C[Implement curriculum and simulator changes]
    C --> D[Sync reference pages and public counters]
    D --> E[Run validation and fidelity audits]
    E --> F[Review PR and verify preview]
    F --> G[Verify production and record remaining debt]

Loading

Diagramme de flux des lots d’apprentissage de la Phase 5d

flowchart LR
    L1[Lots 1-3: search, archives, sed and awk] --> L4[Lot 4: investigate fictional logs]
    L1 --> L6[Lot 6: scripting]
    L6 --> L7[Lot 7: Linux system tools]
    L4 --> L8[Lot 8: final mission]
    L6 --> L8
    L8 --> L9[Lot 9: customise terminal and What next?]

Loading

Modifications au niveau des fichiers

Modification	Détails	Fichiers
Documenter l’orientation du produit et la portée du passage des bases du terminal à un niveau intermédiaire.	Définir le programme inclus en fonction de la fidélité et exclure explicitement les outils spécifiques à certains métiers, les réseaux réels, l’exploitation et l’OSINT. Établir Git Bash, PowerShell 7 en-US et Ubuntu sur WSL 2 comme références de sortie, en documentant les différences de macOS plutôt qu’en les inventant. Organiser les lots 0 à 9, notamment la recherche et le traitement de texte, les archives, le scripting, les éditeurs, les outils système, une mission finale et une orientation vers l’apprentissage externe.	docs/strategy/2026-10-01-bases-vers-intermediaire.md docs/ROADMAP.md docs/plan.md CLAUDE.md
Ajouter un processus de livraison standardisé pour les modifications du programme et du simulateur.	Exiger la capture de sorties réelles des shells, la gestion inter-environnements, les tests des commandes et des leçons, la mise à jour des pages de référence et un traitement honnête des options non prises en charge. Énumérer les points de synchronisation pour les compteurs publics, les métadonnées SEO, les fichiers LLM, la documentation du projet, le changelog, la story, la feuille de route et le plan. Définir la validation avant PR, les audits de fidélité et spécialisés, les smoke tests de prévisualisation et de production, les vérifications responsive et la vérification après fusion.	docs/processes/curriculum-delivery-checklist.md docs/processes/release-sync-checklist.md CLAUDE.md
Aligner la feuille de route et les directives du projet sur la nouvelle stratégie de la Phase 5d et ses dépendances de livraison.	Ajouter la Phase 5d et les jalons des lots 0/0b à 9 dans les documents de planification anglais et français. Recentrer la Phase 5c afin de déplacer les éditeurs et le scripting vers la Phase 5d, tout en excluant Docker, la sécurité et l’administration des serveurs de la simulation. Mettre en pause les branches de carrière de la Phase 11b au profit d’une page « What next? » du lot 9 orientant les apprenants vers des laboratoires externes.	docs/ROADMAP.md docs/plan.md CLAUDE.md

---

Conseils et commandes

Interagir avec Sourcery

• Déclencher une nouvelle revue : commentez @sourcery-ai review sur la pull request.
• Poursuivre les discussions : répondez directement aux commentaires de revue de Sourcery.
• Générer une issue GitHub à partir d’un commentaire de revue : demandez à Sourcery de créer une issue à partir d’un commentaire de revue en y répondant. Vous pouvez également répondre à un commentaire de revue avec @sourcery-ai issue pour créer une issue à partir de celui-ci.
• Générer un titre de pull request : écrivez @sourcery-ai n’importe où dans le titre de la pull request pour générer un titre à tout moment. Vous pouvez également commenter @sourcery-ai title sur la pull request pour générer ou régénérer le titre à tout moment.
• Générer un résumé de pull request : écrivez @sourcery-ai summary n’importe où dans le corps de la pull request pour générer un résumé de PR à tout moment, exactement à l’endroit souhaité. Vous pouvez également commenter @sourcery-ai summary sur la pull request pour générer ou régénérer le résumé à tout moment.
• Générer le guide du réviseur : commentez @sourcery-ai guide sur la pull request pour générer ou régénérer le guide du réviseur à tout moment.
• Résoudre tous les commentaires de Sourcery : commentez @sourcery-ai resolve sur la pull request pour résoudre tous les commentaires de Sourcery. Utile si vous avez déjà traité tous les commentaires et ne souhaitez plus les voir.
• Ignorer toutes les revues de Sourcery : commentez @sourcery-ai dismiss sur la pull request pour ignorer toutes les revues de Sourcery existantes. Particulièrement utile si vous souhaitez repartir de zéro avec une nouvelle revue — n’oubliez pas de commenter @sourcery-ai review pour déclencher une nouvelle revue !

Personnaliser votre expérience

Accédez à votre tableau de bord pour :

• Activer ou désactiver les fonctionnalités de revue, telles que le résumé de pull request généré par Sourcery, le guide du réviseur, etc.
• Modifier la langue de revue.
• Ajouter, supprimer ou modifier les instructions de revue personnalisées.
• Ajuster les autres paramètres de revue.

Obtenir de l’aide

• Contactez notre équipe d’assistance pour toute question ou remarque.
• Consultez notre documentation pour obtenir des guides et des informations détaillés.
• Restez en contact avec l’équipe Sourcery en nous suivant sur X/Twitter, LinkedIn ou GitHub.

Original review guide in English

Reviewer's Guide

This documentation-only PR establishes Phase 5d as the roadmap from terminal fundamentals to an intermediate level, defines its fidelity and scope boundaries across reference shells, and introduces a four-stage checklist to keep curriculum, simulator, public counters, documentation, validation, and release verification synchronized for every delivery.

Flow diagram for Phase 5d curriculum delivery

flowchart LR
    A[Plan a focused lot] --> B[Capture real shell outputs]
    B --> C[Implement curriculum and simulator changes]
    C --> D[Sync reference pages and public counters]
    D --> E[Run validation and fidelity audits]
    E --> F[Review PR and verify preview]
    F --> G[Verify production and record remaining debt]

Loading

Flow diagram for Phase 5d learning lots

flowchart LR
    L1[Lots 1-3: search, archives, sed and awk] --> L4[Lot 4: investigate fictional logs]
    L1 --> L6[Lot 6: scripting]
    L6 --> L7[Lot 7: Linux system tools]
    L4 --> L8[Lot 8: final mission]
    L6 --> L8
    L8 --> L9[Lot 9: customise terminal and What next?]

Loading

File-Level Changes

Change	Details	Files
Document the product direction and scope for progressing learners from terminal basics to an intermediate level.	Define the fidelity-based in-scope curriculum and explicitly exclude job-specific tools, real networking, exploitation, and OSINT. Establish Git Bash, PowerShell 7 en-US, and Ubuntu on WSL 2 as output references, with macOS differences documented rather than invented. Sequence Lots 0–9, including search and text processing, archives, scripting, editors, system tools, a final mission, and external-learning orientation.	docs/strategy/2026-10-01-bases-vers-intermediaire.md docs/ROADMAP.md docs/plan.md CLAUDE.md
Add a standardized delivery process for curriculum and simulator changes.	Require real-shell output captures, cross-environment handling, command and lesson tests, reference-page updates, and honest treatment of unsupported options. Enumerate synchronization points for public counters, SEO metadata, LLM files, project documentation, changelog, story, roadmap, and plan. Define pre-PR validation, fidelity and specialist audits, preview/production smoke tests, responsive checks, and post-merge verification.	docs/processes/curriculum-delivery-checklist.md docs/processes/release-sync-checklist.md CLAUDE.md
Align roadmap and project guidance with the new Phase 5d strategy and its delivery dependencies.	Add Phase 5d and Lot 0/0b through Lot 9 milestones to the English and French planning documents. Reframe Phase 5c to move editors and scripting into Phase 5d while excluding Docker, security, and server administration from simulation. Put Phase 11b career branches on hold in favor of a Lot 9 “What next?” page directing learners to external labs.	docs/ROADMAP.md docs/plan.md CLAUDE.md

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.