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 devflow-cli
devflow init --ai codex
Python 3.11+ et Git sont requis. --ai accepte codex, claude-code ou
cursor.
Parcours quotidien
devflow feature KS-123 --short-name user-auth
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.
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
Migrer une ancienne feature
devflow migrate KS-123 --dry-run
devflow migrate KS-123 --profile deep
La migration conserve les artefacts, archive state.json sous
legacy-state.json, puis redémarre à la première activité vérifiable du profil.
Sans identifiant, devflow migrate traite toutes les anciennes features.
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file devflow_cli-3.0.1.tar.gz.
File metadata
- Download URL: devflow_cli-3.0.1.tar.gz
- Upload date:
- Size: 466.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
67ed76fdb806dce8b29caba72ae6216bff057933479c9d713232d692080b2f77
|
|
| MD5 |
3b6d3203d88c673eaf807a49b8ee2667
|
|
| BLAKE2b-256 |
04d7e8bf7faad3481ce54d6616d4d77859e62feaeac559f92206cb23b3a8dc2e
|
Provenance
The following attestation bundles were made for devflow_cli-3.0.1.tar.gz:
Publisher:
release.yml on sopequenoteck/devflow
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
devflow_cli-3.0.1.tar.gz -
Subject digest:
67ed76fdb806dce8b29caba72ae6216bff057933479c9d713232d692080b2f77 - Sigstore transparency entry: 2582240217
- Sigstore integration time:
-
Permalink:
sopequenoteck/devflow@a9a826ec308b44794bd831a7bdbc5a1072972c0c -
Branch / Tag:
refs/tags/v3.0.1 - Owner: https://github.com/sopequenoteck
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a9a826ec308b44794bd831a7bdbc5a1072972c0c -
Trigger Event:
push
-
Statement type:
File details
Details for the file devflow_cli-3.0.1-py3-none-any.whl.
File metadata
- Download URL: devflow_cli-3.0.1-py3-none-any.whl
- Upload date:
- Size: 128.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d2f2c55d69591fcd8adf2ee76cb84ffd787c798011a97c89d170ca680c8e8e71
|
|
| MD5 |
287da0ae3621dc75371f65f48eb645cc
|
|
| BLAKE2b-256 |
0a781c90bf5effd5d1e535460906f3b6530b241d8e7035ecdd593236c7845dbe
|
Provenance
The following attestation bundles were made for devflow_cli-3.0.1-py3-none-any.whl:
Publisher:
release.yml on sopequenoteck/devflow
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
devflow_cli-3.0.1-py3-none-any.whl -
Subject digest:
d2f2c55d69591fcd8adf2ee76cb84ffd787c798011a97c89d170ca680c8e8e71 - Sigstore transparency entry: 2582240224
- Sigstore integration time:
-
Permalink:
sopequenoteck/devflow@a9a826ec308b44794bd831a7bdbc5a1072972c0c -
Branch / Tag:
refs/tags/v3.0.1 - Owner: https://github.com/sopequenoteck
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a9a826ec308b44794bd831a7bdbc5a1072972c0c -
Trigger Event:
push
-
Statement type:
