Guías
Cómo contribuir
Elija una contribución, prepare las pruebas y encuentre la guía de su tarea.
Por dónde empezar
Una funcionalidad nueva empieza en GitHub Discussions. Un defecto empieza por una issue con el comando, la salida real y la versión. La documentación y las correcciones pequeñas pueden ir directamente a un PR. Consulte las issues y el roadmap antes de empezar; comente en la issue que quiera asumir.
Prepare un cambio verificable
El PR explica el problema, el cambio, las pruebas, la baseline y el riesgo. Incluya la salida real de los comandos. Separe las regresiones de los fallos previos; un cambio de comportamiento requiere una prueba que reproduzca el defecto. Usar ork es recomendable y opcional. El mantenedor integra con CI aprobado en el commit exacto y se encarga de publicar.
Ejecute los comandos desde la raíz del checkout. La guía de pruebas incluye la lista completa de comprobaciones.
Con ork, ci prepare escribe .ork-ci/<thread>.json, solo de su thread; conviértalo en el último commit del PR, y el check ork-verify lo encuentra por el nombre de la branch.
¿Cambió skills, references, los adaptadores de Claude Code o Codex o la versión de core/package.json? Ejecute node core/scripts/gerar-marketplaces.cjs y haga commit del resultado; el CI lo comprueba con --verificar. ¿Cambió el frontmatter de un elemento? Regenere solo sus tablas con docs sincronizar --escrever --so RM-NNN.
npm --prefix core ci
npm --prefix core run build
npm --prefix core run test:ci
node core/dist/index.js evalUna guía por tarea
Las guías fuente están en portugués de Brasil, como el resto de la carpeta docs. Las contribuciones técnicas claras en inglés son bienvenidas y nunca se rechazan solo por el idioma.
Plazo, revisión y seguridad
El objetivo es una primera respuesta a las issues en un máximo de 7 días y una primera revisión de los PRs en el mismo plazo. Es un objetivo, no una garantía. Si se supera, comente en la solicitud original. Comunique las vulnerabilidades por el canal privado de SECURITY.md. No incluya secretos, datos personales ni datos de clientes en el repositorio.