grzadr/agent-skills

Compétence Plan d'Apprentissage

Lorsqu'on vous demande de concevoir ou d'initialiser un projet d'apprentissage, générez un fichier ROADMAP.md structuré dans la racine du workspace. N'écrivez AUCUN code applicatif ou d'implémentation.

Principes de conception fondamentaux

1. Micro-Sprints (Rythme dopaminergique) : Chaque étape doit pouvoir être réalisée en 15 à 30 minutes de codage concentré. Si une fonctionnalité prend plus de temps, divisez-la en sous-étapes.
2. Tranches verticales plutôt que couches horizontales : Ne créez jamais d'étape comme « Écrire tous les modèles de données » suivie de « Écrire toutes les requêtes de base de données ». Au lieu de cela, l'étape 1.1 doit prendre une seule entrée et produire immédiatement une sortie visible et testable.
3. Agnosticisme linguistique : Formulez les spécifications autour du comportement observable (entrées, sorties, changements d'état, codes de sortie, valeurs de retour ou réponses API) plutôt que du code standard propre à un langage.

Protocole

1. Clarifier le contexte minimal (Uniquement si manquant)

Si l'utilisateur n'a pas spécifié :

• Projet cible (ex. : Application ToDo, client BitTorrent, Key-Value store, serveur HTTP)
• Langage / Runtime cible (ex. : Go, Rust, Python, TypeScript, C, Zig)
• Type d'interface (ex. : CLI, API HTTP, TUI, Bibliothèque)

Posez au maximum 2 questions brèves pour verrouiller ces éléments avant de générer ROADMAP.md.

2. Générer ROADMAP.md

Créez ROADMAP.md en utilisant la structure suivante :

• Aperçu du projet : Un résumé de 2 phrases décrivant ce qui est construit et les concepts de langage que l'apprenant mettra en pratique (ex. : gestion de la mémoire, concurrence, structures/interfaces, E/S asynchrones, gestion des erreurs).
• Suivi de progression :
  • Pointeur de l'étape active (ex. : Étape active : Étape 1 - Sous-étape 1.1)
  • Légende des statuts : [ ] Bloqué/En attente, [~] En cours, [x] Réussi
• Étapes (4 à 6 étapes au total) :
  • Étape 1 : Le Battement de cœur (Squelette fonctionnel) : Obtenir la commande ou la fonction de bout en bout la plus simple possible.
  • Étape 2 : État de base et chemin heureux : Implémenter les structures de données primaires et les opérations de base en mémoire.
  • Étape 3 : Persistance / E/S et cas limites : Sauvegarder l'état, analyser des entrées complexes et gérer les erreurs avec élégance.
  • Étape 4 : Fonctionnalités avancées du langage : Introduire la concurrence, le streaming, le middleware ou l'optimisation des performances.
• Sous-étapes (2 à 4 sous-étapes par étape) : Pour chaque sous-étape, inclure :
  • Objectif : Une phrase décrivant ce que l'utilisateur va construire.
  • Concepts de langage pratiqués : 2 à 3 fonctionnalités linguistiques spécifiques nécessaires pour cette étape.
  • Spécification et critères d'acceptation : Comportements concrets et testables en boîte noire (signatures de fonctions exactes, arguments CLI, sortie standard/erreur attendue, ou statut/payloads HTTP) que craft-gatekeeper utilisera pour écrire des tests automatisés.

Garde-fous

• NE JAMAIS générer de fichiers de code source ou d'extraits de solution lors de l'exécution de cette compétence.
• Terminez votre réponse en dirigeant l'utilisateur vers l'étape 1, sous-étape 1.1 et en suggérant d'exécuter /craft-bootstrap (pour configurer le squelette de projet vide) ou /craft-gatekeeper (pour générer le premier test échouant).