Skip to main content

Spec-Driven Development workflow CLI

Project description

devflow

CI PyPI License

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) — 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

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 :

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

devflow_cli-2.3.0.tar.gz (410.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

devflow_cli-2.3.0-py3-none-any.whl (45.8 kB view details)

Uploaded Python 3

File details

Details for the file devflow_cli-2.3.0.tar.gz.

File metadata

  • Download URL: devflow_cli-2.3.0.tar.gz
  • Upload date:
  • Size: 410.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for devflow_cli-2.3.0.tar.gz
Algorithm Hash digest
SHA256 80d6d876383daf590db109ca33755daadbd56a12949432565bc938d11e298f70
MD5 e4617c82d55f9a583288b0c2410ed21f
BLAKE2b-256 d2200daf780c504acfb6a127f6738f0d35ca38b5503f25c5e1b96055f1ee2e37

See more details on using hashes here.

Provenance

The following attestation bundles were made for devflow_cli-2.3.0.tar.gz:

Publisher: release.yml on sopequenoteck/devflow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file devflow_cli-2.3.0-py3-none-any.whl.

File metadata

  • Download URL: devflow_cli-2.3.0-py3-none-any.whl
  • Upload date:
  • Size: 45.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for devflow_cli-2.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f7b88baf535fdada4d982309acb537dcd8a01355d1d3db6a27b47f6dcc2530e9
MD5 2f58eb51d5974393e472c375a2788282
BLAKE2b-256 88d7a3bb5576c55a28b9a286aa7ee448edb48caf0dc3aa46d070508aa6b9f6e5

See more details on using hashes here.

Provenance

The following attestation bundles were made for devflow_cli-2.3.0-py3-none-any.whl:

Publisher: release.yml on sopequenoteck/devflow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page