A previous release had provenance metadata, but this release does not. View details.
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 :
- les constats observés, avec leur origine ;
- les décisions prises, non rediscutables pendant le parcours ;
- l'attendu et les tests ;
- la livraison (version, fichiers de version) ;
- le hors périmètre ;
- 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, pluscontractsquand--contract-changeest 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.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Loss of provenance
These files do not have provenance metadata, despite files in a prior release including this data.
We recommend further investigation before installing these files. View details.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| devflow_cli-10.2.3.tar.gz | 1.7 MB | Without provenance | Details for devflow_cli-10.2.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| devflow_cli-10.2.3-py3-none-any.whl | Python 3 | none | any | Details for devflow_cli-10.2.3-py3-none-any.whl |
Total release size: 1.9 MB
Release files / devflow_cli-10.2.3.tar.gz
Loss of provenance
This file belongs to a release without provenance metadata, despite a prior release including this data.
We recommend further investigation before installing this file. View details.
| Download URL | devflow_cli-10.2.3.tar.gz |
|---|---|
| Size | 1.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e62796efd82fbef99f48d16e15a4e2703a8e346978579e78cc0437d4ae7130d8
|
|
BLAKE2b-256 checksum How to use checksums |
73ca5f8a6f321edb325f5b56a4c2893ee9bc58fe1aadafe8800512e43804fbd4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / devflow_cli-10.2.3-py3-none-any.whl
Loss of provenance
This file belongs to a release without provenance metadata, despite a prior release including this data.
We recommend further investigation before installing this file. View details.
| Download URL | devflow_cli-10.2.3-py3-none-any.whl |
|---|---|
| Size | 162.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8a593456dcdd014f3ceb4c11d862a44caa2b2972eaf0d9ca4537f9753ba30c4d
|
|
BLAKE2b-256 checksum How to use checksums |
27dea59b760ba6fcccc9ee96e2e68179f99b69b387573abda93c1cb16b5c4f28
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for devflow-cli 10.2.3
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.
Loss of provenance
A previous release of these files had provenance metadata, but this release does not.
While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.
Release comparison
- Removed 10.2.1 2 files With provenance
- Added 10.2.3 2 files Without provenance
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.