grzadr/agent-skills

Habilidad de Plano de Proyecto

Cuando se te pida diseñar o inicializar un proyecto de aprendizaje, genera un archivo ROADMAP.md estructurado en la raíz del espacio de trabajo. NO escribas ningún código de aplicación o implementación.

Principios de Diseño Fundamentales

1. Micro-Sprints (Ritmo Dopaminérgico): Cada paso debe poder completarse en 15 a 30 minutos de codificación concentrada. Si una característica lleva más tiempo, divídela en sub-pasos.
2. Cortes Verticales, No Capas Horizontales: Nunca crees una etapa como "Escribir todos los modelos de datos" seguida de "Escribir todas las consultas a la base de datos". En su lugar, el Paso 1.1 de la Etapa 1 debe tomar una sola entrada y producir una salida visible y comprobable de inmediato.
3. Agnosticismo de Lenguaje: Redacta las especificaciones en torno al comportamiento observable (entradas, salidas, cambios de estado, códigos de salida, valores de retorno o respuestas de API) en lugar de código repetitivo específico del lenguaje.

Protocolo

1. Aclarar el Contexto Mínimo (Solo si falta)

Si el usuario no ha especificado:

• Proyecto Objetivo (por ejemplo, Aplicación de Tareas, Cliente BitTorrent, Almacén Clave-Valor, Servidor HTTP)
• Lenguaje / Runtime Objetivo (por ejemplo, Go, Rust, Python, TypeScript, C, Zig)
• Tipo de Interfaz (por ejemplo, CLI, API HTTP, TUI, Biblioteca)

Haz como máximo 2 preguntas breves para definir estos aspectos antes de generar ROADMAP.md.

2. Generar ROADMAP.md

Crea ROADMAP.md usando la siguiente estructura:

• Resumen del Proyecto: Un resumen de 2 oraciones sobre lo que se construye y los conceptos centrales del lenguaje que el aprendiz practicará (por ejemplo, gestión de memoria, concurrencia, structs/interfaces, E/S asíncrona, manejo de errores).
• Seguimiento de Progreso:
  • Puntero de Etapa y Paso actual (por ejemplo, Paso Activo: Etapa 1 - Paso 1.1)
  • Leyenda de estado: [ ] Bloqueado/Pendiente, [~] En Progreso, [x] Superado
• Etapas (4 a 6 Etapas en total):
  • Etapa 1: El Latido (Esqueleto Funcional): Conseguir el comando o función más simple de extremo a extremo funcionando.
  • Etapa 2: Estado Central y Camino Feliz: Implementar las estructuras de datos principales y las operaciones centrales en memoria.
  • Etapa 3: Persistencia / E/S y Casos Extremos: Guardar el estado, analizar entradas complejas y manejo elegante de errores.
  • Etapa 4: Características Avanzadas del Lenguaje: Introducir concurrencia, flujos de datos, middleware u optimización del rendimiento.
• Pasos (2 a 4 Pasos por Etapa): Para cada Paso, incluye:
  • Objetivo: Una oración que describa lo que el usuario construirá.
  • Conceptos de Lenguaje Practicados: 2 o 3 características específicas del lenguaje necesarias para este paso.
  • Especificación y Criterios de Aceptación: Comportamientos concretos y comprobables de caja negra (firmas de funciones exactas, argumentos de CLI, stdout/stderr esperados, o estado/payloads HTTP) que craft-gatekeeper usará para escribir pruebas automatizadas.

Barreras de Seguridad

• NUNCA generes archivos de código fuente o fragmentos de solución al ejecutar esta habilidad.
• Termina tu respuesta señalando al usuario la Etapa 1, Paso 1.1 y sugiriéndole que ejecute /craft-bootstrap (para configurar el esqueleto del proyecto vacío) o /craft-gatekeeper (para generar la primera prueba fallida).