devflow-cli 10.1.0__tar.gz → 10.1.1__tar.gz

devflow_cli-10.1.1/.specify/specs/051-kks-565-adoption-docs/.gitignore

@@ -0,0 +1,2 @@
+# Traces brutes d'agent : elles peuvent contenir le contenu des fichiers lus.
+*.raw.txt

devflow_cli-10.1.1/.specify/specs/051-kks-565-adoption-docs/activity-contract.json

@@ -0,0 +1,169 @@
+{
+  "schemaVersion": 4,
+  "contractId": "KKS-565:standard:review:v4",
+  "issueId": "KKS-565",
+  "profile": "standard",
+  "guardrails": false,
+  "activity": "review",
+  "objective": "Traiter la feature KKS-565",
+  "featurePath": ".specify/specs/051-kks-565-adoption-docs",
+  "inputs": [
+    ".specify/specs/051-kks-565-adoption-docs/need.md",
+    ".specify/specs/051-kks-565-adoption-docs/assessment.json",
+    ".specify/specs/051-kks-565-adoption-docs/workflow-state.json",
+    ".specify/specs/051-kks-565-adoption-docs/prepare-result.json",
+    ".specify/specs/051-kks-565-adoption-docs/implement-result.json",
+    ".specify/specs/051-kks-565-adoption-docs/evidence/targeted-tests.json",
+    ".specify/specs/051-kks-565-adoption-docs/evidence/regression-check.json",
+    ".specify/specs/051-kks-565-adoption-docs/evidence/diff-inspection.json"
+  ],
+  "allowedActions": [
+    "read",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/051-kks-565-adoption-docs/need.md ; en cas d'ecart avec objective, il fait foi.",
+    "Preserver les changements utilisateur sans rapport avec cette activite.",
+    "Ne pas modifier state.json, workflow-state.json ou assessment.json.",
+    "Ne pas creer de commit et ne pas changer de branche.",
+    "Signaler tout blocage au lieu de contourner une validation.",
+    "Dans checks, status vaut passed si et seulement si exitCode vaut 0. Une commande dont l'absence de resultat constitue le succes attendu doit etre declaree failed, ou remplacee par une commande qui renvoie 0 en cas de succes.",
+    "Donner un id stable a chaque objectif de check. Si un check echoue puis est corrige et relance pour le meme objectif, reutiliser cet id : seule la derniere tentative fait foi ; signaler dans remainingRisks toute instabilite encore pertinente.",
+    "Si des sous-agents sont utilises, les lancer au premier plan, jamais en arriere-plan, et attendre qu'ils soient tous termines avant la sortie structuree. La sortie structuree du contrat est le dernier message de l'agent : ne rien envoyer apres elle.",
+    "Ne modifier aucun fichier pendant la review.",
+    "Examiner le besoin, le resultat de preparation, le diff et les preuves reelles.",
+    "Traiter les preuves source=devflow deja validees par verify comme les resultats d'execution de reference; controler leur contenu, leur actualite et leur adequation sans les ignorer.",
+    "Ne pas relancer une commande qui ecrit des artefacts de build dans ce sandbox en lecture seule. Une impossibilite de reecrire target, build ou dist n'est pas un blocker si la preuve Devflow correspondante est actuelle et passed.",
+    "Limiter les checks propres a la review aux inspections effectivement compatibles avec la lecture seule.",
+    "Retourner blocked avec des blockers explicites si un defaut significatif subsiste.",
+    "Ne produire la preuve de review attendue en passed que si le changement est coherent et suffisamment verifie."
+  ],
+  "completionCriteria": [
+    "La conformite de l'implementation aux exigences est examinee.",
+    "Les preuves et risques restants sont pris en compte.",
+    "La preuve de review contient un rapport exploitable."
+  ],
+  "requiredEvidence": [
+    "implementation-review"
+  ],
+  "expectedOutput": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://devflow.dev/schemas/activity-result/v2",
+    "title": "Devflow Activity Result v2",
+    "type": "object",
+    "required": [
+      "schemaVersion",
+      "contractId",
+      "status",
+      "summary",
+      "changedFiles",
+      "checks",
+      "evidence",
+      "remainingRisks",
+      "blockers"
+    ],
+    "properties": {
+      "schemaVersion": {
+        "type": "integer",
+        "const": 2
+      },
+      "contractId": {
+        "type": "string",
+        "minLength": 1
+      },
+      "status": {
+        "type": "string",
+        "enum": [
+          "completed",
+          "blocked"
+        ]
+      },
+      "summary": {
+        "type": "string",
+        "minLength": 1
+      },
+      "changedFiles": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "checks": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "command",
+            "exitCode",
+            "status"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "command": {
+              "type": "string",
+              "minLength": 1
+            },
+            "exitCode": {
+              "type": "integer"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "passed",
+                "failed"
+              ]
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "evidence": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "id",
+            "outcome",
+            "report"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "outcome": {
+              "type": "string",
+              "enum": [
+                "passed",
+                "failed"
+              ]
+            },
+            "report": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "remainingRisks": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "blockers": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "additionalProperties": false
+  }
+}

