Ejercicio DTO de Usuarios (con uso de Agente)

terminal de Rider

Abrí LabDTO en Rider y abrí la terminal integrada de Rider (en el panel vertical, por default en el panel izquierdo: [>_ ]).

Antes de instalar: ¿ya tenés OpenCode?

Corré esto:

opencode --version

Si tenés la versión 1: desinstalala

El comando puede variar si en su momento lo instalaste con otro gestor (npm, Homebrew, scoop, etc.).

# Desinstalar la v1
npm uninstall -g opencode-ai

# Instalar la v2 (última versión)
npm install -g @opencode/cli@latest

# Comprobar la versión
opencode --version

Elegir el modelo: Big Pickle

Posicionate en la carpeta de la solución si no lo estás ya y arrancá el agente en la terminal:

cd [ruta]/LabDTO
opencode

En la pantalla de OpenCode podés ver en qué modo está el agente, o sea qué permisos sobre los archivos tiene (Build o Plan; Shift+Tab pasa de uno a otro). Al lado te dice qué modelo de IA estás usando.

La ventaja de la interfaz de OpenCode es que podés, según la tarea que quieras hacer, utilizar distintas IAs (Copilot, Claude, Codex, etc.) desde el mismo contexto. OpenCode v2 permite también trabajo de IAs en paralelo.

Dentro de OpenCode escribí /models y elegí Big Pickle. Es un modelo gratuito de OpenCode.

Primer contacto: generar el contexto del agente

Con el agente en modo Build (Shift+Tab hasta que el indicador lo muestre), ejecutá en la terminal de OpenCode:

/init Crea el archivo Agents.md con el contexto del proyecto LabDTO-inicial

/init recorre el repositorio y crea un archivo AGENTS.md en la raíz de la solución. Esperá a que termine y después pedile:

Explicame las tres capas de esta solución y qué proyecto referencia a cuál.

Luego de revisarlo, abrí en Rider (con File System) el AGENTS.md que se acaba de generar y léanlo entre todos:

• AGENTS.md es lo que el agente lee al arrancar: la arquitectura y los comandos del proyecto.
• Fijate qué detectó /init (estructura de proyectos, comandos de build y test) y si se le escapó algo o lo interpretó mal. Es un borrador generado.

Revisá si puso prohibiciones para git. Si no lo hizo, agregá esto al AGENTS.md:

## Reglas de git

Podés consultar el estado del repositorio, pero nunca modificarlo ni publicarlo. Eso lo decide siempre una persona.

### Permitido (solo lectura)
- `git status`, `git diff`, `git log`, `git show`, `git blame`

### Prohibido
- **Publicar:** `git push` (con o sin `--force`), `git remote add/set-url/remove`.
- **Reescribir historia:** `git reset --hard`, `git rebase`, `git commit --amend`.
- **Borrar trabajo:** `git clean`, `git checkout .`, `git restore .`, `git stash drop/clear`, `git branch -D`, `git tag -d`.
- **Mover o integrar cambios:** `git merge`, `git cherry-pick`, `git checkout`/`git switch` a otra rama.
- **Guardar por tu cuenta:** `git add -A`, `git add .` y `git commit`. Si hay cambios listos, avisá y sugerí un mensaje de commit; no lo ejecutes.

### Commits
- **Nunca ejecutes `git commit`** (tampoco `git commit --amend`) ni `git add`. Los commits los hace siempre una persona, para que el historial y la lista de contribuidores reflejen solo a quienes escriben y revisan el código.
- No agregues líneas `Co-authored-by` ni ninguna mención al agente en mensajes de commit, ni configures `user.name` / `user.email`.
- Cuando haya cambios listos, avisá y proponé un mensaje de commit en texto para que la persona lo use.

### Si hace falta algo prohibido
Frená, explicá qué comando necesitarías y por qué, y esperá confirmación de la persona. No busques alternativas que logren el mismo efecto por otro camino (por ejemplo, borrar archivos con otros comandos para esquivar `git clean`).

antes de tocar nada, entender qué hay

