Imported from CyberDevStudios/Nova2d (
AGENTS.md). Install upstream withnpx skills add CyberDevStudios/Nova2d. Copyright stays with the author.
Nova2D — AI Agent Instructions
Este archivo define cómo los agentes de IA deben trabajar en este proyecto.
Stack
- Lenguaje: Lua 5.1 (Love2D 11.x)
- Framework: Nova2D sobre Love2D
- Gestión de estados: hump.gamestate
- Gestor de dependencias: Nova2D propio (v0.2+)
- Testing: No hay test runner disponible (Lua puro)
Convenciones de Código
camelCasepara variables y funcionesPascalCasepara entidades y sistemaslocalsiempre, sin globales exceptoGamestate- Separación estricta:
update(dt)para lógica,draw()para render - Un archivo por módulo, cada archivo retorna una tabla
main.luaes frozen — no debe modificarse
SDD (Spec-Driven Development)
Este proyecto usa SDD para cambios significativos. Los artefactos viven en openspec/.
Ciclo SDD
sdd-init→ inicializa contextosdd-new→ propuesta de cambiosdd-spec+sdd-design→ especificación + diseñosdd-tasks→ desglose en tareassdd-apply→ implementaciónsdd-verify→ verificación contra specssdd-archive→ cierre del cambio
Skills Relevantes
Los siguientes skills del sistema Gentle AI aplican a este proyecto:
| Skill | Cuándo usarlo |
|---|---|
sdd-init |
Inicializar SDD en el proyecto |
sdd-propose |
Crear propuestas de cambio |
sdd-spec |
Escribir especificaciones detalladas |
sdd-design |
Diseñar arquitectura técnica |
sdd-tasks |
Desglosar cambios en tareas |
sdd-apply |
Implementar tareas |
sdd-verify |
Verificar implementación |
sdd-archive |
Archivar cambios completados |
cognitive-doc-design |
Escribir documentación clara |
work-unit-commits |
Commits como unidades revisables |
Fases del Proyecto
| Fase | Descripción | Estado | |---|---|---|---| | v0.1 | Base structure + 5 states | Completado | | v0.2 | Dependency manager (gestor) | Completado | | v0.3 | Hot reload (lurker) | Completado | | v0.4 | Installer script (curl) | Completado | | v0.5 | Web documentation | Completado (nova2d.dev) | | v0.6 | Core Systems: jump, health, timer, camera, input | Completado | | v0.7 | Core Systems II: animation, audio, collision | Completado | | v1.0 | Public release | Pendiente |
Engram
Este proyecto usa Engram para memoria persistente entre sesiones. Las decisiones arquitectónicas, bugs, y descubrimientos importantes se guardan automáticamente.
Topic Keys
| Artifact | Topic Key |
|---|---|
| Init | sdd-init/framework |
| Testing | sdd/framework/testing-capabilities |
| Proposal | sdd/{change-name}/proposal |
| Spec | sdd/{change-name}/spec |
| Design | sdd/{change-name}/design |
| Tasks | sdd/{change-name}/tasks |
| Apply Progress | sdd/{change-name}/apply-progress |
| Verify Report | sdd/{change-name}/verify-report |
| Archive | sdd/{change-name}/archive-report |