AgentDock

Lee las guías de desarrollo relevantes antes de comenzar tu tarea.

Ejecuta estos pasos:

1. Lee los artefactos de la tarea actual:

   • prd.md para los requisitos y criterios de aceptación
   • design.md si está presente, para el diseño técnico
   • implement.md si está presente, para el orden de ejecución y el plan de validación

2. Descubre los paquetes y sus capas de especificación:

   python3 ./.trellis/scripts/get_context.py --mode packages
   

3. Identifica qué especificaciones aplican a tu tarea según:

   • El paquete que estás modificando (por ejemplo, cli/, docs-site/)
   • El tipo de trabajo (backend, frontend, test-unitario, documentación, etc.)
   • Las rutas de especificación/investigación referenciadas por los artefactos de la tarea

4. Lee el índice de especificaciones para cada módulo relevante:

   cat .trellis/spec/<package>/<layer>/index.md
   

   Sigue la sección "Lista de verificación previa al desarrollo" en el índice.

5. Lee los archivos de guía específicos listados en la Lista de verificación previa al desarrollo que sean relevantes para tu tarea. El índice NO es el objetivo — te señala los archivos de guía reales (por ejemplo, error-handling.md, conventions.md, mock-strategies.md). Lee esos archivos para comprender los estándares y patrones de codificación.

6. Lee siempre las guías compartidas:

   cat .trellis/spec/guides/index.md
   

7. Para una tarea no trivial, define el límite del cambio antes de escribir código. No trivial significa que toca más de un archivo, cruza una capa, cambia una interfaz pública o edita código que no acabas de escribir. Escribe:

   • la brecha de comportamiento más pequeña entre lo que sucede ahora y lo que debería suceder
   • dónde vive realmente ese comportamiento (no dónde es más fácil interceptarlo)
   • qué archivos esperas modificar y por qué cada uno es necesario
   • qué estás explícitamente no haciendo en esta tarea
   • si se necesita una refactorización local, cómo demostrarás que no cambió el comportamiento

   Un cambio pequeño y bien delimitado no necesita esto — hazlo directamente.

   Si el alcance real resulta ser claramente mayor que esto, dilo y explica por qué antes de continuar. No amplíes el cambio por tu cuenta.

8. Comprende los estándares y patrones de codificación que debes seguir, luego continúa con tu plan de desarrollo.

Este paso es obligatorio antes de escribir cualquier código.