devflow

Toolkit de Spec-Driven Development pour Claude Code et Cursor. Chaque feature passe par un pipeline structuré avec gates de review avant d'atteindre le code.

Inspiré de spec-kit.

Qu'est-ce que devflow ?

devflow impose un workflow séquentiel où chaque feature est spécifiée, planifiée et reviewée avant toute ligne de code. Le pipeline complet :

constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done

Les gates de review (review-spec, review-tasks, review-impl) sont bloquantes : aucune progression sans verdict PASS.

Deux interfaces complémentaires :

• CLI Python (devflow) — moteur d'état, orchestration, branches, hooks et installation
• Commandes slash (/devflow.*) — production et review des artefacts dans Claude Code

Prérequis

• Python 3.11+
• Claude Code ou Cursor
• git

Installation

uv tool install devflow-cli

Ou avec pip :

pip install devflow-cli

Pour vérifier l'installation :

devflow check

Pour l'installation en mode développeur, voir CONTRIBUTING.md.

Quick Start

1. Initialiser devflow dans votre projet

devflow init

Cela copie les commandes, agents et templates dans votre configuration Claude Code.

2. Créer une feature

devflow feature KS-123 --short-name "user-auth"

Crée la branche et le dossier de specs associé.

3. Exécuter le pipeline

Depuis le terminal :

devflow run KS-123

La CLI enchaîne les sessions Claude, relit state.json après chaque étape et s'arrête sur une review bloquante ou une absence de progression.

Pour travailler étape par étape dans Claude Code, lancez les commandes slash dans l'ordre :

/devflow.spec "Description de la feature"
/devflow.clarify
/devflow.plan
/devflow.tasks
/devflow.implement

Chaque commande produit un artefact (spec.md, plan.md, tasks.md, etc.) et fait avancer la feature dans le pipeline.

4. Suivre la progression

devflow status

Documentation

Consultez la documentation complète pour :

• Pipeline détaillé — les 13 étapes expliquées
• Commandes CLI — référence des commandes terminal
• Commandes slash — référence des 23 commandes Claude Code
• Guides par type de projet — brownfield, greenfield, microservices

Contribuer

Les contributions sont les bienvenues. Consultez le guide de contribution pour les prérequis, l'installation dev et les conventions.

English Summary

devflow is a Spec-Driven Development toolkit for Claude Code and Cursor. It enforces a structured pipeline where every feature goes through specification, planning, and review gates before any code is written.

The full pipeline: constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done.

Install: uv tool install devflow-cli (or pip install devflow-cli). Requires Python 3.11+, Claude Code or Cursor, git.

Quick start:

1. devflow init — set up devflow in your project
2. devflow feature KS-123 — create a feature branch
3. /devflow.spec "..." → /devflow.plan → /devflow.tasks → /devflow.implement — follow the pipeline in Claude Code

For full documentation, see docs/index.md. To contribute, see CONTRIBUTING.md.