pax-k/build-right

Compétences agnostiques pour transformer une idée d'application floue en exécution AI fondée sur des preuves.

Qu'est-ce que build-right ?

Ce skill « Build Right Execution » est conçu pour être utilisé après la phase de pré-exécution, une fois que la vérité produit, le périmètre MVP, les règles de fonctionnement et une file de tâches exécutables ont été établis. Il fournit un processus structuré en 18 étapes qui guide un agent AI (Claude Code, Cursor, Codex, etc.) à travers l'exécution d'une tâche à la fois, en insistant sur la collecte de preuves, la vérification en couches et la mise à jour rigoureuse du suivi. Le cœur du skill repose sur des vérifications d'état, des helpers d'exécution et des contrats de preuves pour garantir que chaque changement est justifié, réversible et documenté. Il impose la lecture de documents de référence (workflow, gates, contrats) avant chaque action, et inclut des règles pour éviter l'élargissement silencieux du périmètre et pour gérer les dépendances externes. Une règle « Not-Ready » empêche l'exécution si les prérequis ne sont pas en place, et un badge d'état visuel (DONE, ALL GREEN, NEEDS INPUT, etc.) termine chaque réponse. Le skill est agnostique vis-à-vis de l'agent et centralise le processus de décision via des scripts exécutés avec Bun, minimisant les risques d'erreur et assurant une traçabilité complète.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add pax-k/build-right

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Exécution Build Right

Utilisez ce skill après que le travail de pré-exécution a produit la vérité produit, le périmètre MVP, les règles de fonctionnement et une file de tâches exécutables.

Règle fondamentale :

Faire une tâche.
Prouver l'état actuel.
Modifier de manière ciblée.
Vérifier avec les bonnes preuves.
Mettre à jour le suivi.
Puis passer à la tâche suivante.

Lectures obligatoires

  • Lisez toujours references/workflow.md avant d'agir.
  • Lisez references/gates.md avant la sélection de tâche, après la prise en charge d'une tâche, et avant de passer à une autre tâche.
  • Lisez references/review-and-delegation.md uniquement lorsque les déclencheurs de revue s'appliquent, qu'une revue par sous-agent est utile, ou que des modifications importantes de preuves/suivi sont touchées.
  • Lisez references/evidence-contract.md avant de terminer ou de mettre à jour une tâche.
  • Lisez ../build-right-engineering-principles/references/principles.md avant la mise en œuvre ou la revue lorsqu'une tâche touche aux limites architecturales, aux API publiques, à la propriété des packages, aux adaptateurs de fournisseurs, au code généré, à la sémantique des erreurs, aux tests, à l'observabilité, à la sécurité ou à une politique exécutoire.
  • Utilisez assets/templates/task-template.md lors de la création d'une tâche manquante ou du fractionnement d'une tâche trop large.
  • Utilisez les scripts d'aide fournis uniquement via la forme complète de commande Bun indiquée ci-dessous. Ne vous fiez pas aux alias PATH et n'invoquez pas de noms courts tels que continue-check en tant que commandes shell.
  • Utilisez le résolveur d'état avant de sélectionner une tâche ou de progresser dans une file d'attente. Rapportez et réconciliez sa décision avant de continuer.
  • Utilisez l'helper d'exécution pour les signaux déterministes de tâche, de contrat et de gate. Considérez la sortie du script comme une entrée pour le jugement, pas comme une autorité absolue.

