Construire solution azd

Étape 08 · Construire la solution

Construis le plus petit changement valide. Implement the smallest valid change. Interfaces publiques equivalentes: Français and English.

Quick start

Invocation: $construire-solution-azd "Ajoute le champ JSON public-contract.json#/status sans renommer les tokens existants."

Verdict attendu: test red capture l'absence du champ, patch minimal, test green, fichiers changes, risque residuel.

Utiliser quand / Use when

Utilise ce skill quand le resultat est assez clair pour coder, qu'un failing test existe ou qu'un plan accepte doit devenir un patch minimal.

Boucle / Loop

1. Confirmer que la carte est Ready, que son Proof Contract et son Readiness Forecast sont frais et que le Route Pack, Language Pack, ADR et contexte minimal sont résolus. Sinon retourner à la première gate manquante.
2. Pars du public seam, pas des internals.
3. RED: écris ou modifie d'abord un test qui échoue; enregistre commande, sortie, commit/worktree et raison de l'échec.
4. Si du code candidat précède le test, supprime-le ou isole-le hors candidate scope, puis repars du test rouge.
5. GREEN: implémente uniquement ce qui rend ce test vert.
6. REFACTOR: simplifie seulement après le vert, sans changer le comportement.
7. Rejoue le test et les checks natifs proportionnés; enregistre l'evidence green.
8. Pour une surface humaine, implémente chaque ligne de la UI acceptance matrix: états non nominaux, selectors/attributes publics exacts, clavier, live region, viewports et artefacts.
9. Ajoute un test qui échoue si un état requis existe seulement dans la prose ou le JavaScript sans représentation vérifiable.
10. Si l'exécution révèle un prérequis, une décision ou une idée hors carte, ne pas l'absorber: créer une carte Draft liée et poursuivre seulement si la carte active reste valide.
11. Si une preuve échoue, classer la première hypothèse invalidée (readiness | understanding | diagnosis | design | plan | build) et retourner à cette gate. Ne pas affaiblir le claim ni modifier l'oracle pour passer.
12. Arrête la tranche quand elle est verte et prouvée.

Règles / Rules

• Use TDD and project-native patterns.
• Garde le smallest valid change.
• Applique Ponytail: supprimer avant d'ajouter, reutiliser avant d'inventer, refuser les abstractions sans complexite reelle.
• Preserve safety, accessibility, user changes and existing tests.
• Garde evaluator, reviewer, hidden oracle et protected regressions hors du write scope candidat.
• Si le besoin reste ambigu, retourne à $clarifier-objectif-azd ou $concevoir-experience-azd.
• Ne remplace jamais un token normatif par un synonyme: paths, schema fields, IDs, roles, attributes et viewport dimensions restent exacts.

Sortie / Output

build:
  card_id: ""
  readiness_forecast: fresh | stale | blocked
  proof_contract: locked | missing | stale
  author_id: ""
  worktree: ""
  write_scope: []
  red:
    command: ""
    evidence: ""
  green:
    command: ""
    evidence: ""
  refactor:
    command: ""
    evidence: ""
  changed_files: []
  protected_out_of_scope: []
  discovered_draft_cards: []
  causal_return: none | readiness | understanding | diagnosis | design | plan | build
  verdict: green | partial | blocked | failed

Stop when the assigned slice is green and no scoped failure remains. Sinon rends partial, blocked ou failed avec le blocker exact. Garde code, paths, commands and verdicts identical in Français and English.