devflow
Devflow est un moteur de développement adaptatif pour Codex, Claude Code et Cursor. Il choisit un niveau de rigueur à partir de signaux explicites, produit des contrats d’activité portables et bloque les transitions tant que les preuves attendues ne sont pas présentes.
Profils
quick: changement local, clair et peu risqué.standard: plusieurs composants ou risque modéré.deep: changement transversal, ambigu ou contractuel.critical: sécurité, données, migration ou risque élevé.
Les routes exactes et leurs preuves sont générées dans docs/pipeline-reference.generated.md.
Installation
uv tool install --refresh devflow-cli==X.Y.Z # version publiée, voir CHANGELOG.md
devflow init --ai codex
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. --refresh évite qu'uv ignore une version tout juste
publiée. Tant que les commandes installées diffèrent de la CLI,
devflow status affiche un avertissement avec cette commande ; rien n'est
modifié sans vous.
Installer toujours depuis PyPI, à une version précise, jamais depuis le dossier du dépôt. Les versions publiées sont listées dans CHANGELOG.md.
Python 3.11+ et Git sont requis. --ai accepte codex, claude-code ou
cursor.
Parcours quotidien
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 --agent codex
devflow adaptive status KS-123
adaptive status --json fournit un état exploitable par la CI. Les échecs
distinguent explicitement blocage métier, contrat invalide, panne agent,
validation échouée et conflit concurrent ; chaque refus affiche la commande de
reprise recommandée.
Chaque invocation de adaptive run traite une activité. La politique est dans
assessment.json; la progression et les preuves sont dans
workflow-state.json. Les résultats agent sont validés par schéma et les
preuves d’exécution sensibles sont produites localement par Devflow.
Chaque profil exécute preflight-evidence avant implement. Cette
activité archive des faits externes reproductibles dans
preflight-evidence.md, sans secret ni donnée utilisateur.
Les trois adaptateurs acceptent les mêmes contrats structurés :
devflow adaptive run KS-123 --agent codex
devflow adaptive run KS-123 --agent claude
devflow adaptive run KS-123 --agent cursor
Features créées avant devflow 5
Devflow 5 ne lit que ses propres schémas et ne fournit aucune migration : un
assessment.json, un workflow-state.json ou un state.json créé par une
version antérieure est refusé. Terminez ces features avec devflow 4.x avant la
mise à jour. Voir ADR-0002.
devflow init et devflow upgrade déplacent également les anciennes commandes
Claude connues vers ~/.claude/.devflow-legacy-backup/ sans toucher aux
commandes personnalisées.
Documentation
Développement
uv sync --extra dev
uv run pytest -q
./tests/run-tests.sh
uv run devflow docs-sync --check
1 maintainer
Metadata
1 maintainer
Release files for devflow-cli 6.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| devflow_cli-6.4.0.tar.gz | 781.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| devflow_cli-6.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 955.6 kB
Release files / devflow_cli-6.4.0.tar.gz
| Download URL | devflow_cli-6.4.0.tar.gz |
|---|---|
| Size | 781.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
56892f1b8c651d6d8dfa96e0b46167bc2a67d20b4b3047e8b333ccb42844b4da
|
|
BLAKE2b-256 checksum How to use checksums |
cd6be44d6c36e0cacb33f25a60b92210958a9b4a4440ac6894f9604790ca75bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 29, 2026.
Transparency logRelease files / devflow_cli-6.4.0-py3-none-any.whl
| Download URL | devflow_cli-6.4.0-py3-none-any.whl |
|---|---|
| Size | 173.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
54d7c7936dc25f5219258c398b2912985edec9950b38d271c2085d485d3cefae
|
|
BLAKE2b-256 checksum How to use checksums |
1f48842736909e6e41b9d477a54b12765b23f1fed56fb5adabb4361e9850bb3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 29, 2026.
Transparency log
