trackops 1.0.1 → 2.0.0

package/templates/etapa/references/etapa-cycle.md

@@ -1,193 +0,0 @@
-# El Ciclo O.P.E.R.A. — Referencia Completa (alias heredado ETAPA)
-
-Este documento detalla cada fase del ciclo con sus reglas, procedimientos y Definitions of Done.
-
----
-
-## 1️⃣ E — Estrategia (Visión y Lógica)
-
-### Descubrimiento
-
-Haz al usuario las 5 preguntas clave:
-
-1. **Directriz Principal**: ¿Cuál es el resultado singular deseado?
-2. **Integraciones**: ¿Qué servicios externos necesitamos? ¿Están listas las claves?
-3. **Fuente de la Verdad**: ¿Dónde viven los datos primarios?
-4. **Carga Útil (Payload)**: ¿Cómo y dónde debe entregarse el resultado final?
-5. **Reglas de Comportamiento**: Restricciones o tono específico.
-
-### Regla "Datos-Primero"
-
-Antes de pasar a la siguiente fase, DEBES definir el **Esquema de Datos JSON** (Input/Output) en `genesis.md`.
-
-Ejemplo de schema en genesis.md:
-
-```json
-{
-  "input": {
-    "source": "API externa",
-    "schema": {
-      "id": "string (UUID)",
-      "timestamp": "ISO 8601",
-      "data": "object"
-    }
-  },
-  "output": {
-    "destination": "webhook POST",
-    "schema": {
-      "processed_id": "string (UUID)",
-      "result": "object",
-      "status": "enum: success|error"
-    }
-  }
-}
-```
-
-### Definition of Done — Fase E
-
-- [ ] Las 5 preguntas de descubrimiento están respondidas.
-- [ ] Esquema JSON de Input/Output definido en `genesis.md`.
-- [ ] Reglas de comportamiento documentadas en `genesis.md`.
-- [ ] `task_plan.md` tiene plano aprobado por el usuario.
-
----
-
-## 2️⃣ T — Tests (Conectividad)
-
-Verifica las tuberías antes de pasar el agua. El objetivo es confirmar que todos los servicios externos responden y devuelven datos con la forma esperada.
-
-### Procedimiento
-
-1. **Verificación de credenciales**: Lee `.env` y confirma que todas las claves necesarias existen y no están vacías.
-2. **Handshake**: Construye scripts mínimos en `tools/` (ej: `test_api.py`) para verificar cada servicio.
-3. **Validación de Shape**: No basta con un HTTP 200. Verifica que la respuesta coincide con el schema definido en `genesis.md`. Compara campos, tipos de datos y estructura.
-4. **Bloqueo**: Si algún test falla, NO procedas a la fase de Arquitectura. Documenta el fallo en `findings.md`.
-
-### Ejemplo de test mínimo
-
-```python
-# tools/test_api.py
-import os
-import requests
-
-API_KEY = os.getenv("API_KEY")
-BASE_URL = os.getenv("API_BASE_URL")
-
-def test_connection():
-    """Verifica conexión y shape de respuesta."""
-    response = requests.get(f"{BASE_URL}/health", headers={"Authorization": f"Bearer {API_KEY}"})
-    assert response.status_code == 200, f"Expected 200, got {response.status_code}"
-    data = response.json()
-    assert "id" in data, "Missing 'id' field in response"
-    assert "status" in data, "Missing 'status' field in response"
-    print("✅ API connection and shape validated")
-
-if __name__ == "__main__":
-    test_connection()
-```
-
-### Definition of Done — Fase T
-
-- [ ] Todas las credenciales `.env` verificadas (existen y no están vacías).
-- [ ] Scripts `test_*.py` ejecutados y pasando.
-- [ ] Respuestas de APIs validadas contra el schema de `genesis.md`.
-- [ ] Resultados documentados en `findings.md`.
-
----
-
-## 3️⃣ A — Arquitectura (La Construcción de 3 Capas)
-
-### Capa 1: Arquitectura (`architecture/`)
-
-SOPs (Standard Operating Procedures) técnicos en Markdown. Cada SOP define:
-
-- Propósito del script.
-- Entradas esperadas (con referencia al schema en `genesis.md`).
-- Salidas producidas.
-- Casos extremos y cómo manejarlos.
-- Dependencias con otras herramientas.
-
-**Regla**: Si la lógica cambia, actualiza el SOP **antes** que el código.
-
-### Capa 2: Navegación (El Agente)
-
-Capa de razonamiento. Enruta datos entre SOPs y herramientas. No ejecuta lógica de negocio directamente; delega a los scripts.
-
-### Capa 3: Herramientas (`tools/`)
-
-- Scripts atómicos y deterministas.
-- Las variables de entorno van en `.env`.
-- Usa `.tmp/` para todas las operaciones intermedias.
-- Cada script hace UNA cosa bien.
-
-### Regla de Idempotencia
-
-Toda herramienta DEBE ser idempotente. Herramientas con side-effects irreversibles se marcan:
-
-```python
-# META: side-effect: true
-# META: idempotent: false
-# META: requires-confirmation: true
-```
-
-### Grafo de Dependencias
-
-Si una herramienta produce output que consume otra, documéntalo en `genesis.md` bajo `## Pipeline`:
-
-```markdown
-## Pipeline
-### tool_fetch.py → tool_transform.py
-- Output: `.tmp/raw_data.json`
-- Formato: JSON array según schema X
-```
-
-### Definition of Done — Fase A
-
-- [ ] SOPs escritos en `architecture/` para cada herramienta.
-- [ ] Scripts implementados en `tools/`.
-- [ ] Grafo de dependencias documentado en `genesis.md`.
-- [ ] Tests de integración entre herramientas pasando.
-- [ ] Herramientas con side-effects marcadas con META tags.
-
----
-
-## 4️⃣ P — Pulido (Refinamiento)
-
-### Templates de Output
-
-Toda salida del sistema se valida contra una plantilla definida en `templates/`. Las plantillas se referencian desde `genesis.md` bajo `## Templates`.
-
-El pulido no es subjetivo; es verificable contra una plantilla. Si el output no coincide con el template, no pasa.
-
-### Refinamiento de Carga Útil
-
-Formatea todas las salidas (Markdown, HTML, JSON limpio) para entrega profesional según lo definido en `genesis.md`.
-
-### UX/UI
-
-Si el proyecto tiene interfaz, aplica diseños limpios e intuitivos según las especificaciones.
-
-### Definition of Done — Fase P
-
-- [ ] Todas las salidas validadas contra sus templates en `templates/`.
-- [ ] Formatos de entrega (Markdown, HTML, JSON) verificados.
-- [ ] Si hay interfaz: revisión visual completada.
-
----
-
-## 5️⃣ A — Automatización (Despliegue)
-
-### Procedimiento
-
-1. **Limpieza**: Elimina residuos de `.tmp/`.
-2. **Transferencia**: Mueve la lógica finalizada a producción/nube.
-3. **Configuración**: Establece los disparadores (Cron, Webhooks).
-4. **Smoke Test**: Verificación mínima en el entorno de producción.
-
-### Definition of Done — Fase A (final)
-
-- [ ] `.tmp/` limpio (sin archivos residuales).
-- [ ] Código desplegado en destino final.
-- [ ] Triggers configurados y verificados.
-- [ ] Smoke test en producción pasando.
-- [ ] `progress.md` actualizado con estado final.

