Todos los proyectos de la organización siguen los estándares definidos en el repositorio hamekoz/.github:
| Estándar | Descripción |
|---|---|
| Conventional Commits | Formato obligatorio de mensajes de commit |
| Semantic Versioning | Política de versionado vMAJOR.MINOR.PATCH |
| Branching | Estrategia de ramas: main, develop, feature/*, fix/* |
| Clean Architecture | Organización Domain → Application → Infrastructure → API |
| 12 Factor App | Checklist por tipo de servicio |
| CI/CD | Pipelines mínimos obligatorios por tipo de proyecto |
- Solo elegir repositorios privados cuando el código tiene valor diferenciador de negocio.
- Usar la Organización Hamekoz para repositorios públicos.
- No almacenar secrets en el repositorio.
README.mdcon descripción, arquitectura mínima y guía para contribuidores.- CI/CD configurado desde el primer commit (build + tests + verificación de convenciones).
- Branch protection en
mainydeveloppara evitar bypass del CI.
Los proyectos que usen agentes IA deben seguir la política de uso de IA, que incluye:
- Toda tarea generada por IA requiere revisión humana antes de merge.
- Registrar las tareas en el historial
docs/ai/ai-task-log.mddel repositorio. - Las instrucciones para GitHub Copilot están centralizadas en este repositorio.
Las APIs exponen un endpoint /version con el siguiente formato:
v1.4.2+a3f9c12@https://github.com/hamekoz/my-api
Ver formato completo en la guía de Semantic Versioning.
Para usar paquetes NuGet de la organización:
- Generar un GitHub personal access token con permiso
read:packages. - Usar la variable de entorno
Hamekoz_GITHUB_PACKAGES_TOKENcon el token generado. - Adaptar el
nuget.configde ejemplo al repositorio.
