Acotar un ejercicio asistido por agentes
[!TIP] Delimita por evidencia, no por ambición. Elige un resultado de usuario, un punto de partida controlado y un resultado que otro aprendiz pueda verificar. Usa los ejemplos de PRD para escribir ese contrato.
Un laboratorio práctico útil modifica una capacidad y produce evidencia que el estudiante puede inspeccionar. El alcance no es una promesa de que un agente terminará en un tiempo determinado.
Elige un tipo de trabajo
| Tipo | Evidencia inicial | Ejemplo | Excluir |
|---|---|---|---|
| Greenfield | Necesidades de la parte interesada y no objetivos explícitos | Lista de suscripción RSS | Sondeo en segundo plano, cuentas de usuario reales |
| Funcionalidad brownfield | Contrato existente y pruebas base | Metadatos de documento para un panel | Migración de framework no relacionada |
| Refactorización | Pruebas de caracterización y efectos secundarios actuales | Extraer validación de pedidos | Cambios en precios o elegibilidad |
| Modernización | Contrato de compatibilidad, inventario de datos, reversión | Almacenamiento CSV a SQLite | Reescribir todas las capas a la vez |
| Integración de agente de tiempo de ejecución | Herramientas permitidas y límites de permisos | Asistente de estado de pedidos de solo lectura | Shell sin restricciones o pagos en vivo |
Haz que la tarea sea comprobable
Sustituye «crea un sitio de compras fantástico» por:
Build only product listing, details, cart, and a mock summary using the bundled
products. Reuse integer-cents arithmetic. No accounts, tracking, network images,
database, or payment processor. Verify keyboard navigation, quantity errors,
empty cart, and totals at 375px and 1280px viewports.
Las exclusiones evitan dependencias innecesarias; los casos evitan que un resultado pulido pero inutilizable se confunda con la finalización.
Conserva la dificultad útil
Proporciona los datos de entrada y los criterios de aceptación. No impongas el código generado exacto ni ofrezcas una captura de «todas las pruebas superadas» como evidencia. Incluye:
- Una inspección de la línea base.
- Una decisión de diseño con al menos dos opciones razonables.
- Un caso que falle deliberadamente.
- Una implementación acotada.
- Una comprobación negativa que demuestre que el verificador puede rechazar un comportamiento incorrecto.
- Un restablecimiento limitado al espacio de trabajo desechable.
Revisa el alcance antes de implementar
- El ejercicio puede usar datos sintéticos locales, o su dependencia externa es explícita.
- Las herramientas requeridas están separadas de los servicios opcionales y de las alternativas de lenguaje.
- El aprendiz conoce el directorio de trabajo y el comando base exacto.
- El comportamiento preservado se indica junto al cambio solicitado.
- El caso negativo puede detectar una implementación incorrecta.
- Las pruebas tienen límites explícitos; la apariencia visual no se considera comportamiento completo.
- La condición de parada y un reinicio seguro evitan reparaciones ilimitadas.
Usa los ejemplos de PRD para convertir estas respuestas en un contrato concreto.
Revisión de alcance de ejemplo
| Propuesta | Decisión | Motivo |
|---|---|---|
| Construir cuentas, pagos y envío en un solo ejercicio corto | Dividir en ejercicios separados | Cada uno introduce un límite de confianza y un modelo de fallo diferente |
| Usar tres productos empaquetados y un checkout simulado | Adecuado para el laboratorio de prototipo | El dominio y la evidencia de UI pueden observarse localmente |
| Comparar dos implementaciones mientras se cambia el conjunto de datos | Rediseñar la comparación | El resultado no puede aislar la elección de implementación |
| Agregar una prueba de límite antes de refactorizar un método | Adecuado para una misión enfocada | El aprendiz puede explicar tanto el cambio como su evidencia |
Práctica independiente: escribe un alcance rechazado y su reemplazo más pequeño. Nombra qué dependencia, autoridad o afirmación eliminaste, y qué evidencia prueba que el ejercicio reducido sigue siendo útil.
| Anterior | Siguiente |
|---|---|
| Orden de aprendizaje | Ejemplos de PRD |