Metadata-Version: 2.4
Name: devflow-cli
Version: 2.0.0
Summary: Spec-Driven Development workflow CLI
Project-URL: Homepage, https://github.com/sopequenoteck/devflow
Project-URL: Repository, https://github.com/sopequenoteck/devflow
Author-email: sopequenoteck <sopequeno.tech@gmail.com>
License: MIT
License-File: LICENSE
Keywords: claude-code,cli,development,spec-driven,workflow
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Requires-Dist: pyyaml>=6
Requires-Dist: rich>=13
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# devflow

[![CI](https://github.com/sopequenoteck/devflow/actions/workflows/ci.yml/badge.svg)](https://github.com/sopequenoteck/devflow/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/devflow-cli)](https://pypi.org/project/devflow-cli/)
[![License](https://img.shields.io/pypi/l/devflow-cli)](LICENSE)

Toolkit de **Spec-Driven Development** pour [Claude Code](https://docs.anthropic.com/en/docs/claude-code) et [Cursor](https://cursor.com). Chaque feature passe par un pipeline structuré avec gates de review avant d'atteindre le code.

Inspiré de [spec-kit](https://github.com/github/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** ou **Cursor**
- **git**

## Installation

```bash
uv tool install devflow-cli
```

Ou avec pip :

```bash
pip install devflow-cli
```

Pour vérifier l'installation :

```bash
devflow check
```

> Pour l'installation en mode développeur, voir [CONTRIBUTING.md](CONTRIBUTING.md).

## Quick Start

### 1. Initialiser devflow dans votre projet

```bash
devflow init
```

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

### 2. Créer une feature

```bash
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

```bash
devflow status
```

## Documentation

Consultez la [documentation complète](docs/index.md) pour :

- [Pipeline détaillé](docs/pipeline.md) — les 13 étapes expliquées
- [Commandes CLI](docs/cli-reference.md) — référence des 11 commandes terminal
- [Commandes slash](docs/commands-reference.md) — référence des 23 commandes Claude Code
- [Guides par type de projet](docs/index.md#guides-par-type-de-projet) — brownfield, greenfield, microservices

## Contribuer

Les contributions sont les bienvenues. Consultez le [guide de contribution](CONTRIBUTING.md) pour les prérequis, l'installation dev et les conventions.

## English Summary

**devflow** is a Spec-Driven Development toolkit for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Cursor](https://cursor.com). 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](docs/index.md). To contribute, see [CONTRIBUTING.md](CONTRIBUTING.md).