package/templates/etapa/registry.md

@@ -1,28 +0,0 @@
-# Skills Registry — {{PROJECT_NAME}}
-
-> Índice de skills instaladas en este proyecto. Gestionado automáticamente por `trackops skill`.
-
----
-
-## Skills Instaladas
-
-_Sin skills instaladas. Usa `trackops skill install <nombre>` para añadir una._
-
----
-
-## Cómo Usar una Skill
-
-1. Identifica el contexto en `.agent/hub/router.md`.
-2. Abre el archivo `SKILL.md` de la skill correspondiente.
-3. Sigue las instrucciones del protocolo definido en la skill.
-
----
-
-## Gestión
-
-```bash
-trackops skill list          # Ver skills instaladas
-trackops skill catalog       # Ver skills disponibles
-trackops skill install <n>   # Instalar una skill
-trackops skill remove <n>    # Desinstalar una skill
-```

package/templates/etapa/router.md

@@ -1,39 +0,0 @@
-# Router de Skills
-
-## Propósito
-Este archivo define las reglas de enrutamiento entre el agente principal y las skills disponibles. Cuando el agente detecta un contexto específico, consulta estas reglas para decidir qué skill invocar.
-
-## Reglas de Enrutamiento
-
-### Contexto: Commit de código
-- **Trigger**: El usuario pide hacer un commit o se completa un cambio de código.
-- **Skill**: `commiter`
-- **Acción**: Consulta la skill para formatear el mensaje de commit.
-
-### Contexto: Post-commit
-- **Trigger**: Se acaba de realizar un commit exitoso.
-- **Skill**: `changelog-updater`
-- **Acción**: Ejecuta el script de actualización del changelog.
-
-### Contexto: Inicialización de proyecto
-- **Trigger**: El usuario quiere crear un nuevo proyecto.
-- **Skill**: `project-starter-skill` (global)
-- **Acción**: Ejecutar el protocolo de inicialización completo.
-
-### Contexto: Seguimiento operativo
-- **Trigger**: Se va a empezar, retomar o cerrar un bloque de trabajo.
-- **Skill**: No aplica skill externa.
-- **Acción**: Ejecutar `trackops status`, tomar la siguiente tarea con `trackops next` y mantener `project_control.json` como fuente de verdad operativa.
-
-## Cómo Añadir Nuevas Reglas
-
-Cada regla sigue este formato:
-
-```markdown
-### Contexto: [descripción]
-- **Trigger**: [qué activa la regla]
-- **Skill**: [nombre de la skill]
-- **Acción**: [qué debe hacer el agente]
-```
-
-Al instalar una nueva skill con `trackops skill install <nombre>`, añade su regla de enrutamiento aquí.