devflow_cli-10.1.1/.specify/specs/051-kks-565-adoption-docs/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "d6328427-5db7-4e8d-9c9e-f89897a8bfad",
+  "agent": "claude",
+  "activity": "review",
+  "returnCode": 0,
+  "durationSeconds": 64.388,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 4930,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": false,
+  "worktreeChangedFileCount": 0
+}

devflow_cli-10.1.1/.specify/specs/051-kks-565-adoption-docs/assessment.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 4,
+  "issueId": "KKS-565",
+  "recommendedProfile": "standard",
+  "selectedProfile": "standard",
+  "confidence": "medium",
+  "signals": {
+    "scope": "local",
+    "ambiguity": "medium",
+    "risk": "medium",
+    "contractChange": false,
+    "dataOrSecurity": false
+  },
+  "guardrails": {
+    "active": false,
+    "reasons": []
+  },
+  "reasons": [
+    "certaines precisions peuvent etre necessaires",
+    "le risque d'impact est modere"
+  ],
+  "activities": [
+    "assess",
+    "prepare",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "review",
+    "done"
+  ],
+  "requiredEvidence": [
+    "targeted-tests",
+    "regression-check",
+    "diff-inspection",
+    "implementation-review"
+  ],
+  "assessedAt": "2026-10-22T21:54:12Z",
+  "summary": ""
+}

devflow_cli-10.1.1/.specify/specs/051-kks-565-adoption-docs/evidence/diff-inspection.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-10-22T22:18:39Z",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "README.md",
+    "commands/devflow.md",
+    "docs/cli-reference.md",
+    "docs/commands-reference.md",
+    "docs/index.md",
+    "docs/releases/10.1.1.md",
+    "docs/spec-driven.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "tests/test_cmd_feedback.py",
+    "uv.lock"
+  ],
+  "findings": [],
+  "gitDiffCheck": {
+    "id": "AUTO-DIFF",
+    "command": [
+      "git",
+      "diff",
+      "--check"
+    ],
+    "blocking": true,
+    "returncode": 0,
+    "succeeded": true,
+    "timedOut": false,
+    "workingDirectory": ".",
+    "stdout": "",
+    "stderr": ""
+  }
+}

devflow_cli-10.1.1/.specify/specs/051-kks-565-adoption-docs/evidence/regression-check.json

