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.
Las pruebas de integración requieren ORKMIND_TEST_DATABASE_URL y borran la base de pruebas. Use solo una base de pruebas dedicada; lea CONTRIBUTING antes de ejecutar la suite completa.
pip install -e ".[dev]"
pytest -m "not integration"Una guía por tarea
OrkMind aún no tiene una serie propia de guías de contribución. Use las guías de Orkastery para el flujo de contribución y el CONTRIBUTING de OrkMind para sus comandos y contratos específicos.
Las guías fuente están en portugués de Brasil. La versión en inglés está prevista antes del lanzamiento. Las contribuciones claras en inglés son bienvenidas.
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.