devflow-cli 2.8.0__tar.gz → 2.9.0__tar.gz

{devflow_cli-2.8.0 → devflow_cli-2.9.0}/.idea/misc.xml

@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="corretto-21" project-jdk-type="JavaSDK">
     <output url="file://$PROJECT_DIR$/out" />

devflow_cli-2.9.0/.idea/workspace.xml

@@ -0,0 +1,224 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="4d5164b1-14ff-40b3-8f55-b6f2c3abff01" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="EmbeddingIndexingInfo">
+    <option name="cachedIndexableFilesCount" value="1409" />
+    <option name="fileBasedEmbeddingIndicesEnabled" value="true" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="GitHubPullRequestSearchHistory"><![CDATA[{
+  "lastFilter": {
+    "state": "OPEN",
+    "assignee": "sopequenoteck"
+  }
+}]]></component>
+  <component name="GitToolBoxStore">
+    <option name="branchesCleanupHistory">
+      <BranchesCleanupHistory>
+        <option name="history">
+          <list>
+            <BranchCleanupEntry>
+              <option name="deletions">
+                <list>
+                  <BranchDeletion>
+                    <option name="hash" value="861fc6362be269bb7f402d7760f3bf7b565d7460" />
+                    <option name="name" value="017-fix-robustness-issues" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="608c9bc52be63c110d9d2a9a5b4fe919f90c8154" />
+                    <option name="name" value="026-fix-command-ambiguities" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="c9d97356f42487cc635e82f35068c632449e7459" />
+                    <option name="name" value="016-harden-state-machine" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="f6ef9c69dcc416b37b0d7b15cc2bc418adb94445" />
+                    <option name="name" value="008-hardening-bugs" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="cf559e1c5ab82ad66ad5a6ba9ca8bf3c612a8dbe" />
+                    <option name="name" value="001-cli-init-options" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="9c9ac6ba6122577894e95900414ad21c94117675" />
+                    <option name="name" value="003-usecase-guides" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="7fbc2c734b62139eac11b05a5fc51f31bdb482e8" />
+                    <option name="name" value="007-project-documentation" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="a9402192387c3130a0550834b187d4cd022fc28d" />
+                    <option name="name" value="009-ci-pypi" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="babf269c6d664519da2db7d800ff964e24b29765" />
+                    <option name="name" value="022-fix-regen-command" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="1bc969c678242c64fbdd16339cb2569d555b48ea" />
+                    <option name="name" value="014-enforce-state-machine" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="cf559e1c5ab82ad66ad5a6ba9ca8bf3c612a8dbe" />
+                    <option name="name" value="002-cascade-regen" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="711a399e63592a4650e63f53299603b02b19a8e7" />
+                    <option name="name" value="020-migrate-speckit" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="f83a06b13183c09aa274c9713480da13ba690419" />
+                    <option name="name" value="010-flexible-pipeline" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="9ba410df0892ce61400945b739b28df87b2670d5" />
+                    <option name="name" value="004-specify-central-directory" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="b7141bc1dae8a40dbaf8d2440b2cbd7b7fe3650b" />
+                    <option name="name" value="006-template-upgrade" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="449d3673848e3ceabfe85596c7ce8ec7f69e35b5" />
+                    <option name="name" value="005-implement-subphases" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="bd6a5e9b3463a8330f1a4b033c32437498baa909" />
+                    <option name="name" value="027-pipeline-auto-execution" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="b79001ec8e632e99c5337f66fdd9ecfcdca38810" />
+                    <option name="name" value="021-review-iterations" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="e01363f1ba914e75a33565e598ea3c0c83654a6f" />
+                    <option name="name" value="019-quality-hardening" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="86a6c0fcca1d4c5eb6ed1591f5b43d8dc1fd2e46" />
+                    <option name="name" value="013-align-truth-sources" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="5a987e7e2f7f890c3206247b171fa1c36e2fd108" />
+                    <option name="name" value="018-fix-final-robustness" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="4d3bc84a3b655b019e7f3a55569b6fa2681a3e95" />
+                    <option name="name" value="015-fix-review-contradiction" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="661d72db714f24d86b4d8e8895198d3eabb2450e" />
+                    <option name="name" value="feature/git-hooks-auto-promote" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="db082c4529f8cee67b9f82e702e3928f8ba9adcc" />
+                    <option name="name" value="011-cursor-support" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="83a3817a3e6a87553b17065990c842702309c87b" />
+                    <option name="name" value="025-harden-tests" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="7bf297d86fcb2cd560e2a48e13e037c68f80197d" />
+                    <option name="name" value="012-fix-critical-bugs" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="573bfc9a8fb73e4211493a905fb2a5f3aede7ff5" />
+                    <option name="name" value="023-add-logging" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="5fc33e862e6736b67d94690db1117493528cbe85" />
+                    <option name="name" value="024-validate-constants" />
+                  </BranchDeletion>
+                </list>
+              </option>
+              <option name="timestamp" value="1787005388911" />
+            </BranchCleanupEntry>
+          </list>
+        </option>
+      </BranchesCleanupHistory>
+    </option>
+  </component>
+  <component name="GithubPullRequestsUISettings"><![CDATA[{
+  "selectedUrlAndAccountId": {
+    "url": "https://github.com/sopequenoteck/devflow.git",
+    "accountId": "8169ef0d-6593-43b8-9a77-2780a60dc5ac"
+  }
+}]]></component>
+  <component name="McpProjectServerCommands">
+    <commands />
+    <urls />
+  </component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 7,
+  "fromUser": false
+}]]></component>
+  <component name="ProjectId" id="3I2KWolJpZcPmEOGT7J0Rsp6K3n" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ASKED_SHARE_PROJECT_CONFIGURATION_FILES": "true",
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.MCP Project settings loaded": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "SHARE_PROJECT_CONFIGURATION_FILES": "true",
+    "codeWithMe.voiceChat.enabledByDefault": "false",
+    "com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true",
+    "dart.analysis.tool.window.visible": "false",
+    "git-widget-placeholder": "develop",
+    "junie.onboarding.icon.badge.shown": "true",
+    "kotlin-language-version-configured": "true",
+    "last_opened_file_path": "/Users/kellysossoe/Code/Apps/devflow",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "settings.editor.selected.configurable": "settings.sync",
+    "show.migrate.to.gradle.popup": "false",
+    "to.speed.mode.migration.done": "true",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-jdk-30f59d01ecdd-37e91769500f-intellij.indexing.shared.core-IU-261.26222.65" />
+        <option value="bundled-js-predefined-d6986cc7102b-31caf2ab9e3c-JavaScript-IU-261.26222.65" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="4d5164b1-14ff-40b3-8f55-b6f2c3abff01" name="Changes" comment="" />
+      <created>1786957258019</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1786957258019</updated>
+      <workItem from="1786957259143" duration="1286000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+</project>

