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
# 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

• Workflow adaptatif
• Référence CLI
• Contrats d’activité
• Façade Claude Code
• Guide Cursor

Développement

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