Comment installer le plugin Forge dans Claude Code ?

Dans une session Claude Code, sur n'importe quel projet : /plugin marketplace add gabrielmustiere/forge, puis /plugin install forge@forge, puis /reload-plugins. Les skills sont ensuite namespacées : /forge:help, /forge:feature-pitch, etc.

Quels sont les trois tracks de Forge ?

Le track feature couvre la valeur utilisateur (feature-pitch → feature-plan → feature-implem). Le track refacto restructure le code à comportement figé (refactor-plan → refactor-implem). Le track tech traite la performance, la résilience, l'observabilité et la sécurité (tech-plan → tech-implem). Les trois partagent la même clôture : review → commit → report → sync.

Faut-il passer par tout le pipeline pour un simple bugfix ?

Non. Le track fast couvre les changements de moins de 3 fichiers, sans migration ni impact transverse : on code, on passe la QA du stack, puis /forge:commit. Pas de pitch pour un typo.

Forge est-il lié à un langage ou un framework ?

Non, le pipeline est stack-agnostique. Il détecte le stack du projet via composer.json ou package.json et charge les conventions QA, sécurité et performance correspondantes (Symfony, Sylius…).

Forge — pipeline de développement Claude Code, de la vision au commit

Installation

Dans une session Claude Code, sur n'importe quel projet :

❯ /plugin marketplace add gabrielmustiere/forge
❯ /plugin install forge@forge
❯ /reload-plugins

Skills namespacées

/forge:help · /forge:feature-pitch …

Mettre à jour

/plugin marketplace update forge → /reload-plugins

Prérequis, concepts, référence des 25 skills, configuration des permissions et dépannage : voir la documentation complète.

Le pipeline

Trois tracks symétriques selon la nature du changement, un même pipeline. Chaque étape produit un artefact (pitch.md, plan.md, review.md…) validé par un ok explicite avant de passer à la suivante.

PHASE 0

Poser le décor — une fois, documents vivants

vision

→ docs/vision.md
product-backlog

→ docs/product-backlog.md
stack

→ docs/stack.md

Track Feature

Valeur utilisateur (user-facing)
1. (feature-interview → brief.md)
2. feature-pitch → pitch.md
3. feature-plan → plan.md
4. feature-implem
Track Refacto

Comportement figé, code restructuré
1. refactor-plan → plan.md
2. refactor-implem
Track Tech

Perf, résilience, observabilité, sécu
1. tech-plan → plan.md
2. tech-implem

CLÔTURE

Commune aux trois tracks

review
commit
report
sync

Tout vit dans `docs/story/`

Compteur global NNN-<f|r|t>-<slug> : le tri lexicographique donne la timeline du projet. Ex : 042-f-checkout-express/

Track fast — bugfix express

Moins de 3 fichiers, pas de migration ni d'impact transverse : on code, QA du stack, puis /forge:commit. Pas de pitch pour un typo.

Les skills

Vingt-cinq skills, un point d'entrée. Perdu en cours de route ? /forge:help est le GPS du pipeline.

Phase 0 — Poser le décor

Documents vivants · 4 modes : Création / Enrichir / Éditer / Pivot

/forge:vision: Cadre la vision : problème, audience, valeur, North Star, principes, anti-objectifs → docs/vision.md
/forge:product-backlog: Traduit la vision en domaines, capacités, parcours et backlog priorisé MVP/V2/V3 → docs/product-backlog.md
/forge:stack: Cartographie la stack technique — chaque techno prouvée par un fichier source → docs/stack.md

Track feature

Valeur utilisateur

/forge:feature-interview: (optionnel) Découvre un besoin flou par interview guidée, ancrée sur le code existant → brief.md
/forge:feature-pitch: Cadre l'idée et challenge l'alignement vision/backlog → pitch.md
/forge:feature-plan: Plan technique : archi, données, contrats, migration, tests → plan.md
/forge:feature-implem: Implémentation guidée sous-tâche par sous-tâche, QA continue

Track refacto

Comportement figé, code restructuré

/forge:refactor-plan: Cadrage + tests de caractérisation à poser comme verrou → plan.md
/forge:refactor-implem: Exécution verrou-tests-d'abord, étapes incrémentales réversibles

Track tech

Perf, résilience, observabilité, sécu

/forge:tech-plan: Cadrage avec métrique cible chiffrée + baseline + kill switch → plan.md
/forge:tech-implem: Exécution : baseline, kill switch, mesure après chaque étape

Clôture

Commune aux trois tracks

/forge:review: Code review du diff : sécu, qualité, conformité au plan, non-régression → review.md
/forge:commit: Message Conventional Commits en français (l'intention), commit + push
/forge:report: Compte rendu honnête : fait vs prévu, écarts, dettes → report.md
/forge:sync: Réaligne pitch/plan et les docs projet (vision, stack, product-backlog) sur le code livré
/forge:report-and-sync: Enchaîne report puis sync en une passe — court-circuité si la conformité est totale

Utilitaires

Hors pipeline

/forge:help: Sommaire du pipeline, tracks, skills et artefacts — le GPS
/forge:claude-md: Génère ou met à jour le CLAUDE.md : analyse du codebase + principes comportementaux
/forge:rules: Écrit les règles projet paths-scopées dans .claude/rules/ — chargées seulement sur la zone concernée
/forge:test-scenario: Joue un scénario utilisateur en live via Playwright MCP
/forge:adr: Rédige un Architecture Decision Record MADR léger → docs/adr/NNNN-slug.md
/forge:estimate: Chiffre le temps « tout compris » d'une story à facturer, en heures → estimate.md
/forge:doc-feature: Cartographie une feature existante (legacy) → docs/feature-map/NNN-slug/overview.md
/forge:backfill-metadata: Reconstruit le metadata.json des stories antérieures depuis l'historique git — jamais de date inventée
/forge:release: Tag SemVer annoté + CHANGELOG.md Keep a Changelog + release GitHub

Inventaire complet : plugins/forge/SKILLS.md · Le workflow détecte le stack (Symfony, Sylius…) via composer.json / package.json et charge les bonnes conventions QA, sécu et perf.

Forge Board — l'application

Un tableau kanban lecture seule qui scanne les documents produits par le workflow (docs/story/) et projette chaque story en carte le long d'un pipeline visuel — pour répondre en quelques secondes à « où en est le projet X ? ». L'app Symfony vit à la racine du repo, la marketplace sous plugins/.

FRAMEWORK: Symfony 8.0 · PHP 8.5+ · Symfony CLI (proxy HTTPS *.wip)
FRONT: Symfony UX (Stimulus, Turbo, Live Component) · Tailwind 4 · AssetMapper
DONNÉES: SQLite (fichier local, zéro infra) · Messenger (transport Doctrine)
TESTS: PHPUnit 13 (Unit + Functional) · Playwright (E2E)
QUALITÉ: PHPStan level 9 · PHP-CS-Fixer
MCP: symfony-ai-mate · playwright · chrome-devtools

Démarrer

$ make init # deps PHP/JS + DB + fixtures
$ docker compose up -d # Mailpit (capture des e-mails)
$ make serve # → https://forge-board.wip

make init: Installation complète (deps + DB + fixtures)
make serve: Lance le serveur Symfony
make db-reset: Recrée la base from scratch
make migration: Migration depuis le diff d'entités
make phpunit: Tests PHPUnit (Unit + Functional)
make playwright: Tests E2E Playwright
make quality: CS-Fixer + PHPStan + build
make ci: Lint + tests unitaires (reproduit la CI)

Prérequis : PHP 8.5+, Composer, Symfony CLI, Docker (Mailpit), Node.js 22+. Mailpit UI : localhost:8027 · identifiants de test : admin@example.com / password

Installation

Skills namespacées

Mettre à jour

Le pipeline

Poser le décor — une fois, documents vivants

Track Feature

Track Refacto

Track Tech

Commune aux trois tracks

Tout vit dans docs/story/

Track fast — bugfix express

Les skills

Phase 0 — Poser le décor

Track feature

Track refacto

Track tech

Clôture

Utilitaires

Forge Board — l'application

Démarrer

Tout vit dans `docs/story/`