devflow-cli 1.0.0

Spec-Driven Development workflow CLI

devflow

Toolkit de Spec-Driven Development pour Claude Code. 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) — pour gérer les branches, le statut et l'installation
• Commandes slash (/devflow.*) — pour piloter le workflow dans Claude Code

Prérequis

• Python 3.11+
• Claude Code (CLI)
• 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. Suivre le pipeline

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 11 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. 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 CLI, 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.