Guides Playlab42#
Une idée, un premier outil, un jeu à construire : choisissez le guide qui correspond à votre prochaine étape. Les exemples et contrats techniques restent dans leurs guides de référence, sans copie à maintenir.
Lire dans le laboratoire#
Depuis le portail, ouvrez Les guides : les documents sont présentés dans un lecteur HTML avec un plan, des liens de section et les thèmes du laboratoire. Les liens entre documents restent dans ce lecteur. Le lien Lire la source Markdown permet de retrouver chaque fichier canonique.
Le site est généré dans docs/site/, sans backend, CDN ou iframe :
# Dans le worktree, via le conteneur de développement
make build-guides
make serve
make build-guides exécute node scripts/build-guides.js dans Docker.
Ne modifiez pas les pages générées : éditez les Markdown sous docs/, puis
régénérez. Un fichier Markdown hors de docs/ est signalé comme source
Markdown, et non présenté comme une page du lecteur.
Prendre ses repères#
- Architecture : comprendre les composants et leurs limites.
- Premiers pas : préparer l'environnement Docker.
- Contribuer : connaître le workflow et les vérifications.
- L'usine logicielle : comprendre la chaîne de livraison et les points restant à améliorer.
Créer une contribution#
| Guide | Description | Niveau |
|---|---|---|
| Kit de contribution | Gabarits, composants partagés et galerie UI | Tous |
| Créer un outil | Créer un outil HTML standalone | Débutant |
| Créer un parcours | Organiser des slides pédagogiques en Epic | Débutant |
| Créer un moteur de jeu | Créer un moteur isomorphe | Intermédiaire |
| Créer un client de jeu | Créer une interface de jeu | Intermédiaire |
| Créer un bot | Créer une IA pour un jeu | Avancé |
Vérifier et travailler avec l'IA#
- Qualité logicielle : conception, lint, sécurité, tests et revue, avec un plan progressif.
- Stratégie de tests : choisir les preuves adaptées.
- Skills du projet : utiliser les assistants avec les mêmes conventions.
- Workflow OpenSpec : clarifier et suivre un changement.
- Données locales : comprendre la persistance navigateur.
- Bibliothèques runtime : utiliser les distributions locales.
Par où commencer ?#
- Lisez d'abord le guide Architecture pour comprendre la structure du projet
- Débutants : Commencez par Créer un outil - c'est le plus simple
- Intermédiaires : Enchaînez avec Créer un moteur puis Créer un client
- Avancés : Terminez avec Créer un bot
Prérequis#
- Connaissances de base en HTML, CSS, JavaScript
- Docker installé sur votre machine
- Un éditeur de code (VS Code recommandé)
Environnement de développement#
Toutes les commandes se font via Docker :
# Initialiser l'environnement
make init
# Lancer le serveur de développement
make serve
# Accéder au shell du container
make shell
Conventions#
- Commentaires : En français
- Commits : En français
- Nommage fichiers : kebab-case (
mon-outil.html) - Nommage variables : camelCase (
maVariable) - Nommage types : PascalCase (
MonType)