Entrá a Usuarios en la app (con ▶ Run sobre LabDTO.Web en Rider, queda en http://localhost:5080), mirá la tabla y agregá un usuario con el formulario.

La solución está separada en capas. Cada flecha es una referencia entre proyectos: el de la izquierda puede usar las clases del de la derecha.

LabDTO.Web  ──▶  LabDTO.BusinessLogic  ──▶  LabDTO.Domain
(frontend)       (lógica de negocio)         (entidades)

LabDTO.Domain/Usuario.cs                       la entidad de dominio
LabDTO.BusinessLogic/UsuarioServicio.cs        lista y agrega usuarios
LabDTO.Web/Components/Pages/Usuarios.razor     la página que acabás de usar

Abrí esos tres archivos en Rider y leelos. Después hagan esto en este orden:

1. Respondan las tres preguntas sin usar el agente y anótenlo en la columna del grupo.
2. Recién ahora, pídanle al agente (en modo Plan) que las responda.
3. Completen las otras dos columnas.

Respondé estas tres preguntas sobre @LabDTO.Web/Components/Pages/Usuarios.razor,
@LabDTO.BusinessLogic/UsuarioServicio.cs y @LabDTO.Domain/Usuario.cs: ...

cambiar al agente Plan, revisar, corregir, y recién ahí aprobar

Antes de pedir nada, dos conceptos. Los necesitan para juzgar si el plan del agente tiene sentido.

Con el agente en Plan, pidan:

Quiero que el frontend deje de usar la entidad Usuario. Proponé un plan con
DTO y mapper, sin editar nada. Decime qué archivos vas a crear o tocar.

Revisen el plan con esta lista antes de aprobarlo:

Si algo no cierra, díganselo al agente y que ajuste el plan.

cada ciclo: predecir → pedir → revisar el diff → verificar → commit a mano

Cómo revisar el diff y commitear en Rider

• Ver los cambios: abrí Git → Commit (-o- en el panel vertical). A la izquierda aparecen los archivos modificados; hacé doble clic en cada uno para ver el diff (lo viejo contra lo nuevo).
• Commitear: tildá los archivos que quieras incluir, escribí un mensaje propio que diga qué cambió y por qué, y apretá Commit.
• Chequeo previo: en la barra de estado de Rider tiene que decir ejercicio-agente, no main.

Ciclo A. DTO + mapper 12 min

Predecir. Anotá: ¿qué propiedades creen que va a poner el agente en el DTO? ¿En qué carpeta va a poner el mapper?

Pedir. Armen el prompt con la información brindada, modo Build, Enter.

Revisar el diff. Lean los archivos nuevos en Rider con esta lista:

Si hay algo mal, no lo arreglen a mano: pídanselo con un pedido preciso (objetivo, restricciones, criterio de aceptación). Por ejemplo:

Corregí UsuarioDto y UsuarioMapper.
Objetivo: el DTO lleva solo Id, Nombre y Email; el mapper convierte en los dos sentidos.
Restricciones: el DTO no tiene contraseña, no referencia LabDTO.Domain y no tiene
lógica; el mapper va en LabDTO.BusinessLogic/Mappers; no toques LabDTO.Web.
La contraseña que hoy asigna la página a los usuarios nuevos pasa a decidirse en ToEntity.
Criterio de aceptación: "dotnet build LabDTO.BusinessLogic" compila sin errores.

Verificar y commitear, seleccionando únicamente el archivo verificado. Commit a mano desde Rider.

Ciclo B. El servicio habla en DTOs 8 min

Predecir. Escriban antes de correr nada: si el servicio pasa a devolver y recibir DTOs, ¿qué proyecto va a dejar de compilar y en qué lugares?

Pedir. Armen el prompt con la información brindada, modo Build, Enter.

Revisar y verificar. Leé el diff de UsuarioServicio.cs y comparen con la predicción. ¿El agente ya había hecho estos cambios con el pedido anterior?

Commit a mano.

Ciclo C. Blazor con DTOs 10 min

Predecir. ¿Qué cambios va a tener que hacer el agente en Usuarios.razor? Anótenlos en una lista.

Pedir. Armen el prompt con la información brindada, modo Build, Enter.

Revisar el diff y verificar.

Después ■ Stop y ▶ Run sobre LabDTO.Web, y prueben listar y dar de alta un usuario.

Commit a mano. ¿El agente ya lo había modificado?

arquitectura, navegador y reglas para el agente

4.1 Chequeo de arquitectura 2 min

Buscá en el proyecto Web (a mano o con el agente en modo Plan) cualquier mención del dominio. No tiene que aparecer nada.

Si encuentran algo, pídanle al agente que lo corrija (con un pedido preciso) y vuelvan a commitear.

Antes de terminar, probá escribir @u.Password en alguna celda de la tabla y mirá qué marca Rider. Después sacalo sin commitear.

4.2 Prueba en el navegador 3 min

Con la app corriendo, listen y agreguen un usuario. La contraseña no tiene que verse en ningún lado.

4.3 Tres reglas para el agente 5 min

Hoy el agente solo conocía la arquitectura y los comandos; no sabía qué es un DTO ni dónde va cada cosa en este proyecto. Con lo que tuvieron que corregir, pídanle al agente que actualice AGENTS.md con tres reglas para que el próximo pedido no tenga esos errores. Por ejemplo:

- Las entidades de Domain no salen de BusinessLogic: los servicios reciben y devuelven DTOs.
- Un DTO es una clase sin lógica ni referencias a Domain, y no incluye contraseñas.

Hagan un último commit a mano.

Registro del grupo