Cómo contribuir

Gracias por mejorar Awesome Copilot Adventures.

[!IMPORTANT] Empieza por un resultado de aprendizaje y evidencia observable, no por una lista de funciones o una historia de fantasía.

Ciclo de contribución

---
config:
  theme: base
  look: classic
  themeVariables:
    darkMode: false
    background: "#ffffff"
    primaryColor: "#f5f5f5"
    primaryTextColor: "#111111"
    primaryBorderColor: "#555555"
    secondaryColor: "#e0e0e0"
    secondaryTextColor: "#111111"
    secondaryBorderColor: "#666666"
    tertiaryColor: "#bdbdbd"
    tertiaryTextColor: "#111111"
    tertiaryBorderColor: "#444444"
    lineColor: "#444444"
    textColor: "#111111"
    mainBkg: "#f5f5f5"
    nodeBorder: "#555555"
    clusterBkg: "#ffffff"
    clusterBorder: "#999999"
    edgeLabelBackground: "#ffffff"
    actorBkg: "#e0e0e0"
    actorBorder: "#555555"
    actorTextColor: "#111111"
    actorLineColor: "#777777"
    signalColor: "#333333"
    signalTextColor: "#111111"
    labelBoxBkgColor: "#f5f5f5"
    labelBoxBorderColor: "#777777"
    labelTextColor: "#111111"
    loopTextColor: "#111111"
    activationBkgColor: "#bdbdbd"
    activationBorderColor: "#555555"
    noteBkgColor: "#f5f5f5"
    noteTextColor: "#111111"
    noteBorderColor: "#777777"
    attributeBackgroundColorOdd: "#f5f5f5"
    attributeBackgroundColorEven: "#e0e0e0"
---
flowchart LR
    accTitle: Puntos de control de evidencia de las contribuciones
    accDescr: Una contribución avanza desde un resultado de aprendizaje a través de fuentes oficiales, diseño de evidencia, implementación, validación y revisión.
    O["Un resultado de aprendizaje"] --> D["Documentación oficial"]
    D --> E["Evidencia y restablecimiento"]
    E --> C["Aventura + laboratorio + rúbrica"]
    C --> V["Validación específica"]
    V --> P["Pull request revisable"]

Leyenda. Los rectángulos representan las etapas de contribución. Las flechas continuas muestran el orden del trabajo revisable.

Explicación. Define el resultado de aprendizaje y su evidencia antes de escribir el ejercicio. La validación y la revisión son independientes de la producción del artefacto.

Antes de escribir

1. Elige un objetivo principal de aprendizaje sobre desarrollo agéntico.
2. Verifica la terminología y el comportamiento en la documentación oficial vigente de GitHub o Microsoft.
3. Decide qué primitiva se necesita: instrucciones, prompt, skill, agente personalizado, MCP o hook.
4. Define evidencia determinista, un fallo intencional y pasos de restablecimiento.
5. Identifica el comportamiento estable, en versión preliminar, experimental o dependiente de la disponibilidad.

Lista de comprobación de la aventura

• Crea adventures/<level>/<slug>/README.md.
• Crea adventures/<level>/<slug>/rubric.md.
• Añade un proyecto inicial en labs/<slug>/ cuando se modifiquen archivos o la configuración.
• Añade o actualiza el verificador determinista.
• Referencia un recurso de cabecera en assets/images/adventures/.
• Añade fuentes oficiales y una fecha last_verified real.
• Incluye Ask → Plan → Agent → Revisión → Evidencia.
• Incluye un fallo intencional y un desafío independiente.
• Ejecuta npm test.
• Ejecuta la compilación o prueba específica del lenguaje cuando corresponda.

No crees una copia separada exclusiva de Ask. Ask es un rol de investigación dentro de la misma aventura progresiva.

Diseño de la documentación

• Usa encabezados significativos y párrafos concisos.
• Usa alertas de GitHub para notas, advertencias y precauciones importantes.
• Usa Mermaid cuando un proceso, un grafo de dependencias o una secuencia se entienda mejor de forma visual.
• Mantén los diagramas legibles sin depender únicamente del color.
• Incluye texto alternativo para cada imagen significativa.
• Prefiere los enlaces relativos dentro del repositorio.
• No coloques instrucciones esenciales únicamente dentro de una imagen o un video.
• Sigue el estándar de diagramas monocromos para todos los bloques Mermaid, incluidos los títulos accesibles, las leyendas y las explicaciones.
• Mantén los laboratorios prácticos como ejercicios numerados, no como aventuras de fantasía. Añade una entrada de catálogo, un fixture local y una resolución de auditoría para los cambios.

Recursos multimedia

Usa los prompts para recursos multimedia. Las imágenes de cabecera generadas deben medir 1456×832, no contener texto incrustado e incluir texto alternativo significativo. Los videos necesitan una imagen de portada y una alternativa con movimiento reducido.

Pull requests

Usa un título específico, como New Copilot Adventure: The Skill Grimoire of Algora. Describe:

• el objetivo de aprendizaje;
• las fuentes oficiales y el estado de las funciones;
• los archivos y los cambios de comportamiento;
• los comandos de validación y sus resultados;
• las limitaciones y los recursos multimedia pendientes.