@tacuchi/agent-workflow-cli 7.1.2 → 7.2.0
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 +10 -10
- package/dist/application/checkpoint-service.d.ts +2 -2
- package/dist/application/checkpoint-service.d.ts.map +1 -1
- package/dist/application/checkpoint-service.js +2 -2
- package/dist/application/checkpoint-service.js.map +1 -1
- package/dist/application/phase-detect-service.d.ts +1 -1
- package/dist/application/phase-detect-service.d.ts.map +1 -1
- package/dist/application/phase-detect-service.js +1 -1
- package/dist/application/phase-detect-service.js.map +1 -1
- package/dist/application/session-close-service.d.ts +1 -1
- package/dist/application/session-close-service.d.ts.map +1 -1
- package/dist/application/session-close-service.js +1 -1
- package/dist/application/session-close-service.js.map +1 -1
- package/dist/application/session-resume-service.d.ts +3 -3
- package/dist/application/session-resume-service.d.ts.map +1 -1
- package/dist/application/session-resume-service.js +3 -3
- package/dist/application/session-resume-service.js.map +1 -1
- package/dist/cli/tui/tabs/plugins-tab.d.ts.map +1 -1
- package/dist/cli/tui/tabs/plugins-tab.js +61 -19
- package/dist/cli/tui/tabs/plugins-tab.js.map +1 -1
- package/package.json +1 -1
- package/skills/agent-workflow/doctrine/doctor/SKILL.md +3 -3
- package/skills/agent-workflow/doctrine/hub-init/SKILL.md +1 -1
- package/skills/agent-workflow/doctrine/implement/references/design-md-template.md +2 -2
- package/skills/agent-workflow/doctrine/project-init/SKILL.md +1 -1
- package/skills/agent-workflow/doctrine/refactor/references/strangler-checklist.md +1 -1
- package/skills/agent-workflow/doctrine/resume/SKILL.md +2 -2
- package/skills/agent-workflow/doctrine/rules/SKILL.md +13 -13
- package/skills/agent-workflow/doctrine/session/SKILL.md +4 -4
- package/skills/agent-workflow/doctrine/session/references/branch-verification.md +1 -1
- package/skills/agent-workflow/doctrine/session/references/commits-policy.md +6 -6
- package/skills/agent-workflow/doctrine/session/references/graduacion-routing.md +1 -1
- package/skills/agent-workflow/doctrine/session/references/lifecycle-deep.md +1 -1
- package/skills/agent-workflow/doctrine/session/references/prompts/M1-closure-commit-prompt.md +2 -2
- package/skills/agent-workflow/doctrine/session/references/prompts-catalog.md +3 -3
- package/skills/agent-workflow/doctrine/session/references/sandbox-readonly-rules.md +1 -1
- package/skills/agent-workflow/exports/export-arq/SKILL.md +1 -1
- package/skills/agent-workflow/exports/export-arq/references/lexico-tecnico.md +1 -1
- package/skills/agent-workflow/exports/export-arq/references/template-c4.md +6 -6
- package/skills/agent-workflow/exports/export-arq/references/template-plantuml.puml +1 -1
- package/skills/agent-workflow/exports/export-arq/references/template-structurizr.dsl +1 -1
- package/skills/agent-workflow/exports/export-plan/references/template-plan.md +2 -2
- package/skills/agent-workflow/exports/export-report/SKILL.md +1 -1
- package/skills/agent-workflow/exports/export-report/references/lexico.md +5 -5
- package/skills/agent-workflow/exports/export-tech-manuals/references/template-manual.md +1 -1
- package/skills/agent-workflow/specialties/design-brief/SKILL.md +2 -2
- package/skills/agent-workflow/standards/coding-standards/references/fe-be-integration.md +2 -2
- package/skills/agent-workflow/standards/coding-standards/references/frontend-structure.md +1 -1
- package/skills/agent-workflow/standards/coding-standards/references/java-spring.md +1 -1
- package/skills/agent-workflow/standards/coding-standards/references/project-structure.md +25 -25
- package/skills/agent-workflow/standards/redaccion-simple/SKILL.md +5 -5
|
@@ -26,7 +26,7 @@ Template canónico copy-paste-friendly para producir el `DESIGN.md` de una sesi
|
|
|
26
26
|
- <2-4 bullets de anti-scope explícito (qué NO toca).>
|
|
27
27
|
|
|
28
28
|
## Current state
|
|
29
|
-
<ASCII flow del estado actual. Citar paths concretos (com
|
|
29
|
+
<ASCII flow del estado actual. Citar paths concretos (com.<empresa>.<dominio>..., src/...).>
|
|
30
30
|
|
|
31
31
|
```
|
|
32
32
|
<diagrama ASCII de flow / componentes actuales>
|
|
@@ -86,7 +86,7 @@ None
|
|
|
86
86
|
## Reglas de redacción
|
|
87
87
|
|
|
88
88
|
- **Frases cortas**. Listas sobre prosa larga.
|
|
89
|
-
- **Citar paths concretos** en current/target state: `com
|
|
89
|
+
- **Citar paths concretos** en current/target state: `com.<empresa>.<dominio>.core.service.PdfRenderer`, `src/cli/menu.tsx`, `mscore-delivery-spring/...`.
|
|
90
90
|
- **DD sin alternativa descartada** es sospechoso — el AI debe forzarse a buscar una. Si genuinamente no hay alternativa razonable, escribirlo explícito ("Alternativas descartadas: ninguna razonable; era la única opción que respeta <constraint>").
|
|
91
91
|
- **Open questions vacías** = `None`. Nunca omitir la sección.
|
|
92
92
|
- **No copiar código completo de impl** en `## New interfaces` — sólo firmas. La impl va en Phase 0 tasks.
|
|
@@ -8,7 +8,7 @@ version: 1.0.0
|
|
|
8
8
|
|
|
9
9
|
# Project Init
|
|
10
10
|
|
|
11
|
-
Bootstrap del bloque AW-PROJECT para un workspace **single-repo** (project mode). El bloque es la memoria permanente del proyecto y lo lee toda la familia
|
|
11
|
+
Bootstrap del bloque AW-PROJECT para un workspace **single-repo** (project mode). El bloque es la memoria permanente del proyecto y lo lee toda la familia agent-workflow (sessions, doctor, hooks).
|
|
12
12
|
|
|
13
13
|
## Cuándo usar
|
|
14
14
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Strangler Fig — checklist de 12 pasos para refactor
|
|
2
2
|
|
|
3
|
-
Pasos canónicos del skill `agent-workflow:refactor`. Reflejan Strangler Fig (Fowler) adaptado al stack
|
|
3
|
+
Pasos canónicos del skill `agent-workflow:refactor`. Reflejan Strangler Fig (Fowler) adaptado al stack agent-workflow con flujo phased y prompts M7/M8/M6 + S7 (pre-Phase 0). M9 retirado en v2.8+ por DEC-002 de session049 — reemplazado por S7 desde planning closure.
|
|
4
4
|
|
|
5
5
|
## Discovery (paso 1-2)
|
|
6
6
|
|
|
@@ -27,8 +27,8 @@ Output:
|
|
|
27
27
|
{
|
|
28
28
|
"active_sessions": ["session046-dev-jobs-async"],
|
|
29
29
|
"primary_session": "session046-dev-jobs-async",
|
|
30
|
-
"
|
|
31
|
-
"
|
|
30
|
+
"phase_from_aw_project": "execution",
|
|
31
|
+
"branches_from_aw_project": ["mscore-solicitud-spring=feature/session046"],
|
|
32
32
|
"checkpoint_present": true,
|
|
33
33
|
"checkpoint": {
|
|
34
34
|
"actualizado": "2026-04-25 20:14",
|
|
@@ -1,23 +1,23 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: rules
|
|
3
|
-
description: "Bundle invokable de reglas transversales
|
|
3
|
+
description: "Bundle invokable de reglas transversales agent-workflow — carga los 7 anchors canónicos (commits, sandbox plan-mode, MCP read-only, redacción, coding-standards, graduación, branch verification) en un solo lugar. Invocar antes de un commit ad-hoc fuera de `/agent-workflow:session`, antes de editar código sin sesión activa, durante onboarding de usuario nuevo a agent-workflow, o cuando se quiera refrescar el contrato agent-workflow en una conversación larga. No requiere sesión activa. v0.2.0: el anchor `agent-workflow:commits-policy` ahora documenta el propose-then-execute universal con AskUserQuestion M1 (cualquier solicitud o mención de commit, en/fuera de sesión, hub/project) + el bypass por mensaje literal."
|
|
4
4
|
version: 0.2.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
> **Profile parametrization**: lee `custom_anchors[]` de `profile.json` (resuelto vía cascade 5 capas). Ver [`references/profile-parametrization.md`](../../references/profile-parametrization.md) para el contrato completo y comportamiento por defecto cuando el profile está vacío.
|
|
8
8
|
|
|
9
|
-
# Rules — Bundle invokable de reglas transversales
|
|
9
|
+
# Rules — Bundle invokable de reglas transversales agent-workflow
|
|
10
10
|
|
|
11
|
-
Skill agregadora que **carga las reglas transversales del runtime
|
|
11
|
+
Skill agregadora que **carga las reglas transversales del runtime agent-workflow** en un solo entry point. No reemplaza al AGENTS.md/CLAUDE.md por fuente (anchor passive de system-prompt); complementa con activación on-demand cuando se necesita refrescar el contrato.
|
|
12
12
|
|
|
13
13
|
Cada sección abajo cita el canon de su anchor — el AI lee el archivo completo cuando la regla requiere precisión (parámetros, casos edge). Acá quedan los headers, las reglas operativas y "cómo aplicar fuera de sesión".
|
|
14
14
|
|
|
15
15
|
## Cuándo invocar
|
|
16
16
|
|
|
17
17
|
- **Antes de un commit ad-hoc fuera de `/agent-workflow:session close`** — para refrescar la política de commits (formato, tag, prohibiciones) si el usuario te pide commitear.
|
|
18
|
-
- **Antes de editar código en una fuente
|
|
18
|
+
- **Antes de editar código en una fuente agent-workflow sin sesión activa** — para cargar coding-standards y la sandbox plan-mode.
|
|
19
19
|
- **Antes de ejecutar una query vía MCP `<mcp-cert>`/`<mcp-prod>`** — para refrescar el contrato read-only y reconocer cuándo proponer script SQL en lugar de mutación.
|
|
20
|
-
- **Durante onboarding** de un usuario nuevo a
|
|
20
|
+
- **Durante onboarding** de un usuario nuevo a agent-workflow — bundle único que reemplaza leer 7 archivos sueltos.
|
|
21
21
|
- **En conversaciones largas** donde el contexto qtc se diluyó — refresh rápido.
|
|
22
22
|
- Explícitamente con `Skill(agent-workflow:rules)` o por NL ("qué reglas qtc tengo", "antes de commitear", "refrescá el contrato qtc").
|
|
23
23
|
|
|
@@ -42,7 +42,7 @@ Reglas operativas:
|
|
|
42
42
|
- El tag `session<NNN>` **no aplica** (no hay sesión); el mensaje sugerido lo omite.
|
|
43
43
|
- Mensaje sigue siendo 1 línea, descriptivo, sin co-author/firma/`--no-verify`.
|
|
44
44
|
- **Sí hay propose-then-execute automático**: el AI llama `agent-workflow sources` (sin `--session`) y dispara M1 igual que en closure. Es el mismo prompt, con tag omitido del mensaje sugerido.
|
|
45
|
-
- Workspace no
|
|
45
|
+
- Workspace no agent-workflow (sin `AW-PROJECT`): no hay `sources` disponible. El AI sugiere 1-line msg en chat, espera confirmación, ejecuta. M1 no se invoca en ese contexto.
|
|
46
46
|
|
|
47
47
|
---
|
|
48
48
|
|
|
@@ -51,7 +51,7 @@ Reglas operativas:
|
|
|
51
51
|
**Canon**: `agent-workflow/skills/session/references/sandbox-readonly-rules.md`.
|
|
52
52
|
|
|
53
53
|
Resumen:
|
|
54
|
-
- Canon universal
|
|
54
|
+
- Canon universal agent-workflow. Cubre Claude Code (plan mode), Codex (sandbox read-only), Copilot (read-only), Warp y cualquier harness equivalente.
|
|
55
55
|
- Se activa por system-reminder del host (`Plan mode is active`, `EnterPlanMode`, sandbox read-only flag, etc.).
|
|
56
56
|
- En plan mode: el AI **describe en el plan file** qué haría en lugar de ejecutarlo. No crea/edita archivos, no ejecuta git/npm/SQL mutante.
|
|
57
57
|
|
|
@@ -61,7 +61,7 @@ Reglas operativas:
|
|
|
61
61
|
- Matriz por subcomando CLI: ver §"Plan-mode-safe vs NO seguros" en el canon.
|
|
62
62
|
|
|
63
63
|
**Cómo aplicar fuera de sesión**:
|
|
64
|
-
- Aplica igual — el disparador es el system-reminder del host, no el lifecycle
|
|
64
|
+
- Aplica igual — el disparador es el system-reminder del host, no el lifecycle agent-workflow.
|
|
65
65
|
- Si la skill se carga fuera de sesión y el host está en plan mode, **describir el output en el plan file** sin ejecutar.
|
|
66
66
|
|
|
67
67
|
---
|
|
@@ -92,7 +92,7 @@ Reglas operativas (defensa en profundidad):
|
|
|
92
92
|
**Canon**: `agent-workflow/skills/redaccion-simple/SKILL.md`.
|
|
93
93
|
|
|
94
94
|
Resumen:
|
|
95
|
-
- Guía universal de estilo para toda prosa que produzca el AI en contexto
|
|
95
|
+
- Guía universal de estilo para toda prosa que produzca el AI en contexto agent-workflow: artefactos `.md` de sesión, commit messages, descripciones de PR, READMEs ad-hoc, respuestas en chat sobre runtime/skills agent-workflow.
|
|
96
96
|
- 6 reglas: frases cortas (≤15 palabras), listas sobre prosa, una idea por línea, "qué + por qué" en una línea, sin jerga inventada, sin relleno ("es importante notar…", "cabe destacar…").
|
|
97
97
|
|
|
98
98
|
Reglas operativas por artefacto:
|
|
@@ -124,7 +124,7 @@ Reglas operativas:
|
|
|
124
124
|
- Ramas: `feature/` `fix/` `hotfix/` + kebab.
|
|
125
125
|
|
|
126
126
|
**Cómo aplicar fuera de sesión**:
|
|
127
|
-
- Aplican igual a cualquier edit de código
|
|
127
|
+
- Aplican igual a cualquier edit de código agent-workflow o consumer. Sin sesión, la composición desde `dev-workflow`/`implement` no ocurre — depende de que el harness host enganche `coding-standards` por description engaging o de que `agent-workflow:rules` se invoque.
|
|
128
128
|
|
|
129
129
|
---
|
|
130
130
|
|
|
@@ -200,9 +200,9 @@ Tabla rápida para situaciones comunes sin sesión activa:
|
|
|
200
200
|
|---|---|---|
|
|
201
201
|
| Pedís un commit ad-hoc | commits-policy regla 2 + regla 3 universal | M1 propose-then-execute con `agent-workflow sources` (sin `--session`). Mensaje sugerido sin tag `session<NNN>`, sin co-author, sin `--no-verify`. |
|
|
202
202
|
| Pedís commit con mensaje literal en la solicitud | commits-policy regla 5 | Bypass de M1; el AI ejecuta `git commit -m "<literal>"` directo (validando rama, hooks, Regla 2). |
|
|
203
|
-
| Editás código de fuente
|
|
203
|
+
| Editás código de fuente agent-workflow | coding-standards + branch-verification | Verificar rama (`agent-workflow sources`); aplicar reglas de stack. |
|
|
204
204
|
| Ejecutás query MCP cert/prod | mcp-readonly | Sólo SELECT/EXPLAIN. Mutación → script en `docs/scripts/`. |
|
|
205
|
-
| Escribís prosa
|
|
205
|
+
| Escribís prosa agent-workflow (PR description, README) | redaccion-simple | 6 reglas (frases cortas, listas, sin jerga). |
|
|
206
206
|
| Producís artefacto curable (decisión, manual) | graduacion-routing | Crear sesión retroactiva o documentar como fuera de scope graduable. |
|
|
207
207
|
| Host en plan mode | sandbox-readonly | Describir en plan file, no ejecutar mutaciones. |
|
|
208
208
|
|
|
@@ -217,7 +217,7 @@ Compatible con plan mode sin restricciones adicionales.
|
|
|
217
217
|
## Referencias
|
|
218
218
|
|
|
219
219
|
- **session SKILL** (`../session/SKILL.md`) — lifecycle universal donde estas reglas se invocan por composición durante las 4 fases.
|
|
220
|
-
- **shared-contract** (`../../docs/shared-contract.md`) — contrato cross-plugin de la familia
|
|
220
|
+
- **shared-contract** (`../../docs/shared-contract.md`) — contrato cross-plugin de la familia agent-workflow.
|
|
221
221
|
- **Recomendación de uso conjunto con AGENTS.md/CLAUDE.md**:
|
|
222
222
|
- El AGENTS.md/CLAUDE.md por fuente (o el bloque transversal en hub) lista 1 línea por anchor con su path canon. Sirve como "tabla de contenidos" siempre cargada.
|
|
223
223
|
- Esta skill `agent-workflow:rules` carga los 7 anchors expandidos. Sirve cuando se necesita refrescar el contrato o cuando el AGENTS.md no está disponible.
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: session
|
|
3
|
-
description: Lifecycle universal de sesiones
|
|
3
|
+
description: Lifecycle universal de sesiones agent-workflow en 4 fases (planning/execution/validation/closure). Crea, retoma, lista o cierra sesiones componiendo skills de especialidad según el flow elegido (dev/design/analyze). Auto-plan antes de editar código. Topic-change detection en execution. Closure propone commits por fuente afectada (propose-then-execute). Invocado solo vía /agent-workflow:session.
|
|
4
4
|
version: 4.3.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
# Session — Lifecycle universal
|
|
7
|
+
# Session — Lifecycle universal agent-workflow v3.0
|
|
8
8
|
|
|
9
|
-
Skill **único** y **universal** para el ciclo de vida de sesiones de toda la familia
|
|
9
|
+
Skill **único** y **universal** para el ciclo de vida de sesiones de toda la familia agent-workflow. Vive en agent-workflow; los flow plugins son especialistas standalone vía `/agent-workflow:use` y declaran su comportamiento como workflow consumido por este skill.
|
|
10
10
|
|
|
11
11
|
## Cuándo se invoca
|
|
12
12
|
|
|
@@ -380,4 +380,4 @@ agent-workflow sessions [--include-legacy]
|
|
|
380
380
|
- **`references/auto-plan-rules.md`** — disparadores skip/lite/full.
|
|
381
381
|
- **`references/sandbox-readonly-rules.md`** — reglas universales de plan mode (canon).
|
|
382
382
|
- **shared-contract.md §14-§19** — contrato del lifecycle universal.
|
|
383
|
-
- **`agent-workflow:redaccion-simple`** — guía transversal de redacción para todos los artefactos
|
|
383
|
+
- **`agent-workflow:redaccion-simple`** — guía transversal de redacción para todos los artefactos agent-workflow (frases cortas, listas, sin jerga). Aplicar al escribir OBJECTIVE/TASKS/DECISIONS/EVIDENCE/FINDINGS/CONCLUSIONS/CHECKPOINT/STATUS/PROBLEM/IDEAS/DELIVERY.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Verificación de rama de trabajo — Referencia canónica (agent-workflow)
|
|
2
2
|
|
|
3
|
-
> Documento canónico de la familia
|
|
3
|
+
> Documento canónico de la familia agent-workflow para validación y orquestación de ramas. Referenciado por `skills/session/SKILL.md` y el hook PreToolUse (`agent-workflow hook branch-check`). Los flow plugins (qtc-dev, qtc-design, qtc-analyze) **no duplican** este flujo — apuntan acá.
|
|
4
4
|
|
|
5
5
|
## Contexto
|
|
6
6
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# commits-policy — política controlada de commits
|
|
1
|
+
# commits-policy — política controlada de commits agent-workflow
|
|
2
2
|
|
|
3
3
|
Anchor canónico: `agent-workflow:commits-policy`. Referenciable cross-plugin desde cualquier skill via path relativo o nombre.
|
|
4
4
|
|
|
@@ -47,7 +47,7 @@ docs: actualiza shared-contract con anchor commits-policy
|
|
|
47
47
|
```
|
|
48
48
|
# multilinea (body extra prohibido)
|
|
49
49
|
feat: agrega politica
|
|
50
|
-
Esta política aplica a toda la familia
|
|
50
|
+
Esta política aplica a toda la familia agent-workflow.
|
|
51
51
|
|
|
52
52
|
# co-author trailer (prohibido)
|
|
53
53
|
session007: agrega politica
|
|
@@ -60,7 +60,7 @@ session007: agrega politica
|
|
|
60
60
|
|
|
61
61
|
### Caso fuera de sesión activa
|
|
62
62
|
|
|
63
|
-
Si el usuario pide un commit fuera del contexto de sesión
|
|
63
|
+
Si el usuario pide un commit fuera del contexto de sesión agent-workflow (ej. workspace sin AW-PROJECT, o trabajo ad-hoc), el formato se relaja a "1 línea + sin co-author"; el tag `session<NNN>` no aplica. El propose-then-execute de Regla 3 sigue activo — la única diferencia es que el mensaje sugerido omite el tag.
|
|
64
64
|
|
|
65
65
|
## Regla 3 — propose-then-execute universal con AskUserQuestion
|
|
66
66
|
|
|
@@ -70,12 +70,12 @@ Disparadores canónicos:
|
|
|
70
70
|
|
|
71
71
|
1. **Closure de `/agent-workflow:session`** (auto): antes de `session-close`, el skill `session` ejecuta el flujo M1 sobre las fuentes con `dirty=true`. Documentado en `skills/session/SKILL.md` §"Cerrar sesión — 2. Proponer commits".
|
|
72
72
|
2. **Solicitud explícita del usuario con sesión activa** ("commitea esto", "guardá los cambios", "subí los cambios" sin mensaje literal): el AI llama `agent-workflow sources --session <CODE>` y dispara M1 según el resultado.
|
|
73
|
-
3. **Solicitud explícita del usuario sin sesión activa** (workspace
|
|
74
|
-
4. **Solicitud del usuario en workspace no
|
|
73
|
+
3. **Solicitud explícita del usuario sin sesión activa** (workspace agent-workflow hub/project sin sesiones registradas en `AW-PROJECT.Status`): el AI llama `agent-workflow sources` (sin `--session`) y dispara M1. El tag `session<NNN>` del mensaje sugerido se omite (Regla 2).
|
|
74
|
+
4. **Solicitud del usuario en workspace no agent-workflow** (sin `AW-PROJECT`): no hay `sources` disponible. El AI cae al flujo simple — sugiere 1-line msg en chat y espera confirmación antes de ejecutar. No invoca `AskUserQuestion`.
|
|
75
75
|
|
|
76
76
|
Pasos del flujo M1:
|
|
77
77
|
|
|
78
|
-
1. Llamar a `agent-workflow sources [--session <CODE>?]`. Si la salida es inválida (workspace no
|
|
78
|
+
1. Llamar a `agent-workflow sources [--session <CODE>?]`. Si la salida es inválida (workspace no agent-workflow) → ver disparador 4 arriba.
|
|
79
79
|
2. Si hay 1+ fuentes con `dirty=true`, invocar **una sola** `AskUserQuestion` con N questions tab-por-fuente (N = #fuentes-dirty, máx 4 simultáneas). Spec literal → `prompts-catalog.md#M1`. Resumen:
|
|
80
80
|
- Header de cada tab: `<alias>` puro.
|
|
81
81
|
- 2 opciones explícitas: "Aprobar sugerido (Recomendado)" con el mensaje canónico / "Saltar esta fuente".
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Graduación: regla hub vs project (DEC-002)
|
|
2
2
|
|
|
3
|
-
Regla canónica para decidir **dónde** se gradúa un artefacto al cerrar una sesión
|
|
3
|
+
Regla canónica para decidir **dónde** se gradúa un artefacto al cerrar una sesión agent-workflow. Reemplaza la regla anterior "hub-vs-fuente con prompt M12".
|
|
4
4
|
|
|
5
5
|
## Regla absoluta
|
|
6
6
|
|
|
@@ -23,7 +23,7 @@ Output: `{harness: "claude-code"|"codex"|"unknown", supports_plan_subagent: bool
|
|
|
23
23
|
### Prompt al Plan agent (CC)
|
|
24
24
|
|
|
25
25
|
```
|
|
26
|
-
Estructurá un plan accionable (TASKS.md) para esta sesión
|
|
26
|
+
Estructurá un plan accionable (TASKS.md) para esta sesión agent-workflow.
|
|
27
27
|
|
|
28
28
|
OBJECTIVE:
|
|
29
29
|
<contenido de .workflow/sessions/<folder>/OBJECTIVE.md>
|
package/skills/agent-workflow/doctrine/session/references/prompts/M1-closure-commit-prompt.md
CHANGED
|
@@ -10,7 +10,7 @@ El AI invoca M1 ante **cualquiera** de estos 3 disparadores canónicos. La condi
|
|
|
10
10
|
|
|
11
11
|
1. **Closure de `/agent-workflow:session`** (auto): antes de `session-close`, el skill `session` ejecuta `agent-workflow sources --session <CODE>` y dispara M1 si hay 1+ fuentes `dirty=true`. Documentado en `skills/session/SKILL.md` §"Cerrar sesión — 2. Proponer commits".
|
|
12
12
|
2. **Solicitud explícita con sesión activa** (planning/execution): el usuario dice "commitea esto", "guardá los cambios", "subí lo nuevo" sin mensaje literal. El AI ejecuta `agent-workflow sources --session <CODE>` y dispara M1 igual que en closure. El mensaje sugerido incluye tag `session<NNN>`.
|
|
13
|
-
3. **Solicitud explícita sin sesión activa**: el usuario pide commit en una fuente
|
|
13
|
+
3. **Solicitud explícita sin sesión activa**: el usuario pide commit en una fuente agent-workflow (hub o project) que no tiene sesión registrada en `AW-PROJECT.Status.Sesiones activas`. El AI ejecuta `agent-workflow sources` (sin `--session`) y dispara M1. El mensaje sugerido **omite** el tag `session<NNN>`.
|
|
14
14
|
|
|
15
15
|
## Forma
|
|
16
16
|
|
|
@@ -37,7 +37,7 @@ Si el usuario aporta el mensaje exacto en la solicitud (`"commitea con mensaje '
|
|
|
37
37
|
|
|
38
38
|
Si el mensaje literal viola Regla 2 (multi-línea, co-author, etc.), el AI avisa antes de ejecutar y pide confirmación. No reescribe silenciosamente.
|
|
39
39
|
|
|
40
|
-
### Workspace no
|
|
40
|
+
### Workspace no agent-workflow (sin AW-PROJECT)
|
|
41
41
|
|
|
42
42
|
`agent-workflow sources` falla → no hay fuentes que enumerar. El AI cae al flujo simple: sugiere 1-line msg en chat, espera confirmación, ejecuta. No invoca M1.
|
|
43
43
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# Catálogo de prompts interactivos
|
|
1
|
+
# Catálogo de prompts interactivos agent-workflow — referencia canónica
|
|
2
2
|
|
|
3
|
-
> Anchor: `agent-workflow:prompts-catalog`. Documento canónico que define **cuándo y cómo** los skills de la familia
|
|
3
|
+
> Anchor: `agent-workflow:prompts-catalog`. Documento canónico que define **cuándo y cómo** los skills de la familia agent-workflow deben usar `AskUserQuestion` (Claude Code) o equivalente. Referenciado desde `skills/session/SKILL.md`, `references/commits-policy.md`, `references/branch-verification.md` y los workflows de los flow plugins. Los SKILL apuntan acá; el spec literal de cada punto vive en `prompts/<id>-<slug>.md` (1 archivo por prompt) y este catálogo es el index.
|
|
4
4
|
>
|
|
5
5
|
> Origen: session009-analyze-prompts-interactivos-session (propuesta). Ver `DECISIONES.md` de esa sesión para el razonamiento de DEC-001..008.
|
|
6
6
|
>
|
|
@@ -145,7 +145,7 @@ Spec: [`prompts/C2-cost-guard.md`](prompts/C2-cost-guard.md). Cuándo: query cos
|
|
|
145
145
|
Cuando no hay tool nativo, el AI imprime una lista numerada y espera respuesta:
|
|
146
146
|
|
|
147
147
|
```
|
|
148
|
-
[Sesión
|
|
148
|
+
[Sesión agent-workflow — decisión] <pregunta>
|
|
149
149
|
|
|
150
150
|
1. <option 1 label> — <description>
|
|
151
151
|
2. <option 2 label> — <description>
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Sandbox read-only — reglas universales (agent-workflow)
|
|
2
2
|
|
|
3
|
-
> Canon universal de la familia
|
|
3
|
+
> Canon universal de la familia agent-workflow. Cubre Claude Code "Plan mode", Codex sandbox read-only, Copilot read-only, y cualquier harness equivalente. Los flow plugins referencian esta versión y mantienen una copia local sólo si necesitan reglas adicionales propias.
|
|
4
4
|
|
|
5
5
|
Cuando el sistema indica que el AI está en sandbox read-only (Claude Code: system-reminder con `Plan mode is active` o `EnterPlanMode`; Codex: sandbox read-only; otros: harness con write disabled):
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: export-arq
|
|
3
|
-
description: "Genera documentación técnica de arquitectura (`.md` con diagramas C4 embebidos) consolidando sesiones del workspace + `docs/` (especificaciones, decisiones, arq existente). Output: contexto, contenedores, componentes, integraciones externas, modelo de datos (si MCP disponible), decisiones arquitectónicas y riesgos/deuda. Structurizr DSL por default (notación C4 formal); Mermaid y PlantUML opt-in vía `--diagrams`. Output en `docs/arquitectura/NNN-export-arq-YYYY-MM-DD/`. Read-only sobre corpus + MCP read-only para schemas. Audiencia: devs/arquitectos. Invocado sólo vía `/agent-workflow:export-arq`.
|
|
3
|
+
description: "Genera documentación técnica de arquitectura (`.md` con diagramas C4 embebidos) consolidando sesiones del workspace + `docs/` (especificaciones, decisiones, arq existente). Output: contexto, contenedores, componentes, integraciones externas, modelo de datos (si MCP disponible), decisiones arquitectónicas y riesgos/deuda. Structurizr DSL por default (notación C4 formal); Mermaid y PlantUML opt-in vía `--diagrams`. Bloques Mermaid embebidos incluyen link `https://mermaid.ink/img/<base64>` para preview sin renderer local. Output en `docs/arquitectura/NNN-export-arq-YYYY-MM-DD/`. Read-only sobre corpus + MCP read-only para schemas. Audiencia: devs/arquitectos. Invocado sólo vía `/agent-workflow:export-arq`. Historial de versiones en CHANGELOG del CLI bundleado."
|
|
4
4
|
version: 1.3.0
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -49,7 +49,7 @@ HACK:
|
|
|
49
49
|
|
|
50
50
|
**Excepciones autorizadas** (V2 las exime):
|
|
51
51
|
- La sección `## Referencias` puede contener placeholders esperados (ej. `docs/arquitectura/NNN-...` como path tipo).
|
|
52
|
-
- El header puede contener identificadores del producto que sean canónicos (ej. "
|
|
52
|
+
- El header puede contener identificadores del producto que sean canónicos (ej. "agent-workflow").
|
|
53
53
|
|
|
54
54
|
## Cómo validar
|
|
55
55
|
|
|
@@ -66,7 +66,7 @@ Variante de diagrama: {{DIAGRAMS_ENGINE}}.
|
|
|
66
66
|
## Integraciones externas
|
|
67
67
|
|
|
68
68
|
<!-- Sistemas externos con los que el workspace interactúa.
|
|
69
|
-
Para
|
|
69
|
+
Para agent-workflow runtime hub: MCP servers, hooks PreToolUse, marketplace, npm registry.
|
|
70
70
|
Tabla + opcional sequenceDiagram para flows críticos.
|
|
71
71
|
Condicional por scope: aparece si --scope ∈ {integraciones, todo}. -->
|
|
72
72
|
|
|
@@ -121,7 +121,7 @@ Variante de diagrama: {{DIAGRAMS_ENGINE}}.
|
|
|
121
121
|
|
|
122
122
|
Nombre del sistema/producto desde `AW-PROJECT.proyecto`. Si la descripción es larga, usar la primera frase (≤10 palabras). Capitalización natural (no mayúsculas a la fuerza).
|
|
123
123
|
|
|
124
|
-
Ejemplo: `Runtime
|
|
124
|
+
Ejemplo: `Runtime agent-workflow` o `Sistema de mantenimiento de parámetros`.
|
|
125
125
|
|
|
126
126
|
### `{{FECHA_SNAPSHOT}}`
|
|
127
127
|
|
|
@@ -147,9 +147,9 @@ Bloque Mermaid `C4Context`. Ejemplo de estructura:
|
|
|
147
147
|
|
|
148
148
|
```
|
|
149
149
|
C4Context
|
|
150
|
-
title Diagrama de Contexto: Runtime
|
|
150
|
+
title Diagrama de Contexto: Runtime agent-workflow
|
|
151
151
|
Person(dev, "Developer", "Miembro del equipo")
|
|
152
|
-
System(sistema, "Runtime
|
|
152
|
+
System(sistema, "Runtime agent-workflow", "Coordinación de sesiones")
|
|
153
153
|
System_Ext(claude, "Claude Code", "Host AI")
|
|
154
154
|
System_Ext(codex, "Codex", "Host AI alternativo")
|
|
155
155
|
System_Ext(npm, "npm registry", "Distribución CLI")
|
|
@@ -171,9 +171,9 @@ Bloque Mermaid `C4Container` con un contenedor por fuente. Ejemplo:
|
|
|
171
171
|
|
|
172
172
|
```
|
|
173
173
|
C4Container
|
|
174
|
-
title Diagrama de Contenedores: Runtime
|
|
174
|
+
title Diagrama de Contenedores: Runtime agent-workflow
|
|
175
175
|
Person(dev, "Developer")
|
|
176
|
-
System_Boundary(sistema, "Runtime
|
|
176
|
+
System_Boundary(sistema, "Runtime agent-workflow") {
|
|
177
177
|
Container(cli, "agent-workflow CLI", "Node.js / TypeScript", "Línea de comandos del runtime")
|
|
178
178
|
Container(plugin, "agent-workflow", "Markdown skills + hooks", "Skills y comandos invocables")
|
|
179
179
|
Container(marketplace, "qtc-plugins-marketplace", "JSON manifest", "Distribución del plugin")
|
|
@@ -24,7 +24,7 @@ title {{PRODUCTO}} — Diagrama de Contexto C4
|
|
|
24
24
|
' ===== Sistema bajo análisis =====
|
|
25
25
|
{{SYSTEM_PUML}}
|
|
26
26
|
' Ejemplo render esperado:
|
|
27
|
-
' System(sistema, "Runtime
|
|
27
|
+
' System(sistema, "Runtime agent-workflow", "Coordinación de sesiones")
|
|
28
28
|
|
|
29
29
|
' ===== Sistemas externos =====
|
|
30
30
|
{{EXTERNAL_SYSTEMS_PUML}}
|
|
@@ -23,7 +23,7 @@ workspace "{{PRODUCTO}}" "{{DESCRIPCION_CORTA}}" {
|
|
|
23
23
|
// ===== Sistema bajo análisis =====
|
|
24
24
|
{{SYSTEM_DSL}}
|
|
25
25
|
// Ejemplo render esperado:
|
|
26
|
-
// sistema = softwareSystem "Runtime
|
|
26
|
+
// sistema = softwareSystem "Runtime agent-workflow" "Coordinación de sesiones" {
|
|
27
27
|
// cli = container "agent-workflow CLI" "Node.js + TypeScript" "Línea de comandos"
|
|
28
28
|
// plugin = container "agent-workflow" "Markdown skills + JSON hooks" "Skills y comandos"
|
|
29
29
|
// marketplace = container "qtc-plugins-marketplace" "JSON manifest" "Distribución"
|
|
@@ -91,7 +91,7 @@ state_changes:
|
|
|
91
91
|
|
|
92
92
|
## Resumen
|
|
93
93
|
|
|
94
|
-
Consolidación de la propuesta familia `/agent-workflow:export-*` (session055) y el dev de export-scripts (session061) en un plan ejecutable que cubra los gaps restantes del bundle. Audiencia: equipo runtime
|
|
94
|
+
Consolidación de la propuesta familia `/agent-workflow:export-*` (session055) y el dev de export-scripts (session061) en un plan ejecutable que cubra los gaps restantes del bundle. Audiencia: equipo runtime agent-workflow. Output esperado: 2-3 sesiones dev secuenciadas que cierren docs/conclusiones/007.
|
|
95
95
|
|
|
96
96
|
## Fases
|
|
97
97
|
|
|
@@ -119,7 +119,7 @@ Total: ≈8.5h en 3 tareas (3 abiertas).
|
|
|
119
119
|
|
|
120
120
|
## Dependencias externas
|
|
121
121
|
|
|
122
|
-
- Ninguna externa al runtime
|
|
122
|
+
- Ninguna externa al runtime agent-workflow.
|
|
123
123
|
|
|
124
124
|
## Riesgos
|
|
125
125
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: export-report
|
|
3
|
-
description: "Genera un informe funcional ejecutivo (`.md`) consolidando el corpus de sesiones del workspace y `docs/`, dirigido a gerencia/jefatura/comité. Variante B default (≤760 palabras
|
|
3
|
+
description: "Genera un informe funcional ejecutivo (`.md`) consolidando el corpus de sesiones del workspace y `docs/`, dirigido a gerencia/jefatura/comité. Variante B default (≤760 palabras), A (400w compacto) y C (1620w extenso) derivadas vía `--audiencia`. Estructura: Objetivo, Componentes impactados, Diagrama de flujo Mermaid (`flowchart LR` con link `mermaid.ink` para preview), Oportunidades de mejora. Output en `docs/funcional/NNN-export-report-YYYY-MM-DD.md`. Read-only sobre el corpus; sin commits autónomos. Aplica tabla determinista de traducción técnico→ejecutiva y valida cota + léxico vetado post-generación. Invocado sólo vía `/agent-workflow:export-report`. Historial de versiones en CHANGELOG del CLI bundleado."
|
|
4
4
|
version: 1.7.0
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -23,8 +23,8 @@ Tabla determinista que el skill `export-report` aplica durante el render (Paso 6
|
|
|
23
23
|
| graduación · graduate · graduado | "publicación final" · "publicado" |
|
|
24
24
|
| hub mode · hub workspace · workspace hub | "área de trabajo común" · "espacio de coordinación" |
|
|
25
25
|
| Strangler Fig · opt-in · opt-out | (omitir; usar "migración progresiva" / "activación opcional") |
|
|
26
|
-
| harness · runtime · runtime
|
|
27
|
-
|
|
|
26
|
+
| harness · runtime · runtime agent-workflow | "entorno de trabajo del equipo" · "sistema" |
|
|
27
|
+
| agent-workflow · agent-workflow:rules · agent-workflow:session · agent-workflow:commits-policy · `/agent-workflow:*` | (omitir; usar "el sistema" · "las reglas comunes" · "el ciclo de trabajo") |
|
|
28
28
|
| Codex · Claude Code · Warp · Oz | "herramientas del equipo" (genérico) salvo que el contexto justifique nombrarlas |
|
|
29
29
|
| DEC-NNN | "decisión documentada N°NNN" · "una decisión" |
|
|
30
30
|
| TUI · CLI · TTY | "interfaz textual" · "interfaz de línea de comandos" |
|
|
@@ -51,7 +51,7 @@ Tabla determinista que el skill `export-report` aplica durante el render (Paso 6
|
|
|
51
51
|
### Ejemplo 1 — Resumen ejecutivo
|
|
52
52
|
|
|
53
53
|
**Antes (técnico)**:
|
|
54
|
-
> El runtime
|
|
54
|
+
> El runtime agent-workflow incorporó un nuevo hook PreToolUse que valida el branch antes de cada Edit/Write. Se migraron 36 sesiones legacy al formato canónico y se retiró el M9 contract-review en favor del DESIGN.md + S7 gate.
|
|
55
55
|
|
|
56
56
|
**Después (ejecutivo)**:
|
|
57
57
|
> El sistema incorporó controles automáticos que validan la línea de trabajo activa antes de cada cambio. Se completó la migración de ciclos de trabajo antiguos al formato común y se reemplazó la revisión técnica intermedia por una revisión de diseño previa.
|
|
@@ -112,7 +112,7 @@ agent-workflow
|
|
|
112
112
|
agent-workflow:rules
|
|
113
113
|
agent-workflow:session
|
|
114
114
|
agent-workflow:commits-policy
|
|
115
|
-
|
|
115
|
+
agent-workflow
|
|
116
116
|
agent-workflow:
|
|
117
117
|
/agent-workflow:
|
|
118
118
|
postmortem
|
|
@@ -133,7 +133,7 @@ Strangler Fig
|
|
|
133
133
|
opt-in
|
|
134
134
|
opt-out
|
|
135
135
|
harness
|
|
136
|
-
runtime
|
|
136
|
+
runtime agent-workflow
|
|
137
137
|
Codex
|
|
138
138
|
Claude Code
|
|
139
139
|
Warp
|
|
@@ -64,7 +64,7 @@ Plantilla para un manual técnico individual. Cada archivo del dossier `docs/man
|
|
|
64
64
|
|
|
65
65
|
Título descriptivo en oración (no en infinitivo de comando). Ejemplos:
|
|
66
66
|
- "Configurar un servidor MCP de consulta a base de datos"
|
|
67
|
-
- "Crear y cerrar una sesión
|
|
67
|
+
- "Crear y cerrar una sesión agent-workflow desde cero"
|
|
68
68
|
- "Migrar sesiones legacy al formato común"
|
|
69
69
|
|
|
70
70
|
### `{{SESIONES_ORIGEN}}`
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: design-brief
|
|
3
|
-
description: Capta el brief inicial de una sesión de diseño y declara el `## Type` (project|system). Invocado desde la fase planning del lifecycle universal
|
|
3
|
+
description: Capta el brief inicial de una sesión de diseño y declara el `## Type` (project|system). Invocado desde la fase planning del lifecycle universal de agent-workflow cuando el OBJECTIVE menciona UI/UX/diseño/pantalla/mockup/wireframe. Produce OBJECTIVE.md con secciones Type, Brief, Context y Acceptance criteria. No produce código ni mocks aún — sólo capturar QUÉ y POR QUÉ.
|
|
4
4
|
version: 1.1.0
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
# design-brief —
|
|
7
|
+
# design-brief — agent-workflow v1.0+
|
|
8
8
|
|
|
9
9
|
Specialty skill **design**: capta el brief y el tipo de sesión durante la fase `planning` del lifecycle universal.
|
|
10
10
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# FE-BE Integration — reglas transversales
|
|
2
2
|
|
|
3
|
-
> Anchor: `agent-workflow:fe-be-integration`. Reglas canónicas para la integración Frontend ↔ Backend en proyectos
|
|
3
|
+
> Anchor: `agent-workflow:fe-be-integration`. Reglas canónicas para la integración Frontend ↔ Backend en proyectos agent-workflow a partir de qtc-dev v2.6 (session013) — actualizado en v2.7 (session015) para reflejar el modelo phased extendido Phase 0-5. Aplica a sesiones `flow=dev` con `## Type: feature|refactor` y a refactors guiados por el skill `agent-workflow:refactor`.
|
|
4
4
|
>
|
|
5
5
|
> Origen: session013-dev-flujo-feature-refactor-phased + session015-dev-aplicar-flujo-fases-extendido. Prior art: [JSON Merge Patch RFC 7396](https://datatracker.ietf.org/doc/html/rfc7396), [Walking Skeleton — Cockburn](https://codeclimate.com/blog/kickstart-your-next-project-with-a-walking-skeleton), [CQRS — Microsoft Learn](https://learn.microsoft.com/en-us/azure/architecture/patterns/cqrs).
|
|
6
6
|
|
|
@@ -292,7 +292,7 @@ Reglas qtc-dev/coding-standards/database-conventions.md siguen aplicando (header
|
|
|
292
292
|
|
|
293
293
|
- `agent-workflow:coding-standards/references/java-spring.md` — convenciones Spring Boot (Constructor Injection, @Transactional, records).
|
|
294
294
|
- `agent-workflow:coding-standards/references/angular-typescript.md` — convenciones Angular (HttpClient, ApiService, environments).
|
|
295
|
-
- `agent-workflow:coding-standards/references/database-conventions.md` — convenciones BD
|
|
295
|
+
- `agent-workflow:coding-standards/references/database-conventions.md` — convenciones BD agent-workflow (schemas, naming, scripts).
|
|
296
296
|
- `agent-workflow:implement/SKILL.md` — phased mode (Phase 0/1/2 + gate M6 entre phases; S7 design-review antes de Phase 0 desde planning closure).
|
|
297
297
|
- `agent-workflow:refactor/SKILL.md` — Strangler Fig para refactors completos.
|
|
298
298
|
- `agent-workflow:prompts-catalog#M6,S7` — gates phased (S7 design-review antes de Phase 0; M6 entre phases). M9 retirado v2.8+.
|
|
@@ -169,7 +169,7 @@ public class ControllerExceptionHandler {
|
|
|
169
169
|
|
|
170
170
|
## Estructura de proyecto
|
|
171
171
|
|
|
172
|
-
Ver `references/project-structure.md` para la estructura completa de paquetes, entidades, repositories, services, wrappers request/response y convención de DTOs
|
|
172
|
+
Ver `references/project-structure.md` para la estructura completa de paquetes, entidades, repositories, services, wrappers request/response y convención de DTOs de tu ecosistema.
|
|
173
173
|
|
|
174
174
|
## Queries SQL
|
|
175
175
|
|
|
@@ -1,43 +1,43 @@
|
|
|
1
1
|
# Estructura de Proyecto Backend
|
|
2
2
|
|
|
3
|
-
Convenciones de estructura para microservicios Spring Boot
|
|
3
|
+
Convenciones de estructura para microservicios Spring Boot. Sustituir `<empresa>` por el namespace de tu organización (e.g., `qtc`, `acme`).
|
|
4
4
|
|
|
5
5
|
## Paquete base
|
|
6
6
|
|
|
7
|
-
`com
|
|
7
|
+
`com.<empresa>.[dominio]` → ejemplos: `com.acme.credito`, `com.acme.mantenimiento`, `com.acme.solicitud`.
|
|
8
8
|
|
|
9
9
|
## Estructura de paquetes
|
|
10
10
|
|
|
11
11
|
Dos variantes en uso (ambas válidas, seguir la del proyecto actual):
|
|
12
12
|
|
|
13
13
|
```
|
|
14
|
-
com
|
|
15
|
-
com
|
|
16
|
-
com
|
|
17
|
-
com
|
|
18
|
-
com
|
|
19
|
-
com
|
|
20
|
-
com
|
|
21
|
-
com
|
|
22
|
-
com
|
|
23
|
-
com
|
|
24
|
-
com
|
|
25
|
-
com
|
|
26
|
-
com
|
|
27
|
-
com
|
|
28
|
-
com
|
|
29
|
-
com
|
|
30
|
-
com
|
|
31
|
-
com
|
|
14
|
+
com.<empresa>.[dominio].core.controller
|
|
15
|
+
com.<empresa>.[dominio].core.service
|
|
16
|
+
com.<empresa>.[dominio].core.service.impl
|
|
17
|
+
com.<empresa>.[dominio].core.service.generico
|
|
18
|
+
com.<empresa>.[dominio].core.repository
|
|
19
|
+
com.<empresa>.[dominio].core.model
|
|
20
|
+
com.<empresa>.[dominio].core.request
|
|
21
|
+
com.<empresa>.[dominio].core.request.dto
|
|
22
|
+
com.<empresa>.[dominio].core.response
|
|
23
|
+
com.<empresa>.[dominio].core.response.dto
|
|
24
|
+
com.<empresa>.[dominio].core.config
|
|
25
|
+
com.<empresa>.[dominio].core.exception
|
|
26
|
+
com.<empresa>.[dominio].core.common
|
|
27
|
+
com.<empresa>.[dominio].core.util
|
|
28
|
+
com.<empresa>.[dominio].core.feign
|
|
29
|
+
com.<empresa>.[dominio].core.seguridad
|
|
30
|
+
com.<empresa>.[dominio].core.aspect
|
|
31
|
+
com.<empresa>.[dominio].core.advice
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
Variante sin `core`:
|
|
35
35
|
```
|
|
36
|
-
com
|
|
37
|
-
com
|
|
38
|
-
com
|
|
39
|
-
com
|
|
40
|
-
com
|
|
36
|
+
com.<empresa>.[dominio].controller
|
|
37
|
+
com.<empresa>.[dominio].service / service.impl
|
|
38
|
+
com.<empresa>.[dominio].repository
|
|
39
|
+
com.<empresa>.[dominio].model
|
|
40
|
+
com.<empresa>.[dominio].dto.request / dto.response
|
|
41
41
|
```
|
|
42
42
|
|
|
43
43
|
## Flujo de capas
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: redaccion-simple
|
|
3
|
-
description: "Guía transversal de redacción para artefactos
|
|
3
|
+
description: "Guía transversal de redacción para artefactos agent-workflow. Reglas para escribir OBJECTIVE/TASKS/DECISIONS/EVIDENCE/FINDINGS/CONCLUSIONS/CHECKPOINT/STATUS/PROBLEM/IDEAS/DELIVERY (legacy ES = OBJETIVO/DECISIONES/EVIDENCIA/HALLAZGOS/CONCLUSIONES/PROBLEMA/ENTREGA) con frases cortas, listas sobre prosa, sin jerga. Activable cross-plugin como `agent-workflow:redaccion-simple`. Aplica a toda prosa que el AI produzca en contexto agent-workflow: artefactos `.md` de sesión, mensajes de commit, descripciones de PR, READMEs ad-hoc, respuestas en chat sobre temas agent-workflow. No requiere sesión activa."
|
|
4
4
|
version: 2.0.1
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
# Redacción simple — Guía transversal
|
|
7
|
+
# Redacción simple — Guía transversal agent-workflow
|
|
8
8
|
|
|
9
|
-
Reglas de estilo y formato para los artefactos que producen los plugins
|
|
9
|
+
Reglas de estilo y formato para los artefactos que producen los plugins agent-workflow (core, dev, design, analyze).
|
|
10
10
|
|
|
11
11
|
## Cuándo se invoca
|
|
12
12
|
|
|
13
|
-
- Implícitamente al escribir cualquier `.md` dentro de una sesión
|
|
14
|
-
- Implícitamente al producir prosa en contexto
|
|
13
|
+
- Implícitamente al escribir cualquier `.md` dentro de una sesión agent-workflow (artefactos canónicos).
|
|
14
|
+
- Implícitamente al producir prosa en contexto agent-workflow fuera de sesión activa: commit messages, descripciones de PR, READMEs ad-hoc, respuestas en chat sobre runtime/skills/sesiones agent-workflow.
|
|
15
15
|
- Explícitamente con `Skill(agent-workflow:redaccion-simple)` desde un flow plugin o desde la skill agregadora `agent-workflow:rules`.
|
|
16
16
|
- Referenciada desde `session`, `compact`, `resume` y los skills de los flow plugins.
|
|
17
17
|
|