Démarrage rapide

Installez le plugin dans votre assistant, choisissez votre point de départ, puis lancez le workflow adapté à votre projet.

Avant de commencer

Claude Code, pour utiliser les commandes /plugin ci-dessous
un dépôt cible ouvert dans votre assistant
un accès GitHub uniquement si vous voulez travailler depuis des issues

Node.js, APM et un clone du dépôt SKRAFT ne sont pas requis pour utiliser le plugin. Ils concernent le développement du plugin lui-même.

1. Installer SKRAFT avec `/plugin`

Saisissez ces commandes dans la conversation Claude Code, pas dans un terminal :

/plugin marketplace add SebastienDegodez/skraft-plugin
/plugin install skraft

La première commande ajoute le dépôt comme marketplace. La seconde installe le plugin skraft publié par ce marketplace. Ouvrez ensuite /plugin et vérifiez que skraft apparaît dans les plugins installés.

Contournement Windows

Si /plugin marketplace add échoue avec fatal: unable to checkout working tree, clonez SKRAFT sur un chemin local court, puis ajoutez ce checkout comme marketplace :

git clone https://github.com/SebastienDegodez/skraft-plugin C:\s\skraft

/plugin marketplace add C:\s\skraft
/plugin install skraft

Ou activez les chemins longs Windows, redémarrez le shell, puis réessayez :

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name LongPathsEnabled -Value 1 -PropertyType DWORD -Force
git config --global core.longpaths true

2. Choisir votre parcours

Ne lancez pas automatiquement toute la chaîne. Le bon point de départ dépend de ce que votre dépôt possède déjà.

Votre situation	Commencez par	Puis
Une story est déjà affinée	`skraft-orchestrator`	pipeline d’ingénierie
Des issues existent, mais ne sont pas préparées	`backlog-discoverer`, puis `backlog-planner`	`skraft-orchestrator`
Le code existe sans documentation produit	`brownfield-analyst`	PRD, création des issues, préparation produit, puis `skraft-orchestrator`
Le legacy est dangereux à modifier	`brownfield-harness-builder`, puis `brownfield-refactorer`	retour vers une story préparée, puis `skraft-orchestrator`

Les workflows Brownfield, DISCOVER et DISCUSS sont invoqués directement. Ils ne sont pas des phases cachées de skraft-orchestrator. Consultez le parcours Brownfield si vous reprenez un système existant.

3. Lancer le premier workflow

Story déjà prête

Dans le sélecteur d’agents, choisissez skraft-orchestrator, puis donnez-lui la story affinée. C’est le seul point d’entrée du pipeline d’ingénierie. Il charge son état persistant et reprend au dernier point validé.

Backlog encore brut

Choisissez d’abord backlog-discoverer dans le sélecteur d’agents. Une fois le triage terminé, choisissez backlog-planner pour affiner l’issue retenue. La story affinée devient alors l’entrée de skraft-orchestrator.

4. Comprendre ce qui va s’exécuter

Le parcours principal contient deux zones distinctes :

Préparation produit optionnelle et autonome
- DISCOVER trie et priorise les issues
- DISCUSS transforme une issue en story vérifiable
Pipeline d’ingénierie piloté par skraft-orchestrator
- RESEARCH réduit l’incertitude lorsque le travail le justifie
- DESIGN prend et trace les décisions d’architecture
- DISTILL produit les scénarios exécutables et le plan
- DELIVER implémente par Outside-In TDD et rassemble les preuves

RESEARCH peut être sauté lorsque le routage conclut qu’une investigation dédiée n’apporterait rien. DISCOVER et DISCUSS ne sont jamais dispatchés par skraft-orchestrator : vous les choisissez avant lui lorsque votre entrée n’est pas encore une story prête.