{devflow_cli-2.8.0 → devflow_cli-2.9.0}/CHANGELOG.md

@@ -5,6 +5,25 @@ Tous les changements notables de ce projet sont documentés dans ce fichier.
 Le format est basé sur [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/),
 et ce projet adhère au [Semantic Versioning](https://semver.org/lang/fr/).
 
+## [2.9.0] - 2026-08-20
+
+### Added
+
+- Workflows adaptatifs exécutables `quick`, `standard`, `deep` et `critical`, avec contrats d'activités structurés pour Codex.
+- Preuves automatiques, worklog régénérable, dérogations contrôlées et réouverture auditée des activités en remédiation.
+- Gates Critical distinctes pour sécurité/données, review indépendante et rollback, avec rejet des suites sensibles sans test réellement exécuté.
+- Cible officielle `devflow init --ai codex` et diagnostic `devflow check --ai codex` sans dépendance à `~/.claude/`.
+
+### Changed
+
+- Les validations nécessitant Docker ou un service externe sont exécutées par la gate locale `verify` plutôt que dans le sandbox de l'agent.
+- La review consomme les preuves Devflow actuelles et réserve ses propres commandes aux inspections compatibles avec la lecture seule.
+
+### Fixed
+
+- Conservation cumulative du périmètre de fichiers lors des reprises d'implémentation.
+- Rejet explicite des résultats Maven sensibles où tous les tests sont ignorés ou aucun bilan de test n'est détectable.
+
 ## [2.8.0] - 2026-08-17
 
 ### Added

devflow_cli-2.9.0/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.5
+Name: devflow-cli
+Version: 2.9.0
+Summary: Spec-Driven Development workflow CLI
+Project-URL: Homepage, https://github.com/sopequenoteck/devflow
+Project-URL: Repository, https://github.com/sopequenoteck/devflow
+Author-email: sopequenoteck <sopequeno.tech@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: claude-code,cli,codex,development,spec-driven,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: pyyaml>=6
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# devflow
+
+[![CI](https://github.com/sopequenoteck/devflow/actions/workflows/ci.yml/badge.svg)](https://github.com/sopequenoteck/devflow/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/devflow-cli)](https://pypi.org/project/devflow-cli/)
+[![License](https://img.shields.io/pypi/l/devflow-cli)](LICENSE)
+
+Toolkit de **Spec-Driven Development** pour Codex, [Claude Code](https://docs.anthropic.com/en/docs/claude-code) et [Cursor](https://cursor.com). Chaque feature passe par un pipeline structuré avec des parcours adaptatifs et des gates de preuve avant d'atteindre le code.
+
+Inspiré de [spec-kit](https://github.com/github/spec-kit).
+
+## Qu'est-ce que devflow ?
+
+devflow impose un workflow séquentiel où chaque feature est spécifiée, planifiée et reviewée **avant** toute ligne de code. Le pipeline complet :
+
+```
+constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done
+```
+
+Les gates de review (`review-spec`, `review-tasks`, `review-impl`) sont bloquantes : aucune progression sans verdict PASS.
+
+Deux interfaces complémentaires :
+- **CLI Python** (`devflow`) — moteur d'état, orchestration, branches, hooks et installation
+- **Contrats adaptatifs** (`devflow adaptive`) — activités portables exécutables avec Codex
+- **Commandes slash** (`/devflow.*`) — interface historique de production et review dans Claude Code
+
+## Prérequis
+
+- **Python 3.11+**
+- **Codex**, **Claude Code** ou **Cursor**
+- **git**
+
+## Installation
+
+```bash
+uv tool install devflow-cli
+```
+
+Ou avec pip :
+
+```bash
+pip install devflow-cli
+```
+
+Pour vérifier l'installation :
+
+```bash
+devflow check --ai codex
+```
+
+> Pour l'installation en mode développeur, voir [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Quick Start
+
+### 1. Initialiser devflow dans votre projet
+
+```bash
+devflow init --ai codex
+```
+
+En mode Codex, cela initialise `.specify/` sans installer de fichiers dans
+`~/.claude/`. Pour l'interface historique Claude Code, utilisez simplement
+`devflow init`.
+
+Vérifiez ensuite l'environnement choisi :
+
+```bash
+devflow check --ai codex
+```
+
+### 2. Créer une feature
+
+```bash
+devflow feature KS-123 --short-name "user-auth"
+```
+
+Crée la branche et le dossier de specs associé.
+
+### 3. Exécuter le pipeline
+
+Depuis le terminal :
+
+```bash
+devflow run KS-123
+```
+
+Avant de lancer le pipeline, `assess` peut recommander un niveau de rigueur
+sans modifier la progression existante :
+
+```bash
+devflow assess KS-123 --scope local --ambiguity low --risk low
+```
+
+La commande écrit `.specify/specs/<feature>/assessment.json`. Les profils
+possibles sont `quick`, `standard`, `deep` et `critical`. Les quatre profils
+disposent d'une machine d'état exécutable :
+
+```bash
+devflow adaptive start KS-123
+devflow adaptive complete KS-123 implement
+devflow adaptive evidence KS-123 targeted-check --report "test ciblé réussi"
+devflow adaptive evidence KS-123 diff-inspection --report "diff relu"
+devflow adaptive complete KS-123 verify
+devflow adaptive complete KS-123 done
+```
+
+Le parcours adaptatif utilise `workflow-state.json` et ne modifie pas le
+`state.json` du pipeline historique.
+
+Tous les profils peuvent exécuter leur activité courante avec Codex :
+
+```bash
+devflow adaptive run KS-123 --agent codex
+```
+
+Une validation planifiée échouée à cause d'une baseline connue peut recevoir
+une dérogation auditée, sans réécrire le plan ou la preuve historique :
+
+```bash
+devflow adaptive waive KS-123 V-05 --reason "Baseline connue et hors diff"
+```
+
+Si une vérification révèle qu'il faut corriger l'implémentation, le retour est
+explicite et audité :
+
+```bash
+devflow adaptive reopen KS-123 implement \
+  --reason "La vérification a révélé un défaut à corriger"
+devflow adaptive run KS-123 --agent codex
+```
+
+La tentative précédente est archivée sous `attempts/`, `reopen-log.json`
+conserve le motif et l'auteur, et le résultat suivant garde le périmètre cumulé
+des fichiers d'implémentation.
+
+Chaque invocation traite une seule activité. `prepare` (standard) analyse le
+dépôt en lecture seule. Deep produit `spec.md`, `plan.md` et `tasks.md`, puis
+réalise une revue indépendante après les preuves. Critical ajoute l'analyse
+des risques, la recherche, les contrats, une preuve sensible non dérogeable,
+une revue indépendante et un contrôle explicite du rollback. `implement` utilise Codex
+avec un résultat JSON structuré ; `verify` est exécutée localement par Devflow, qui
+sélectionne une commande sûre, produit les preuves et contrôle le diff réel.
+Pour une preuve sensible Critical, un code de sortie nul ne suffit pas : une
+suite Maven dont tous les tests sont ignorés est enregistrée en échec.
+
+Un `worklog.md` compact est créé et actualisé automatiquement pendant le
+parcours. Il résume l'objectif, l'évaluation, les fichiers modifiés, les
+validations et les risques, tout en préservant une section de notes manuelles.
+
+Le pipeline historique `devflow run` enchaîne les sessions de l'agent choisi et
+relit `state.json`. Le parcours quotidien recommandé avec Codex utilise
+`devflow adaptive run`, une activité et une gate à la fois.
+
+Pour travailler étape par étape dans Claude Code, lancez les commandes slash dans l'ordre :
+
+```
+/devflow.spec "Description de la feature"
+/devflow.clarify
+/devflow.plan
+/devflow.tasks
+/devflow.implement
+```
+
+Chaque commande produit un artefact (`spec.md`, `plan.md`, `tasks.md`, etc.) et fait avancer la feature dans le pipeline.
+
+### 4. Suivre la progression
+
+```bash
+devflow status
+```
+
+## Documentation
+
+Consultez la [documentation complète](docs/index.md) pour :
+
+- [Pipeline détaillé](docs/pipeline.md) — les 13 étapes expliquées
+- [Commandes CLI](docs/cli-reference.md) — référence des commandes terminal
+- [Commandes slash](docs/commands-reference.md) — référence des 23 commandes Claude Code
+- [Guides par type de projet](docs/index.md#guides-par-type-de-projet) — brownfield, greenfield, microservices
+
+## Contribuer
+
+Les contributions sont les bienvenues. Consultez le [guide de contribution](CONTRIBUTING.md) pour les prérequis, l'installation dev et les conventions.
+
+## English Summary
+
+**devflow** is a Spec-Driven Development toolkit for Codex, [Claude Code](https://docs.anthropic.com/en/docs/claude-code), and [Cursor](https://cursor.com). It provides adaptive quick, standard, deep, and critical workflows with evidence-based gates.
+
+The full pipeline: `constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done`.
+
+**Install:** `uv tool install devflow-cli` (or `pip install devflow-cli`). Requires Python 3.11+, Codex, Claude Code or Cursor, and git.
+
+**Quick start:**
+1. `devflow init --ai codex` — set up an agent-independent project for Codex
+2. `devflow feature KS-123` — create a feature branch
+3. `devflow assess KS-123 ...` → `devflow adaptive start KS-123` → `devflow adaptive run KS-123 --agent codex`
+
+For full documentation, see [docs/index.md](docs/index.md). To contribute, see [CONTRIBUTING.md](CONTRIBUTING.md).

devflow_cli-2.9.0/README.md

@@ -0,0 +1,197 @@
+# devflow
+
+[![CI](https://github.com/sopequenoteck/devflow/actions/workflows/ci.yml/badge.svg)](https://github.com/sopequenoteck/devflow/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/devflow-cli)](https://pypi.org/project/devflow-cli/)
+[![License](https://img.shields.io/pypi/l/devflow-cli)](LICENSE)
+
+Toolkit de **Spec-Driven Development** pour Codex, [Claude Code](https://docs.anthropic.com/en/docs/claude-code) et [Cursor](https://cursor.com). Chaque feature passe par un pipeline structuré avec des parcours adaptatifs et des gates de preuve avant d'atteindre le code.
+
+Inspiré de [spec-kit](https://github.com/github/spec-kit).
+
+## Qu'est-ce que devflow ?
+
+devflow impose un workflow séquentiel où chaque feature est spécifiée, planifiée et reviewée **avant** toute ligne de code. Le pipeline complet :
+
+```
+constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done
+```
+
+Les gates de review (`review-spec`, `review-tasks`, `review-impl`) sont bloquantes : aucune progression sans verdict PASS.
+
+Deux interfaces complémentaires :
+- **CLI Python** (`devflow`) — moteur d'état, orchestration, branches, hooks et installation
+- **Contrats adaptatifs** (`devflow adaptive`) — activités portables exécutables avec Codex
+- **Commandes slash** (`/devflow.*`) — interface historique de production et review dans Claude Code
+
+## Prérequis
+
+- **Python 3.11+**
+- **Codex**, **Claude Code** ou **Cursor**
+- **git**
+
+## Installation
+
+```bash
+uv tool install devflow-cli
+```
+
+Ou avec pip :
+
+```bash
+pip install devflow-cli
+```
+
+Pour vérifier l'installation :
+
+```bash
+devflow check --ai codex
+```
+
+> Pour l'installation en mode développeur, voir [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Quick Start
+
+### 1. Initialiser devflow dans votre projet
+
+```bash
+devflow init --ai codex
+```
+
+En mode Codex, cela initialise `.specify/` sans installer de fichiers dans
+`~/.claude/`. Pour l'interface historique Claude Code, utilisez simplement
+`devflow init`.
+
+Vérifiez ensuite l'environnement choisi :
+
+```bash
+devflow check --ai codex
+```
+
+### 2. Créer une feature
+
+```bash
+devflow feature KS-123 --short-name "user-auth"
+```
+
+Crée la branche et le dossier de specs associé.
+
+### 3. Exécuter le pipeline
+
+Depuis le terminal :
+
+```bash
+devflow run KS-123
+```
+
+Avant de lancer le pipeline, `assess` peut recommander un niveau de rigueur
+sans modifier la progression existante :
+
+```bash
+devflow assess KS-123 --scope local --ambiguity low --risk low
+```
+
+La commande écrit `.specify/specs/<feature>/assessment.json`. Les profils
+possibles sont `quick`, `standard`, `deep` et `critical`. Les quatre profils
+disposent d'une machine d'état exécutable :
+
+```bash
+devflow adaptive start KS-123
+devflow adaptive complete KS-123 implement
+devflow adaptive evidence KS-123 targeted-check --report "test ciblé réussi"
+devflow adaptive evidence KS-123 diff-inspection --report "diff relu"
+devflow adaptive complete KS-123 verify
+devflow adaptive complete KS-123 done
+```
+
+Le parcours adaptatif utilise `workflow-state.json` et ne modifie pas le
+`state.json` du pipeline historique.
+
+Tous les profils peuvent exécuter leur activité courante avec Codex :
+
+```bash
+devflow adaptive run KS-123 --agent codex
+```
+
+Une validation planifiée échouée à cause d'une baseline connue peut recevoir
+une dérogation auditée, sans réécrire le plan ou la preuve historique :
+
+```bash
+devflow adaptive waive KS-123 V-05 --reason "Baseline connue et hors diff"
+```
+
+Si une vérification révèle qu'il faut corriger l'implémentation, le retour est
+explicite et audité :
+
+```bash
+devflow adaptive reopen KS-123 implement \
+  --reason "La vérification a révélé un défaut à corriger"
+devflow adaptive run KS-123 --agent codex
+```
+
+La tentative précédente est archivée sous `attempts/`, `reopen-log.json`
+conserve le motif et l'auteur, et le résultat suivant garde le périmètre cumulé
+des fichiers d'implémentation.
+
+Chaque invocation traite une seule activité. `prepare` (standard) analyse le
+dépôt en lecture seule. Deep produit `spec.md`, `plan.md` et `tasks.md`, puis
+réalise une revue indépendante après les preuves. Critical ajoute l'analyse
+des risques, la recherche, les contrats, une preuve sensible non dérogeable,
+une revue indépendante et un contrôle explicite du rollback. `implement` utilise Codex
+avec un résultat JSON structuré ; `verify` est exécutée localement par Devflow, qui
+sélectionne une commande sûre, produit les preuves et contrôle le diff réel.
+Pour une preuve sensible Critical, un code de sortie nul ne suffit pas : une
+suite Maven dont tous les tests sont ignorés est enregistrée en échec.
+
+Un `worklog.md` compact est créé et actualisé automatiquement pendant le
+parcours. Il résume l'objectif, l'évaluation, les fichiers modifiés, les
+validations et les risques, tout en préservant une section de notes manuelles.
+
+Le pipeline historique `devflow run` enchaîne les sessions de l'agent choisi et
+relit `state.json`. Le parcours quotidien recommandé avec Codex utilise
+`devflow adaptive run`, une activité et une gate à la fois.
+
+Pour travailler étape par étape dans Claude Code, lancez les commandes slash dans l'ordre :
+
+```
+/devflow.spec "Description de la feature"
+/devflow.clarify
+/devflow.plan
+/devflow.tasks
+/devflow.implement
+```
+
+Chaque commande produit un artefact (`spec.md`, `plan.md`, `tasks.md`, etc.) et fait avancer la feature dans le pipeline.
+
+### 4. Suivre la progression
+
+```bash
+devflow status
+```
+
+## Documentation
+
+Consultez la [documentation complète](docs/index.md) pour :
+
+- [Pipeline détaillé](docs/pipeline.md) — les 13 étapes expliquées
+- [Commandes CLI](docs/cli-reference.md) — référence des commandes terminal
+- [Commandes slash](docs/commands-reference.md) — référence des 23 commandes Claude Code
+- [Guides par type de projet](docs/index.md#guides-par-type-de-projet) — brownfield, greenfield, microservices
+
+## Contribuer
+
+Les contributions sont les bienvenues. Consultez le [guide de contribution](CONTRIBUTING.md) pour les prérequis, l'installation dev et les conventions.
+
+## English Summary
+
+**devflow** is a Spec-Driven Development toolkit for Codex, [Claude Code](https://docs.anthropic.com/en/docs/claude-code), and [Cursor](https://cursor.com). It provides adaptive quick, standard, deep, and critical workflows with evidence-based gates.
+
+The full pipeline: `constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done`.
+
+**Install:** `uv tool install devflow-cli` (or `pip install devflow-cli`). Requires Python 3.11+, Codex, Claude Code or Cursor, and git.
+
+**Quick start:**
+1. `devflow init --ai codex` — set up an agent-independent project for Codex
+2. `devflow feature KS-123` — create a feature branch
+3. `devflow assess KS-123 ...` → `devflow adaptive start KS-123` → `devflow adaptive run KS-123 --agent codex`
+
+For full documentation, see [docs/index.md](docs/index.md). To contribute, see [CONTRIBUTING.md](CONTRIBUTING.md).