@@ -0,0 +1,114 @@
+{
+  "schemaVersion": 1,
+  "id": "regression-check",
+  "outcome": "passed",
+  "startedAt": "2026-10-22T22:12:59Z",
+  "completedAt": "2026-10-22T22:18:39Z",
+  "commands": [
+    {
+      "id": "AUTO-REGRESSION-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "python",
+        "-m",
+        "compileall",
+        "-q",
+        "src"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-facade-and-release-tests",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_cmd_feedback.py",
+        "tests/test_release.py",
+        "tests/test_installer.py",
+        "tests/test_wheel_install.py",
+        "tests/test_manifest.py",
+        "tests/test_cmd_status.py",
+        "tests/test_version.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 33%]\n........................................................................ [ 67%]\n.....................................................................    [100%]\n213 passed in 2.00s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-full-suite",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [  2%]\n........................................................................ [  5%]\n........................................................................ [  7%]\n........................................................................ [ 10%]\n........................................................................ [ 12%]\n........................................................................ [ 15%]\n........................................................................ [ 18%]\n........................................................................ [ 20%]\n........................................................................ [ 23%]\n........................................................................ [ 25%]\n........................................................................ [ 28%]\n........................................................................ [ 31%]\n........................................................................ [ 33%]\n........................................................................ [ 36%]\n........................................................................ [ 38%]\n........................................................................ [ 41%]\n........................................................................ [ 44%]\n........................................................................ [ 46%]\n........................................................................ [ 49%]\n........................................................................ [ 51%]\n........................................................................ [ 54%]\n........................................................................ [ 56%]\n........................................................................ [ 59%]\n........................................................................ [ 62%]\n........................................................................ [ 64%]\n........................................................................ [ 67%]\n........................................................................ [ 69%]\n........................................................................ [ 72%]\n........................................................................ [ 75%]\n........................................................................ [ 77%]\n........................................................................ [ 80%]\n........................................................................ [ 82%]\n........................................................................ [ 85%]\n........................................................................ [ 88%]\n........................................................................ [ 90%]\n........................................................................ [ 93%]\n........................................................................ [ 95%]\n........................................................................ [ 98%]\n...........................................                              [100%]\n2779 passed in 330.69s (0:05:30)\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-shell-suite",
+      "command": [
+        "./tests/run-tests.sh"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "==============================\n Tests devflow\n==============================\n\n>>> Suite: test-template-variants\n=== Tests create-new-feature.sh --type ===\n-- test_type_brownfield_uses_variant_template\n  [OK]   type brownfield: pas d'avertissement de fallback\n  [OK]   type brownfield: spec.md creee\n  [OK]   type brownfield: contenu du template variant present\n-- test_type_nonexistent_falls_back_to_generic_with_warning\n  [OK]   type nonexistent: avertissement fallback sur stderr\n  [OK]   type nonexistent: spec.md creee malgre le fallback\n  [OK]   type nonexistent: contenu du template generique present\n-- test_without_type_uses_generic_template\n  [OK]   sans --type: pas d'avertissement de fallback\n  [OK]   sans --type: spec.md creee\n  [OK]   sans --type: contenu du template generique present\n-- test_consecutive_features_use_correct_templates (FR-009)\n  [OK]   FR-009: spec brownfield creee (009-*)\n  [OK]   FR-009: spec 009 contient le template brownfield\n  [OK]   FR-009: spec greenfield creee (010-*)\n  [OK]   FR-009: spec 010 contient le template greenfield\n  [OK]   FR-009: spec brownfield ne contient pas le marker greenfield\n\n--- Resultats ---\nTotal: 14 | Passes: 14 | Echoues: 0\nSUCCES\n\n==============================\n Resultats globaux\n==============================\nSuites executees: 1\nTotal tests: 14 | Passes: 14 | Echoues: 0\nSUCCES\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-docs-sync",
+      "command": [
+        "uv",
+        "run",
+        "devflow",
+        "docs-sync",
+        "--check"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "[OK]   Documentation déjà synchronisée.\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-diff-whitespace",
+      "command": [
+        "git",
+        "diff",
+        "--check"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-10.1.1/.specify/specs/051-kks-565-adoption-docs/evidence/targeted-tests.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "id": "targeted-tests",
+  "outcome": "passed",
+  "startedAt": "2026-10-22T22:12:59Z",
+  "completedAt": "2026-10-22T22:18:39Z",
+  "commands": [
+    {
+      "id": "AUTO-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_cmd_feedback.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [ 62%]\n............................................                             [100%]\n116 passed in 1.24s\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-10.1.1/.specify/specs/051-kks-565-adoption-docs/implement-result.json

@@ -0,0 +1,92 @@
+{
+  "schemaVersion": 2,
+  "contractId": "KKS-565:standard:implement:v4",
+  "status": "completed",
+  "summary": "KKS-565 implémentée (10.1.1, lot documentaire, preuve de pré-vol archivée prise en compte). D1 : README réécrit dans l'ordre demandé (présentation en dix lignes de prose, Installer avec Python 3.11+, Git, CLI claude, devflow check, upgrade, délai d'index, phrase sur .devflow-legacy-backup/ et une phrase sur les ruptures majeures ; Premier parcours avec critère d'usage ; Décrire le besoin ; Lire un refus ; Profils et garde-fous resserrés avec renvoi textuel à docs/ ; Synchronisation Linear sans lien ; Développement). Aucun lien Markdown dans le README. Seul point de reprise absent de docs/cli-reference.md : la règle quick documentaire, ajoutée. Les autres y figuraient déjà. Les consignes des sections « Features créées avant devflow 9/8/7/5 » figuraient déjà en substance dans les notes de version 9.0.0, 8.0.0, 7.0.0 et 5.0.0, qui n'ont donc pas été modifiées. D2 : consigne en six lignes identique dans le README et à l'étape 4 de commands/devflow.md. D3 : la règle devflow check, avec sortie en cas d'échec, est placée en préambule de la liste numérotée pour garder la numérotation. La règle sur la constitution est ajoutée à la fin, la règle sur le contrat est conservée. D4 : nouvelle description et nouveaux mots-clés dans pyproject.toml ; docs/spec-driven.md supprimé (non indexé) et son lien retiré de docs/index.md, aucun autre lien trouvé. Version 10.1.1 dans pyproject.toml, __init__.py, uv.lock et CHANGELOG.md, notes dans docs/releases/10.1.1.md. Deux tests ajoutés dans tests/test_cmd_feedback.py : consigne D2 identique dans les deux fichiers, et présence des trois règles dans la façade. Une phrase ajoutée à docs/commands-reference.md pour que la description de la façade cite devflow check.",
+  "changedFiles": [
+    "CHANGELOG.md",
+    "README.md",
+    "commands/devflow.md",
+    "docs/cli-reference.md",
+    "docs/commands-reference.md",
+    "docs/index.md",
+    "docs/releases/10.1.1.md",
+    "docs/spec-driven.md",
+    "pyproject.toml",
+    "src/devflow_cli/__init__.py",
+    "tests/test_cmd_feedback.py",
+    "uv.lock"
+  ],
+  "checks": [
+    {
+      "id": "facade-and-release-tests",
+      "command": "uv run pytest -q tests/test_cmd_feedback.py tests/test_release.py tests/test_installer.py tests/test_wheel_install.py tests/test_manifest.py tests/test_cmd_status.py tests/test_version.py",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "full-suite",
+      "command": "uv run pytest -q",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "shell-suite",
+      "command": "./tests/run-tests.sh",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "docs-sync",
+      "command": "uv run devflow docs-sync --check",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "diff-whitespace",
+      "command": "git diff --check",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "release-version",
+      "command": "uv run python scripts/check_release.py --main-pyproject <scratchpad>/main-pyproject.toml",
+      "exitCode": 0,
+      "status": "passed"
+    },
+    {
+      "id": "readme-no-relative-links",
+      "command": "grep -nE '\\]\\((docs|CHANGELOG|\\.specify)' README.md",
+      "exitCode": 1,
+      "status": "failed"
+    }
+  ],
+  "evidence": [
+    {
+      "id": "readme-links",
+      "outcome": "passed",
+      "report": "grep -nE '\\]\\((docs|CHANGELOG|\\.specify)' README.md et grep -nE '\\]\\(' README.md ne renvoient rien (code 1, succès attendu, déclaré failed dans checks selon la règle du contrat) : le README ne contient plus aucun lien Markdown, contre 12 liens relatifs au pré-vol."
+    },
+    {
+      "id": "test-results",
+      "outcome": "passed",
+      "report": "Tests ciblés : 213 passés (211 au pré-vol, plus les 2 ajoutés). Suite complète : 2779 passés en 261 s. run-tests.sh : 14/14. docs-sync : synchronisée. check_release : 10.1.1 validée face à main en 10.1.0. Le fichier non suivi docs/releases/10.1.1.md n'a aucun espace en fin de ligne et chaque fichier modifié se termine par un seul saut de ligne."
+    }
+  ],
+  "remainingRisks": [
+    "L'aide de la CLI affiche toujours « Spec-Driven Development workflow CLI » (src/devflow_cli/cli.py:35 et :52). need.md interdit de toucher à src/ hormis __init__.py, donc ce texte n'a pas été modifié ; il est à traiter dans un lot ultérieur.",
+    "docs/commands-reference.md n'était pas listé dans need.md : une seule phrase y a été ajoutée pour citer devflow check, afin que la description de la façade ne soit pas fausse. À valider en review.",
+    "La règle devflow check est placée en préambule de la liste numérotée de la façade et non comme étape 1, pour garder la numérotation (need.md parle de « l'étape 4 »).",
+    "Les notes de version 9.0.0, 8.0.0, 7.0.0 et 5.0.0 n'ont pas été modifiées : leurs consignes couvraient déjà en substance les sections retirées du README. Les liens ADR-0002 et ADR-0003 y figurent déjà.",
+    "Le rendu réel sur PyPI et la mise à jour de la façade chez un autre utilisateur par devflow upgrade ne sont prouvables qu'après publication.",
+    "Profil standard et lot qui touche pyproject.toml, uv.lock et __init__.py : ce n'est pas le cas quick documentaire attendu pour la friction 0df6465d. À noter au bilan.",
+    "docs/spec-driven.md est supprimé dans l'arbre de travail mais pas indexé (aucun git add) : il faudra l'indexer au moment du commit."
+  ],
+  "blockers": [],
+  "observation": {
+    "baseRecordedAt": "2026-10-22T22:04:01Z",
+    "baseHead": "bb16f04b5b03a60538d78027740a68144ff5682b",
+    "observedAt": "2026-10-22T22:12:26Z",
+    "head": "bb16f04b5b03a60538d78027740a68144ff5682b"
+  }
+}

devflow_cli-10.1.1/.specify/specs/051-kks-565-adoption-docs/need.md

@@ -0,0 +1,112 @@
+# KKS-565 — Documentation d'adoption : README autosuffisant pour PyPI, consigne need.md, règles de pilotage dans la façade
+
+Source : issue Linear KKS-565, conception du 2026-10-22 avec Kelly (Q1 : Kelly, puis trois amis
+développeurs, puis le public qui découvre Devflow par PyPI ; Q2 A ; Q3 B ; Q4 A ; Q5 A).
+Lot purement documentaire : **aucun code Python ne change**. Constitution, article IV : chaque
+décision répond à un constat.
+
+## Contexte
+
+Le dépôt GitHub est privé et le restera ; les amis n'y seront pas invités. La page PyPI, qui
+affiche `README.md`, est donc la seule surface visible hors de Kelly. Un site statique généré
+depuis `docs/` est différé à l'issue de la phase amis (GitHub Pages indisponible : compte Free,
+dépôt privé).
+
+## Constats
+
+| # | Constat | Où |
+|---|---|---|
+| C1 | Le README (184 lignes) explique les reprises avant l'usage : 60 lignes de motifs de refus et de voies de reprise dans « Parcours quotidien », 30 lignes de ruptures 5/7/8/9. Ni le pourquoi, ni le pour qui, ni ce qu'un parcours produit ne sont écrits. Tous les liens relatifs (`docs/…`, `CHANGELOG.md`, ADR) sont morts sur PyPI. | `README.md` |
+| C2 | `need.md`, entrée de tout parcours, n'a ni gabarit ni description de contenu ; `docs/cli-reference.md` dit seulement « non vide » ; la façade le rédige « à partir de l'issue » sans consigne de forme. Les lots 048 à 050 suivent une structure de fait. | `README.md`, `commands/devflow.md` étape 4 |
+| C3 | Trois règles de pilotage n'existent que dans le `CLAUDE.md` global de Kelly : lancer `devflow check` d'abord et sortir de Devflow s'il échoue ; lire la constitution du projet avant d'implémenter, elle prime sur spec, plan et tâches ; le contrat produit par Devflow fait autorité sur actions, artefacts, validations et preuves. Chez un autre utilisateur, seule la façade existe. | `commands/devflow.md` |
+| C4 | Description PyPI « Spec-Driven Development workflow CLI », mots-clés `spec-driven`, `docs/spec-driven.md` et son lien dans `docs/index.md` : identité abandonnée en 10.0.0. | `pyproject.toml`, `docs/` |
+
+## Décisions (non rediscutables dans ce parcours)
+
+- **D1 — README autosuffisant.** Réécrit dans cet ordre, sans aucun lien vers le dépôt (ni
+  `docs/`, ni `CHANGELOG.md`, ni ADR, ni notes de version) :
+  1. Ce qu'est Devflow, pour qui (un développeur qui travaille avec Claude Code), ce qu'un
+     parcours produit (branche et dossier de feature, besoin écrit, preuves produites
+     localement, journal des retours) — dix lignes au plus.
+  2. Installer (`uv tool install --refresh devflow-cli==X.Y.Z`, `devflow init`, `devflow check`)
+     et mettre à jour (`devflow upgrade` après chaque mise à jour de la CLI ; délai de
+     propagation de l'index). Prérequis : Python 3.11+, Git, CLI `claude`.
+  3. Premier parcours : avec Claude Code, `/devflow ISSUE_ID` ; à la main, `feature`, `need.md`,
+     `assess`, `adaptive start`, `adaptive run`. Critère d'usage en une phrase : une feature avec
+     identifiant d'issue passe par Devflow ; un correctif ponctuel non.
+  4. Décrire le besoin : la consigne D2.
+  5. Lire un refus : chaque refus affiche sa voie de reprise ; refus justifié (travail de l'agent)
+     à corriger puis reprendre ; échec de Devflow à consigner par `devflow feedback add --type
+     friction` ; bilan en fin de parcours. Pas de catalogue des motifs.
+  6. Profils et garde-fous : texte actuel resserré, sans le renvoi au fichier généré ; une
+     phrase indique que la référence complète est livrée dans le dépôt (`docs/`).
+  7. Synchronisation Linear : texte actuel, sans lien.
+  8. Développement : commandes actuelles.
+  Les détails de reprise du README actuel (reconcile, reopen, discard-attempt,
+  structured-output-missing, artifact-files-mismatch, amendement de need.md, approbations,
+  `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`, remise en état des fichiers d'exécution) sont
+  conservés dans `docs/cli-reference.md` : vérifier que chaque point y figure, y ajouter ceux
+  qui manquent, puis les retirer du README. Les quatre sections « Features créées avant
+  devflow 9 / 8 / 7 / 5 » sont déplacées, sans perte, dans les notes de version
+  `docs/releases/9.0.0.md`, `8.0.0.md`, `7.0.0.md` et `5.0.0.md` (si le texte y est déjà, ne pas
+  le dupliquer) ; le README garde une seule phrase : une version majeure refuse sans migration
+  les parcours d'une version majeure antérieure, voir les notes de version du dépôt. La phrase
+  sur `.devflow-legacy-backup/` reste dans la section Installer.
+- **D2 — Consigne `need.md`.** Six lignes, texte identique dans le README (section 4) et à
+  l'étape 4 de la façade `commands/devflow.md` : le besoin dit (1) les constats observés, avec
+  leur origine ; (2) les décisions prises, non rediscutables pendant le parcours ; (3) l'attendu
+  et les tests ; (4) la livraison (version, fichiers de version) ; (5) le hors périmètre ;
+  (6) les contraintes d'exécution. Aucun gabarit généré, aucun refus nouveau.
+- **D3 — Façade `/devflow`.** `commands/devflow.md` (embarqué dans le wheel sous
+  `devflow_cli/resources/commands`, mis à jour chez l'utilisateur par `devflow upgrade`) reçoit
+  les trois règles de C3 : `devflow check` avant toute chose (en échec, sortir de Devflow et le
+  dire) ; constitution du projet (`.specify/memory/constitution.md`) lue avant d'implémenter,
+  elle prime sur spec, plan et tâches ; le contrat produit par Devflow fait autorité. Le reste
+  de la façade ne change pas. `devflow.status.md` ne change pas.
+- **D4 — Métadonnées et identité.** `pyproject.toml` : `description = "Workflow adaptatif pour
+  Claude Code : profils, preuves et contrats d'activité"`, mots-clés sans `spec-driven`
+  (`adaptive`, `workflow`, `cli`, `claude-code`) ; `Homepage` et `Repository` conservés.
+  `docs/spec-driven.md` supprimé et son lien retiré de `docs/index.md` ; vérifier qu'aucun autre
+  document ne le lie.
+
+## Attendu et tests
+
+- Aucun fichier de `src/` ne change, hormis `__init__.py` pour la version.
+- README : chaque section de D1 présente dans l'ordre ; aucun lien relatif vers un fichier du
+  dépôt (`grep -nE '\]\((docs|CHANGELOG|\.specify)' README.md` vide) ; aucune des commandes
+  retirées en 10.0.0 ; `tests/test_release.py` (TC13, TC14 : termes retirés absents du README et
+  de `docs/`) reste vert.
+- `docs/cli-reference.md` contient chaque point de reprise retiré du README.
+- Façade : les trois règles et la consigne D2 présentes dans `commands/devflow.md` ;
+  `tests/test_installer.py` et `tests/test_wheel_install.py` verts ; `devflow upgrade` sur un
+  `~/.claude` simulé signale `commands/devflow.md` obsolète (test existant ou ajouté si absent).
+- `git diff --check` propre ; chaque fichier se termine par un seul saut de ligne.
+- Suite complète verte, `./tests/run-tests.sh` vert, `uv run devflow docs-sync --check` vert.
+
+## Livraison
+
+- Version **10.1.1** : aucune rupture, aucun code ; une ressource embarquée (façade) et les
+  métadonnées du paquet changent. Le contrôle CI exige une version strictement supérieure à
+  celle de `main` (10.1.0). Concordance dans `pyproject.toml`, `src/devflow_cli/__init__.py`,
+  `uv.lock`, `CHANGELOG.md`. Notes dans `docs/releases/10.1.1.md` : ce qui change pour le
+  lecteur de PyPI et pour la façade (`devflow upgrade` à lancer), retour à la 10.1.0.
+- Ce lot est le premier lot purement documentaire en `quick` depuis la 8.1.0 : il sert de cas
+  réel pour la friction `0df6465d` (refus `no-safe-validation` de `verify`). Son issue, quelle
+  qu'elle soit, est notée au bilan.
+
+## Hors périmètre
+
+- Site statique généré depuis `docs/` (différé à l'issue de la phase amis).
+- Gabarit `need.md` généré par `devflow feature` et refus d'un squelette non rempli (option A de
+  Q3, écartée).
+- Bloc Devflow installé dans le `CLAUDE.md` des projets (option B de Q4, écartée).
+- Réécriture de `docs/cli-reference.md`, `docs/activity-contracts.md`, `docs/pipeline.md` et des
+  guides au-delà des ajouts nécessaires à D1.
+- Rendre le dépôt public.
+
+## Contraintes d'exécution
+
+- Le parcours est piloté par la CLI 10.1.0 installée.
+- Aucun test ni aucune activité ne lance un agent réel, ni n'appelle Linear.
+- Aucun commit, aucun `git stash`, aucun changement de branche pendant les activités.
+- La sortie structurée du contrat est le dernier message de l'agent.