Skip to main content

devflow

Devflow est un workflow adaptatif pour Claude Code. Il s'adresse au développeur qui fait travailler Claude Code sur ses projets et veut une rigueur proportionnée au risque : la CLI choisit un profil à partir de signaux explicites, confie chaque activité à un agent sous un contrat écrit et ne franchit une étape que sur des preuves qu'elle produit elle-même.

Un parcours produit une branche Git et un dossier de feature, un besoin écrit (need.md), les résultats de chaque activité, des preuves exécutées localement (tests, inspection du diff, revue) et un journal des retours d'usage (frictions et bilan).

Installer

Prérequis : Python 3.11+, Git et la CLI claude (Claude Code).

uv tool install --refresh devflow-cli==X.Y.Z   # version publiée sur PyPI
devflow init
devflow check

devflow init installe les commandes /devflow et /devflow.status dans ~/.claude ; devflow check vérifie les prérequis. Installer toujours depuis PyPI, à une version précise.

Après chaque mise à jour de la CLI, lancer devflow upgrade : il met à jour les commandes /devflow installées dans ~/.claude, que l'installation de la CLI ne touche pas. Tant qu'elles diffèrent de la CLI, devflow status affiche un avertissement avec cette commande ; rien n'est modifié sans vous. --refresh évite qu'uv ignore une version tout juste publiée. Juste après une publication, l'installation peut échouer pendant une à quatre minutes, le temps que l'index se propage : réessayer.

devflow init et devflow upgrade déplacent les anciennes commandes Claude connues vers ~/.claude/.devflow-legacy-backup/ sans toucher aux commandes personnalisées.

Une version majeure refuse, sans migration, les parcours démarrés avec une version majeure antérieure : terminez-les avant la mise à jour, voir les notes de version du dépôt.

Premier parcours

Une feature avec un identifiant d'issue passe par Devflow ; un correctif ponctuel ou une tâche hors feature, non.

Avec Claude Code :

/devflow KS-123

La commande crée la feature, rédige need.md, demande les signaux de l'évaluation puis enchaîne les activités jusqu'à done.

À la main :

devflow feature KS-123 --short-name user-auth
# Décrire le besoin dans need.md, dans le dossier de la feature créé
devflow assess KS-123 --scope multiple --ambiguity medium --risk medium
devflow adaptive start KS-123
devflow adaptive run KS-123
devflow adaptive status KS-123

Chaque invocation de adaptive run traite une activité. adaptive status affiche la progression, les preuves et la prochaine commande ; --json en donne une forme exploitable par la CI.

Décrire le besoin

need.md est l'entrée de tout parcours et fait foi pour chaque activité. Le besoin dit :

  1. les constats observés, avec leur origine ;
  2. les décisions prises, non rediscutables pendant le parcours ;
  3. l'attendu et les tests ;
  4. la livraison (version, fichiers de version) ;
  5. le hors périmètre ;
  6. les contraintes d'exécution.

Lire un refus

Chaque refus affiche son motif et la commande de reprise recommandée.

  • Refus justifié (le travail de l'agent ne satisfait pas l'étape) : corriger le travail, puis reprendre par la commande proposée.
  • Échec de Devflow (refus à tort, message trompeur, reprise inadaptée, prérequis non documenté) : le consigner aussitôt avec devflow feedback add --type friction.
  • En fin de parcours, terminé ou abandonné : un bilan avec devflow feedback add --type bilan.

Profils et garde-fous

Le profil fixe la route documentaire :

  • quick : changement local, clair et peu risqué, sans revue.
  • standard : plusieurs composants ou risque modéré ; préparation puis revue systématique.
  • deep : changement transversal, ambigu ou contractuel ; spec, plan, tasks, plus contracts quand --contract-change est déclaré.

Un bloc de garde-fous s'y ajoute quand --data-security est déclaré ou que --risk high : évaluation du risque, contrôle bloquant de sécurité ou de données à verify, revue indépendante, puis vérification du retour arrière avant done. Un bloc actif impose au minimum le profil standard, ne se désactive par aucune option et interdit les dérogations.

La référence complète (routes, preuves, commandes, contrats d'activité) est livrée dans le dépôt, sous docs/.

Synchronisation Linear

Si LINEAR_API_KEY contient une clé d'API personnelle Linear, la CLI met à jour le statut de l'issue du parcours au démarrage de chaque activité (adaptive run, y compris avec --until, et clôture done). L'équipe Linear doit avoir les statuts Backlog, Design, In Progress, Review et Done. Un statut n'est jamais ramené en arrière ; un statut hors de cette liste (Canceled, Duplicate) n'est jamais modifié.

Sans clé, ou si Linear échoue (issue inconnue, statut absent, erreur réseau ou délai de 5 s dépassé), la CLI affiche un avertissement et le parcours continue à l'identique. La clé est retirée de l'environnement de tout processus lancé par Devflow (agents, commandes de validation, commandes git) ; elle reste lisible par un agent si elle est définie dans un fichier que son shell charge (~/.zshrc).

Développement

uv sync --extra dev
uv run pytest -q
./tests/run-tests.sh
uv run devflow docs-sync --check

Metadata

Release files for devflow-cli 10.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for devflow-cli 10.1.1
File Size Uploaded Provenance Actions
devflow_cli-10.1.1.tar.gz 1.7 MB With provenance Details for devflow_cli-10.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for devflow-cli 10.1.1
File Interpreter ABI Platform Actions
devflow_cli-10.1.1-py3-none-any.whl Python 3 none any Details for devflow_cli-10.1.1-py3-none-any.whl

Total release size: 1.8 MB

Release files / devflow_cli-10.1.1.tar.gz

Download URL devflow_cli-10.1.1.tar.gz
Size 1.7 MB
Tags Source
SHA-256 checksum
How to use checksums
e890a47524df30436d003042e8b76294b0d305aae9cb2b36b471a7029fa20a22
BLAKE2b-256 checksum
How to use checksums
ffc179e6767598c3113752d84e5389d18b44176b208d7abe459ebde29cad045f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Release files / devflow_cli-10.1.1-py3-none-any.whl

Download URL devflow_cli-10.1.1-py3-none-any.whl
Size 155.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f865eb3edf40069e9162cb14a072742f2e4e5161cf6157424acbfe434ed08d5a
BLAKE2b-256 checksum
How to use checksums
0e869e2d306810003e48242028df30f64ba03091efe33b145e58a8843ea7e53d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Security for devflow-cli 10.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for devflow_cli-10.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

10.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page