Etapas de commit

This workspace uses Greek-letter commit stages. ALL AI assistants MUST follow these rules when creating commits — Cursor, Claude, Gemini, Codex, Copilot, etc. Regla universal en AGENTS.md.

Los commits en TargApps declaran la etapa de madurez del proyecto con un prefijo entre corchetes. Esto alinea el historial de git con el diagrama de Etapas de desarrollo del workspace.

Tabla de etapas

Reglas

1. Todo commit debe incluir la etapa en el prefijo.
2. Progresión solo hacia adelante: a → b → g → d → e.
3. No retroceder una vez alcanzada una etapa en el proyecto.
4. Excepción Omega: commits [o] / [ω] son experimentales y no implican regresión.
5. Proyectos nuevos arrancan en Alfa (a).
6. RC de producción se marca con Épsilon (e).

Formato del mensaje

[<etapa>] <tipo>: <descripción>

Ejemplos

[a] feat: bootstrap del app Targ-Apps-Finance
[α] feat: bootstrap del app Targ-Apps-Finance
[b] docs: contratos del plugin Chroma-Fs
[β] refactor: API unificada de backends
[g] feat: hookState y render estables en WASM
[γ] fix: corrige diff de nodos de texto
[d] chore: sync targ-apps → targ-apps-page-vmaspad
[δ] docs: publicar guía de deploy del sitio
[e] release: v1 RC Chroma CLI standalone
[ε] release: v1 RC del sitio marketing
[o] experiment: spike de worker para layout
[ω] experiment: prototipo descartable de routing

Se aceptan códigos ASCII (a, b, g, d, e, o) o letras griegas (minúsculas o mayúsculas).

Tipos de commit habituales: feat, fix, refactor, docs, chore, test, release, experiment.

Etapa actual por proyecto

El registro canónico vive en STAGE.md en la raíz del workspace TargApps (fuera de este sitio de docs). Resumen recomendado:

Actualiza STAGE.md cuando un proyecto avance de etapa.

Validación con script

Desde la raíz del workspace TargApps:

# Validar prefijo y regla de no retroceso
./scripts/commit-stage.sh validate "[g] feat: descripción" chroma

# Ver etapa registrada
./scripts/commit-stage.sh current chroma-fs

# Listar códigos
./scripts/commit-stage.sh list

Con COMMIT_STAGE_STRICT=1, un intento de retroceso de etapa falla con exit code 1 (útil en hooks locales de este repo).

Cuándo usar cada etapa

• Alfa (a): primera versión, POC, esqueleto de repo o feature nueva.
• Beta (b): diseño y contratos claros; aún sin core completo.
• Gama (g): núcleo funcional implementado y demostrable.
• Delta (d): capas que dependen del core — deploy, documentación publicada, empaquetado.
• Épsilon (e): release candidate / producción v1.
• Omega (o): experimentos y spikes; no cambia la etapa registrada del proyecto.

Puntos de entrada para agentes de IA