qdd-framework 2.6.2 → 2.8.0-rc.1
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.
- package/README.md +28 -15
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,28 +19,41 @@ npm install -g qdd-framework
|
|
|
19
19
|
|
|
20
20
|
## ⚡ Comandos Principales
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
22
|
+
```bash
|
|
23
|
+
cd mi-proyecto
|
|
24
|
+
qdd init # detecta el stack (también monorepos) y conecta tu IA
|
|
25
|
+
qdd audit # corre las pruebas y las reglas de QDD; funciona desde cualquier subcarpeta
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
- `qdd init`: Inicializa QDD en el proyecto, detecta el stack (Node, Go, Java/Kotlin, Python, Dart/Flutter, Rust, PHP, Ruby, .NET) y conecta tu IA (Claude Code, Cursor, Antigravity, OpenCode) por MCP. En un proyecto sin código: `qdd init --lenguaje Go --arquitectura "API REST"`.
|
|
29
|
+
- `qdd audit`: Corre las pruebas del proyecto y revisa las reglas de QDD (Zero-Else, OWASP, Clean Code, despliegues sin pruebas, fichas y blueprints). Separa lo que bloquea de las recomendaciones (adopción gradual).
|
|
30
|
+
- `qdd certify`: Audita, calcula el puntaje y lo guarda en el historial de calidad. `qdd certify human` certifica usabilidad y accesibilidad (WCAG 2.2).
|
|
31
|
+
- `qdd modules`: Fichas de módulo (objetivo, invariantes y pruebas de cada módulo). `qdd modules approve <id>` las aprueba; `qdd modules context <rutas>` muestra lo que recibe la IA.
|
|
32
|
+
- `qdd blueprint add | apply | list | show`: Importa los estándares de módulo de tu organización desde su propio repositorio y genera la ficha de cada módulo.
|
|
33
|
+
- `qdd doctor`: Diagnóstico determinista de salud del entorno.
|
|
34
|
+
- `qdd report`: Reporte ejecutivo consolidado en formato Texto, Markdown o JSON para CI/CD.
|
|
35
|
+
- `qdd evolution`: Recomienda la siguiente mejora del proyecto.
|
|
28
36
|
- `qdd dashboard`: Centro de Comando Web interactivo con streaming en tiempo real (SSE) y ejecución de agentes.
|
|
29
|
-
- `qdd run`: Pipeline secuencial de comandos o modo supervisor con auto-reparación (`qdd run --keep-alive`).
|
|
37
|
+
- `qdd run`: Pipeline secuencial de comandos con rollback, o modo supervisor con auto-reparación (`qdd run --keep-alive`).
|
|
30
38
|
|
|
31
39
|
---
|
|
32
40
|
|
|
33
41
|
## 🤖 Integración con Inteligencia Artificial (MCP Server)
|
|
34
42
|
|
|
35
|
-
|
|
43
|
+
`qdd init` registra el servidor MCP de QDD y escribe sus reglas para **Claude Code**, **Cursor**, **Google Antigravity** y **OpenCode** (`AGENTS.md`). Con eso, tu IA:
|
|
44
|
+
|
|
45
|
+
- llama a `qdd_project_context` antes de cambiar código y respeta la ficha y las invariantes del módulo;
|
|
46
|
+
- aplica los blueprints de tu organización y te hace a ti sus preguntas de diseño;
|
|
47
|
+
- no commitea ni despliega sin pasar `qdd_audit`.
|
|
48
|
+
|
|
49
|
+
Pídeselo en lenguaje natural:
|
|
50
|
+
|
|
51
|
+
```text
|
|
52
|
+
/qdd "agrega el blueprint de notificaciones y construye el módulo"
|
|
53
|
+
/qdd "resuelve el bug de conexión y genera el finding"
|
|
54
|
+
```
|
|
36
55
|
|
|
37
|
-
-
|
|
38
|
-
- `/qdd validate`
|
|
39
|
-
- `/qdd certify`
|
|
40
|
-
- `/qdd resolve` (Equipo Resolutor FAANG)
|
|
41
|
-
- `/qdd report`
|
|
42
|
-
- `/qdd evolution`
|
|
43
|
-
- `/qdd docs`
|
|
56
|
+
Todos los comandos y tools: [Command Reference](https://github.com/trdago/qdd-framework/blob/main/docs/command-reference.md) · [Blueprints](https://github.com/trdago/qdd-framework/blob/main/docs/blueprints.md) · [Getting Started](https://github.com/trdago/qdd-framework/blob/main/docs/getting-started.md)
|
|
44
57
|
|
|
45
58
|
---
|
|
46
59
|
|