devflow-cli 1.0.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- devflow_cli/__init__.py +51 -0
- devflow_cli/cli.py +52 -0
- devflow_cli/commands/__init__.py +0 -0
- devflow_cli/commands/check.py +167 -0
- devflow_cli/commands/context.py +173 -0
- devflow_cli/commands/export_cmd.py +149 -0
- devflow_cli/commands/extension.py +137 -0
- devflow_cli/commands/feature.py +102 -0
- devflow_cli/commands/init_cmd.py +94 -0
- devflow_cli/commands/migrate_cmd.py +106 -0
- devflow_cli/commands/regen.py +93 -0
- devflow_cli/commands/status.py +118 -0
- devflow_cli/commands/upgrade_cmd.py +142 -0
- devflow_cli/core/__init__.py +0 -0
- devflow_cli/core/catalog.py +101 -0
- devflow_cli/core/git.py +68 -0
- devflow_cli/core/hooks.py +89 -0
- devflow_cli/core/installer.py +139 -0
- devflow_cli/core/manifest.py +167 -0
- devflow_cli/core/scanner.py +136 -0
- devflow_cli/core/staleness.py +135 -0
- devflow_cli/core/state.py +69 -0
- devflow_cli/utils/__init__.py +0 -0
- devflow_cli/utils/console.py +34 -0
- devflow_cli/utils/paths.py +141 -0
- devflow_cli-1.0.0.dist-info/METADATA +142 -0
- devflow_cli-1.0.0.dist-info/RECORD +30 -0
- devflow_cli-1.0.0.dist-info/WHEEL +4 -0
- devflow_cli-1.0.0.dist-info/entry_points.txt +2 -0
- devflow_cli-1.0.0.dist-info/licenses/LICENSE +21 -0
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: devflow-cli
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: Spec-Driven Development workflow CLI
|
|
5
|
+
Project-URL: Homepage, https://github.com/sopequenoteck/devflow
|
|
6
|
+
Project-URL: Repository, https://github.com/sopequenoteck/devflow
|
|
7
|
+
Author-email: sopequenoteck <sopequeno.tech@gmail.com>
|
|
8
|
+
License: MIT
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Keywords: claude-code,cli,development,spec-driven,workflow
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Environment :: Console
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
17
|
+
Classifier: Topic :: Software Development :: Quality Assurance
|
|
18
|
+
Requires-Python: >=3.11
|
|
19
|
+
Requires-Dist: httpx>=0.27
|
|
20
|
+
Requires-Dist: pyyaml>=6
|
|
21
|
+
Requires-Dist: rich>=13
|
|
22
|
+
Requires-Dist: typer>=0.12
|
|
23
|
+
Provides-Extra: dev
|
|
24
|
+
Requires-Dist: pytest-cov>=5; extra == 'dev'
|
|
25
|
+
Requires-Dist: pytest>=8; extra == 'dev'
|
|
26
|
+
Description-Content-Type: text/markdown
|
|
27
|
+
|
|
28
|
+
# devflow
|
|
29
|
+
|
|
30
|
+
[](https://github.com/sopequenoteck/devflow/actions/workflows/ci.yml)
|
|
31
|
+
[](https://pypi.org/project/devflow-cli/)
|
|
32
|
+
[](LICENSE)
|
|
33
|
+
|
|
34
|
+
Toolkit de **Spec-Driven Development** pour [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Chaque feature passe par un pipeline structuré avec gates de review avant d'atteindre le code.
|
|
35
|
+
|
|
36
|
+
Inspiré de [spec-kit](https://github.com/github/spec-kit).
|
|
37
|
+
|
|
38
|
+
## Qu'est-ce que devflow ?
|
|
39
|
+
|
|
40
|
+
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 :
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Les gates de review (`review-spec`, `review-tasks`, `review-impl`) sont bloquantes : aucune progression sans verdict PASS.
|
|
47
|
+
|
|
48
|
+
Deux interfaces complémentaires :
|
|
49
|
+
- **CLI Python** (`devflow`) — pour gérer les branches, le statut et l'installation
|
|
50
|
+
- **Commandes slash** (`/devflow.*`) — pour piloter le workflow dans Claude Code
|
|
51
|
+
|
|
52
|
+
## Prérequis
|
|
53
|
+
|
|
54
|
+
- **Python 3.11+**
|
|
55
|
+
- **Claude Code** (CLI)
|
|
56
|
+
- **git**
|
|
57
|
+
|
|
58
|
+
## Installation
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
uv tool install devflow-cli
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Ou avec pip :
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
pip install devflow-cli
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Pour vérifier l'installation :
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
devflow check
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
> Pour l'installation en mode développeur, voir [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
77
|
+
|
|
78
|
+
## Quick Start
|
|
79
|
+
|
|
80
|
+
### 1. Initialiser devflow dans votre projet
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
devflow init
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
Cela copie les commandes, agents et templates dans votre configuration Claude Code.
|
|
87
|
+
|
|
88
|
+
### 2. Créer une feature
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
devflow feature KS-123 --short-name "user-auth"
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Crée la branche et le dossier de specs associé.
|
|
95
|
+
|
|
96
|
+
### 3. Suivre le pipeline
|
|
97
|
+
|
|
98
|
+
Dans Claude Code, lancez les commandes slash dans l'ordre :
|
|
99
|
+
|
|
100
|
+
```
|
|
101
|
+
/devflow.spec "Description de la feature"
|
|
102
|
+
/devflow.clarify
|
|
103
|
+
/devflow.plan
|
|
104
|
+
/devflow.tasks
|
|
105
|
+
/devflow.implement
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Chaque commande produit un artefact (`spec.md`, `plan.md`, `tasks.md`, etc.) et fait avancer la feature dans le pipeline.
|
|
109
|
+
|
|
110
|
+
### 4. Suivre la progression
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
devflow status
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## Documentation
|
|
117
|
+
|
|
118
|
+
Consultez la [documentation complète](docs/index.md) pour :
|
|
119
|
+
|
|
120
|
+
- [Pipeline détaillé](docs/pipeline.md) — les 13 étapes expliquées
|
|
121
|
+
- [Commandes CLI](docs/cli-reference.md) — référence des 11 commandes terminal
|
|
122
|
+
- [Commandes slash](docs/commands-reference.md) — référence des 23 commandes Claude Code
|
|
123
|
+
- [Guides par type de projet](docs/index.md#guides-par-type-de-projet) — brownfield, greenfield, microservices
|
|
124
|
+
|
|
125
|
+
## Contribuer
|
|
126
|
+
|
|
127
|
+
Les contributions sont les bienvenues. Consultez le [guide de contribution](CONTRIBUTING.md) pour les prérequis, l'installation dev et les conventions.
|
|
128
|
+
|
|
129
|
+
## English Summary
|
|
130
|
+
|
|
131
|
+
**devflow** is a Spec-Driven Development toolkit for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It enforces a structured pipeline where every feature goes through specification, planning, and review gates before any code is written.
|
|
132
|
+
|
|
133
|
+
The full pipeline: `constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done`.
|
|
134
|
+
|
|
135
|
+
**Install:** `uv tool install devflow-cli` (or `pip install devflow-cli`). Requires Python 3.11+, Claude Code CLI, git.
|
|
136
|
+
|
|
137
|
+
**Quick start:**
|
|
138
|
+
1. `devflow init` — set up devflow in your project
|
|
139
|
+
2. `devflow feature KS-123` — create a feature branch
|
|
140
|
+
3. `/devflow.spec "..."` → `/devflow.plan` → `/devflow.tasks` → `/devflow.implement` — follow the pipeline in Claude Code
|
|
141
|
+
|
|
142
|
+
For full documentation, see [docs/index.md](docs/index.md). To contribute, see [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
devflow_cli/__init__.py,sha256=pdaWiv6opWxczLu9BcHNUQQqeeOVp702swwquzGZMKk,888
|
|
2
|
+
devflow_cli/cli.py,sha256=PaoxyJ7Fi-orfy_ZT5f7wtcFkllqSw4yP6aNI0W7aCI,1383
|
|
3
|
+
devflow_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
4
|
+
devflow_cli/commands/check.py,sha256=tPZiPRjxROk-pTrchXnSa_jVLMxIE-Rc520o7nPNLM8,4703
|
|
5
|
+
devflow_cli/commands/context.py,sha256=umZSPg9JJSn8wWINOlLbTpP0QBtVf6VkNPmNoepxJmE,5998
|
|
6
|
+
devflow_cli/commands/export_cmd.py,sha256=Mdvoh8oyainm0ulaaLd3pcx9m2s-Go--fFBeLS6i9Ts,4871
|
|
7
|
+
devflow_cli/commands/extension.py,sha256=gL33YS8EuBTADmqKGDqw_0gJXFwccwg1uJmCNtvexhE,4373
|
|
8
|
+
devflow_cli/commands/feature.py,sha256=33HGF_lFegtFW09ay6MwH5a98-LHKeYN2Tc6OIeZVSU,3669
|
|
9
|
+
devflow_cli/commands/init_cmd.py,sha256=AsUWxKPnMZgJBzVx83BfrTJOqXWJu_SJ1j23yJIzv3w,3694
|
|
10
|
+
devflow_cli/commands/migrate_cmd.py,sha256=Tp_AMuHbo9ENqvJWW6YlFcgrRLPyKOnTk9p4zAMKsXU,3358
|
|
11
|
+
devflow_cli/commands/regen.py,sha256=UyB7_0oBxDs_CqaAQ6yE2Yoz4IcpUr2bqkIEmm0e1iM,3198
|
|
12
|
+
devflow_cli/commands/status.py,sha256=4JJ8ZWVqAiS88G1I7HaGG7Mf0Z7cyGr2UzX-41cSHJ8,4065
|
|
13
|
+
devflow_cli/commands/upgrade_cmd.py,sha256=tc2h0RjyH4aMf_wCnbMU6k8slkf0kbmbMEbJ1ZJCjas,4878
|
|
14
|
+
devflow_cli/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
15
|
+
devflow_cli/core/catalog.py,sha256=oMBZRigOtpAQceu3slV8UpuKSZpkxQcr4xtjZXyFHYY,2949
|
|
16
|
+
devflow_cli/core/git.py,sha256=xvzo0y8b3xNVss_p1fmf5LaIRgkRJzjkoJBUsxxnKqw,2101
|
|
17
|
+
devflow_cli/core/hooks.py,sha256=EHIlpwmDYHshaDijiLCEoPDbnV9T7jDttOCnpRRx0HU,3025
|
|
18
|
+
devflow_cli/core/installer.py,sha256=ljnAOmvpu33EdP9O8QYSpmjUgR1sGZcikTA7SxuW2Ck,4435
|
|
19
|
+
devflow_cli/core/manifest.py,sha256=5hu2w6PPGo4raGbgKzx6qpAtt653SrzpRkbWngHM9qw,5770
|
|
20
|
+
devflow_cli/core/scanner.py,sha256=hHyw7YTYY_UCHFYNvzC_-_tvQcdWOSm90kmKiK_f8mM,4307
|
|
21
|
+
devflow_cli/core/staleness.py,sha256=NCW0adRNwMXlQHt-xS1K_0t83SjBMF7FR0fyuY8t6FM,4609
|
|
22
|
+
devflow_cli/core/state.py,sha256=Kzt1M1l2rn4UA-wS8MzdkJM6Jz-GhwMxqBhN_c3kkdw,1953
|
|
23
|
+
devflow_cli/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
24
|
+
devflow_cli/utils/console.py,sha256=t7cpyeEluWj4v_O_KFSI59iqXK4GiSXPuxlsr8q5zoQ,771
|
|
25
|
+
devflow_cli/utils/paths.py,sha256=iQH6TUd7s4CfKCS3EJ0Xd6b8iDMSq9RD1c8ieD85Hp4,4372
|
|
26
|
+
devflow_cli-1.0.0.dist-info/METADATA,sha256=WArcH2pilVT1TKbOtjvJquW4gDIl5BEJYp46Pz19pyI,4844
|
|
27
|
+
devflow_cli-1.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
|
|
28
|
+
devflow_cli-1.0.0.dist-info/entry_points.txt,sha256=GVJ6bMvFpqyO5589iC4nFKeGTpGIW8aKn_QPPpSZ6kU,48
|
|
29
|
+
devflow_cli-1.0.0.dist-info/licenses/LICENSE,sha256=v79PvnmqOdKhQiOa_QcWxng4q8GuGscLOwi7ygUpwpo,1070
|
|
30
|
+
devflow_cli-1.0.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 sopequenoteck
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|