Mode opératoire

  1. Exécutez le résolveur d'état en lecture seule lorsqu'il est disponible :

    bun <skill-path>/scripts/continue-check.ts --cwd <project> --format markdown --strict
    
  2. Rapportez les résultats du résolveur avant de sélectionner le travail :

    Décision du résolveur : <décision>
    Confiance : <confiance>
    Action suivante : <action suivante>
    Tâche suivante : <tâche ou aucune>
    Gates bloquants : <gates ou aucun>
    Suivis externes : <suivis ou aucun>
    
  3. Suivez la décision du résolveur avant de sélectionner le travail :

    • ask-founder : demandez ou signalez le gate appartenant au fondateur ; ne continuez pas.
    • wait-external : signalez le gate d'état externe ; ne continuez pas.
    • create-blocker : créez ou proposez le plus petit bloqueur appartenant à l'IA.
    • no-ready-task : arrêtez-vous et signalez qu'aucune tâche appartenant à l'IA n'est prête.
    • invalid-state : arrêtez-vous et réconciliez l'état contradictoire du suivi/gate.
    • continue-active-task ou execute-task : sélectionnez exactement cette tâche.
  4. Exécutez l'helper d'exécution en lecture seule lorsqu'il est disponible :

    bun <skill-path>/scripts/execution-check.ts --cwd <project> --mode next-task --format markdown
    
  5. Lisez la tâche, le suivi sprint/milestone, les documents d'autorité et les instructions locales de l'agent.

  6. Affichez la prise en charge de la tâche :

    Tâche active : <id ou chemin de tâche>
    Terminé signifie : <critères de complétion observables>
    Non-objectifs : <exclusions explicites>
    Base de l'hypothèse : <claim-du-fondateur | inféré-par-IA | hypothèse-de-prototype | basé-sur-preuves-dépôt | basé-sur-preuves-publiques | basé-sur-preuves-client>
    Réversibilité : <facile | modérée | difficile>
    Accroche d'apprentissage : <comment cette tâche produira des preuves>
    Source sous test : <chemin-local-dépôt | chemin-installé | source-GitHub | tag-de-version | n/a>
    Preuve de base : <artefact ou commande>
    Échelle de vérification : <vérifications ciblées -> vérifications larges>
    Destination des preuves : <fichier de tâche ou fichier de preuves>
    
  7. Exécutez l'helper d'exécution en mode task-contract ou all lorsqu'un chemin de tâche existe, puis réconciliez les champs manquants avant toute modification.

  8. Inspectez l'état actuel de l'espace de travail avant toute modification.

  9. Capturez la preuve de base.

  10. Implémentez le plus petit changement qui satisfait la tâche.

  11. Vérifiez par couches.

  12. Exécutez une revue par sous-agent lorsqu'un déclencheur de revue requis s'applique et que les outils de sous-agent sont disponibles. S'ils sont indisponibles ou interdits, enregistrez la revue ignorée et substituez une vérification avant de clôturer.

  13. Enregistrez les preuves avant de marquer la tâche comme terminée.

  14. Mettez à jour uniquement le suivi/les docs pertinents.

  15. Exécutez la commande complète du résolveur d'état Bun et l'helper d'exécution en mode stop-gates avant de sélectionner une autre tâche.

  16. Rapportez à nouveau les résultats du résolveur avant de décider s'il est sûr de sélectionner une autre tâche.

  17. Arrêtez-vous à tout gate de fondateur, d'état externe, d'échec de vérification, de tâche obsolète, de non-concordance de source, de conflit ouvert, de propriétaire non-IA, ou de demande de publication. Ne passez pas à la tâche suivante tant que le gate n'est pas résolu ou explicitement converti en une tâche prête appartenant à l'IA.

  18. Validez ou remettez selon le workflow du projet.

Règle de non-préparation

Si les documents d'autorité, le périmètre MVP, les règles d'exécution ou les fichiers de tâche sont manquants, ne prétendez pas que l'exécution est prête. Redirigez l'utilisateur vers /build-right-preflight ou créez le plus petit bloqueur Sprint 0 nécessaire pour établir la surface d'exécution manquante.

Les tâches de prototype peuvent être exécutées à partir de hypothèse-de-prototype uniquement lorsque la réversibilité, l'accroche d'apprentissage et la validation requise avant la vérité produit sont explicites.

Pour les versions manuelles/essais du skill, enregistrez la source exacte sous test. Si le skill installé ou invoqué est obsolète par rapport à la source du skill dans le dépôt local, marquez l'essai partiel-nécessite-réexécution et ne faites pas passer les gates de publication à prêt.

Règle de périmètre

N'élargissez pas silencieusement le périmètre. Si la tâche révèle un travail non lié, créez un suivi et continuez uniquement à l'intérieur de la limite de la tâche sélectionnée.

Gate d'arrêt/demande

Après chaque tâche, vérifiez si l'étape suivante est vraiment détenue par l'IA et prête. Arrêtez-vous et demandez ou signalez le bloqueur lorsque l'étape suivante nécessite :

  • des décisions de produit, de positionnement, d'acheteur/utilisateur ou de MVP appartenant au fondateur
  • une propriété de tâche prête ou active qui n'est pas l'IA
  • des conflits ouverts dans docs/conflicts.md
  • une découverte externe, une indexation de recherche, une publication, des secrets, des services payants ou un accès à la production
  • une vérification échouée, un état de tâche obsolète, une non-concordance de source ou des preuves ambiguës
  • une revue de sous-agent requise qui a été ignorée sans substitut équivalent

Continuer dans une file d'attente préparée est autorisé uniquement tant que chaque tâche suivante est prête, détenue par l'IA, fondée sur des preuves et non bloquée par l'un de ces gates.

Badge d'état visible par l'utilisateur

Terminez chaque réponse finale avec exactement un bloc de badge d'état :

✅ [FAIT] Statut : FAIT
Décision : <décision/résultat>
Action suivante : <action suivante ou aucune>
Nécessite saisie utilisateur : <aucune | demande concise>
Bloqué par : <aucun | bloqueur>

Utilisez cette correspondance d'état :

  • ✅ [FAIT] Statut : FAIT pour une tâche terminée avec des preuves, une vérification et des mises à jour du suivi.
  • 🟢 [VERT] Statut : TOUT VERT pour execute-task ou continue-active-task avant le début de l'implémentation.
  • 🟡 [JAUNE] Statut : NÉCESSITE SAISIE pour ask-founder.
  • 🟠 [ORANGE] Statut : NÉCESSITE TRAVAIL pour un travail de suivi appartenant à l'IA qui n'est pas encore une tâche d'exécution prête.
  • 🔵 [BLEU] Statut : ATTENTE EXTERNE pour wait-external, publication, indexation, identifiants, services payants, accès à la production ou état tiers.
  • 🔴 [ROUGE] Statut : BLOQUÉ pour create-blocker, no-ready-task, invalid-state, conflits ouverts, vérification échouée, obsolète/non-concordance de source, propriété de tâche non-IA, ou revue requise ignorée sans substitut.

Skills associés