forge

Transforme un besoin flou en brief pour `/feature-pitch` — interview accessible (irritant, qui, résultat attendu) ancrée sur le code existant. Pour qui sait ce qui le gêne mais pas le pitcher. Produit `docs/story/NNN-f-<slug>/brief.md`.

Reconstruit le `metadata.json` manquant des stories antérieures — déduit le titre du H1, les dates `created`/`updated` de l'historique git, la timeline `changelog` de l'apparition de chaque artifact, la livraison (`delivery.commit`/`release`) des commits et tags, propose des `tags` à valider. Déclenche sur « générer les métadonnées des anciennes stories », « backfill metadata.json », « reconstruire les métadonnées ».

Rédige un Architecture Decision Record (MADR léger) depuis un artifact (pitch/plan/review/report) ou un topic libre — contexte, drivers, options, conséquences. Produit `docs/adr/NNNN-<slug>.md` avec backlinks et index auto.

Commit Conventional Commits v1.0.0 en français depuis le diff courant — analyse, génère `type(scope): sujet` (corps si pertinent), commit, rebase (jamais de merge), puis push. Bloque sur secrets, code de debug ou conflit de rebase.

Chiffre le temps « tout compris » d'une story à facturer (feature, refacto, tech) : cadrage, implem, tests, review, doc, release. Lit brief/pitch/plan. Réaliste + marge, en heures. Produit `docs/story/NNN-<f|r|t>-<slug>/estimate.md`.

Implémente une feature depuis un plan technique validé — sous-tâches trackées, qualité continue (lint, types, tests), checkpoints humains avant choix structurants. Prérequis un `plan.md` sous `docs/story/<NNN>-f-<slug>/`.

Cadre et challenge une feature avant développement — problème, utilisateurs, valeur, parcours, critères, hors-périmètre. S'aligne sur `docs/vision.md` et `docs/product-backlog.md`. Produit `docs/story/<NNN>-f-<slug>/pitch.md`.

Conçoit techniquement une feature cadrée — architecture, modèle de données, intégrations, contrats d'API, stratégie de test, impacts existants. Prérequis : `pitch.md` validé. Produit `docs/story/<NNN>-f-<slug>/plan.md`, lu par `feature`.

Exécute un refacto cadré — verrou bloquant sur tests de caractérisation présents et passants, puis applique le plan étape par étape avec non-régression. Prérequis un `plan.md` sous `docs/story/<NNN>-r-<slug>/`. Argument optionnel : slug à reprendre.

Cadre un refacto avant exécution — motivation, périmètre (fichiers/modules), tests de caractérisation à poser AVANT changement, plan incrémental par étapes vérifiables. Produit `docs/story/<NNN>-r-<slug>/plan.md`.

Crée une release versionnée bout-en-bout — bump SemVer depuis Conventional Commits, met à jour `CHANGELOG.md` (Keep a Changelog), tag annoté `vX.Y.Z`, push, puis publie sur GitHub via `gh`. Demande validation avant toute action publique.

Compte rendu d'implémentation après livraison — compare l'intention (`pitch.md`+`plan.md` ou `plan.md`) au code livré, liste écarts, décisions, dettes. Écrit `docs/story/NNN-<f|r|t>-<slug>/report.md`. À lancer avant `sync`.

Relit un diff avant merge — sécurité (injections, secrets, droits), qualité, perf, conformité au `plan.md` (et au `pitch.md` pour les features), robustesse des migrations. Produit `review.md` avec verdict go/no-go et actions priorisées.

Réaligne la doc d'intention (`pitch.md`+`plan.md` ou `plan.md`) sur le code livré — applique les écarts validés du `report.md`, trace chaque modif dans un changelog en pied de fichier. À lancer après `report` quand le code a divergé.

Exécute une évolution technique cadrée — capture la baseline AVANT, kill switch à chaud, applique le plan étape par étape avec mesure d'impact et non-régression. Prérequis un `plan.md` sous `docs/story/<NNN>-t-<slug>/`.

Cadre une évolution technique transverse (perf, résilience, observabilité, sécu, scalabilité) — motivation, baseline AVANT, options, plan incrémental avec kill switch et métriques. Produit `docs/story/<NNN>-t-<slug>/plan.md`.

Pilote autonome bout-en-bout de `/forge:feature-implem`, `/forge:refactor-implem` et `/forge:tech-implem` — délègue chaque sous-tâche à un subagent isolé, trace dans `.autopilot.json` (reprise possible), s'arrête uniquement aux stop-points stratégiques.

Génère ou met à jour le CLAUDE.md racine — analyse du codebase (stack, archi, commandes, conventions) + principes comportementaux Karpathy. Déclenche sur « génère un CLAUDE.md », « initialise les instructions Claude », « documente le repo pour Claude ».

Documente une feature implémentée en lisant le code — entités, flux, routes, services, templates, points d'extension. Stack-agnostique (Sylius, Symfony). Produit `docs/feature-map/NNN-slug/overview.md`. Utile pour onboarding ou cartographie.

Affiche le sommaire du workflow et oriente vers le bon skill — phases amont (vision, product-backlog), trois tracks (feature, refacto, tech), enchaînement et artifacts. À utiliser quand tu ne sais pas par où commencer ou quel skill correspond.

Importe une doc externe (Spec Kit, BMAD-METHOD, GSD) vers `docs/story/NNN-<f|r|t>-<slug>/`. Détecte la source, mappe les sections vers `pitch.md`/`plan.md` avec validation, copie via `git mv` pour préserver l'historique.

Migre les anciens formats workflow — dossiers `<f|r|t>-NNN-<slug>/` → `NNN-<f|r|t>-<slug>/`, `feature.md`/`design.md` → `pitch.md`/`plan.md`, puis reformate optionnellement chaque artifact au gabarit unifié.

Traduit la vision en périmètre fonctionnel — domaines, capacités, parcours, règles, backlog priorisé MVP/V2/V3. Quatre modes : Création, Enrichir, Éditer, Pivot. Produit `docs/product-backlog.md` avec changelog, lu par `feature-pitch`.

Enchaîne `/forge:report` puis `/forge:sync` en une passe après livraison d'une story (feature, refacto ou évolution technique) — compte rendu d'écarts intention vs code livré, puis réalignement de la doc. Délègue à un subagent isolé.

Détecte et documente la stack technique complète d'un projet (langages, backend, frontend, données, ops, CI/CD) — phase 0 technique. Scanne tous les manifestes puis interroge pour combler les trous non détectables. Quatre modes : Création, Enrichir, Éditer, Pivot. Produit `docs/stack.md` avec changelog, lu par feature/refactor/tech/review.

Joue un scénario utilisateur via Playwright ou Chrome DevTools MCP — pilote un vrai navigateur pour valider un parcours bout-en-bout, reproduire un bug ou simuler un comportement. Capture états visuels, erreurs console et requêtes réseau.

Définit la vision projet (phase 0) — problème, audiences, North Star, principes, anti-objectifs. Quatre modes : Création, Enrichir, Éditer, Pivot. Produit `docs/vision.md` avec changelog, lu par `product-backlog` puis `feature-pitch`.