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.

devflow report restitue, tous parcours confondus, les coûts par profil et par activité, les refus de la CLI avec ou sans agent, les reprises et les frictions ouvertes.

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.2.0

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.2.0
File Size Uploaded Provenance Actions
devflow_cli-10.2.0.tar.gz 1.7 MB With provenance Details for devflow_cli-10.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 1.9 MB

Release files / devflow_cli-10.2.0.tar.gz

Download URL devflow_cli-10.2.0.tar.gz
Size 1.7 MB
Tags Source
SHA-256 checksum
How to use checksums
03e1f546e1f754b3529a8df747eaccaf6dbac988c9a924d7e756165f7e4a1ae4
BLAKE2b-256 checksum
How to use checksums
90773108edd9292c394f854ead46dd0adfbc899a2169d814c45410ce8b87c3d1
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 30, 2026.

Transparency log

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

Download URL devflow_cli-10.2.0-py3-none-any.whl
Size 161.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
29e8d19cdab5c6b1130001627c8867753dd7c9c820d403831644ac9a92bdc270
BLAKE2b-256 checksum
How to use checksums
e25a27d2193b23b175140d208164b218178da9ec79a922a324b3d6d5f6d31d93
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 30, 2026.

Transparency log

Security for devflow-cli 10.2.0

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.2.0.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 30, 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.2.0 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