trackops 1.0.1 → 1.1.0

package/templates/opera/genesis.md

@@ -1,94 +1,79 @@
-# {{PROJECT_NAME}} — Genesis
-
-> **La Constitución del proyecto.** Este documento es la fuente de verdad. Antes de tomar cualquier decisión arquitectónica o de implementación, consulta este archivo. Si un script contradice lo definido aquí, el script está mal.
-
----
-
-## 1. Directriz Principal
-
-_¿Cuál es el resultado singular deseado de este proyecto?_
-
-> TODO: Definir el objetivo principal del proyecto.
-
----
-
-## 2. Integraciones Externas
-
-_¿Qué servicios externos necesitamos? ¿Están listas las claves?_
-
-| Servicio | Estado | Clave / Config |
-|----------|--------|----------------|
-| —        | —      | —              |
-
----
-
-## 3. Fuente de la Verdad
-
-_¿Dónde viven los datos primarios?_
-
-> TODO: Describir la fuente de datos principal.
-
----
-
-## 4. Carga Útil (Payload)
-
-_¿Cómo y dónde debe entregarse el resultado final?_
-
-> TODO: Describir destino y formato de entrega.
-
----
-
-## 5. Reglas de Comportamiento
-
-_Restricciones, tono y reglas específicas del dominio._
-
-> TODO: Definir restricciones de negocio.
-
----
-
-## Esquema de Datos
-
-> **Regla "Datos-Primero"**: Este schema debe estar definido antes de escribir cualquier código.
-
-```json
-{
-  "input": {
-    "source": "",
-    "schema": {}
-  },
-  "output": {
-    "destination": "",
-    "schema": {}
-  }
-}
-```
-
----
-
-## Invariantes Arquitectónicas
-
-_Decisiones técnicas inamovibles. Cambiarlas requiere aprobación explícita (Nivel Rojo)._
-
-- TODO: Listar invariantes.
-
----
-
-## Pipeline
-
-_Documenta el grafo de dependencias entre herramientas._
-
-<!-- Ejemplo:
-### tool_fetch.py → tool_transform.py
-- Output: `.tmp/raw_data.json`
-- Formato: JSON array según schema X
--->
-
----
-
-## Templates
-
-_Referencias a las plantillas de output definidas en `templates/`._
-
-<!-- Ejemplo:
-- `templates/report.md` — Plantilla para reportes
--->
+# {{PROJECT_NAME}} — Genesis
+
+> **La Constitución del proyecto.** Este documento es la fuente de verdad. Antes de tomar cualquier decisión arquitectónica o de implementación, consulta este archivo. Si un script contradice lo definido aquí, el script está mal.
+
+---
+
+## 1. Directriz Principal
+
+_¿Cuál es el resultado singular deseado de este proyecto?_
+
+> {{DESIRED_OUTCOME}}
+
+---
+
+## 2. Integraciones Externas
+
+_¿Qué servicios externos necesitamos? ¿Están listas las claves?_
+
+| Servicio | Estado | Clave / Config |
+|----------|--------|----------------|
+{{SERVICES_TABLE}}
+
+---
+
+## 3. Fuente de la Verdad
+
+_¿Dónde viven los datos primarios?_
+
+> {{SOURCE_OF_TRUTH}}
+
+---
+
+## 4. Carga Útil (Payload)
+
+_¿Cómo y dónde debe entregarse el resultado final?_
+
+> {{PAYLOAD}}
+
+---
+
+## 5. Reglas de Comportamiento
+
+_Restricciones, tono y reglas específicas del dominio._
+
+{{BEHAVIOR_RULES}}
+
+---
+
+## Esquema de Datos
+
+> **Regla "Datos-Primero"**: Este schema debe estar definido antes de escribir cualquier código.
+
+```json
+{{DATA_SCHEMA}}
+```
+
+---
+
+## Invariantes Arquitectónicas
+
+_Decisiones técnicas inamovibles. Cambiarlas requiere aprobación explícita (Nivel Rojo)._
+
+{{ARCHITECTURAL_INVARIANTS}}
+
+---
+
+## Pipeline
+
+_Documenta el grafo de dependencias entre herramientas._
+
+{{PIPELINE_ITEMS}}
+
+---
+
+## Templates
+
+_Referencias a las plantillas de output definidas en `templates/`._
+
+{{TEMPLATE_ITEMS}}

package/templates/skills/changelog-updater/locales/en/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: "changelog-updater"
+description: "Automatically update CHANGELOG.md from the latest commit after a successful commit."
+metadata:
+  version: "1.0"
+  type: "project"
+---
+
+# Changelog Updater
+
+Use this skill right after a successful commit to update `CHANGELOG.md` from the git history. It should parse the latest commit, classify it using Conventional Commit semantics, and append the entry to the proper dated section.

package/templates/skills/commiter/locales/en/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: "commiter"
+description: "Generate commit messages in English following strict Conventional Commits rules with emojis."
+metadata:
+  version: "1.0"
+  type: "project"
+---
+
+# Commit Writer
+
+Use this skill whenever a commit message must be generated. The message must follow Conventional Commits, keep the scope explicit when relevant, and preserve the emoji convention used by the project.

package/templates/skills/project-starter-skill/locales/en/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: "project-starter-skill"
+description: "Global skill to initialize complete projects using the O.P.E.R.A. protocol. Use it when the user wants to start a new project, scaffold a repo, initialize an agent structure, or kick off a new automation."
+metadata:
+  version: "3.0"
+  type: "global"
+---
+
+# Project Starter Skill
+
+You are the system pilot. Your job is to initialize deterministic, recoverable projects under the O.P.E.R.A. protocol.
+
+## Protocol
+
+1. Ask discovery questions about the desired outcome, integrations, source of truth, payload, and behavior rules.
+2. Run `npx trackops init --with-opera`.
+3. Populate `genesis.md` with schemas, constraints, and invariants.
+4. Regenerate docs with `trackops sync` and refine the plan.
+5. Ensure base skills are present: `commiter` and `changelog-updater`.
+6. Suggest optional repo governance tasks if needed.
+
+## Rule
+
+Do not write delivery code before the data contract exists in `genesis.md`.