isdou/tengo-una-idea-skill

Tengo una Idea

Captura y co-desarrolla ideas importantes en Markdown trazable sin iniciar automáticamente la implementación.

Contrato Principal

• Una idea independiente mantiene solo un Markdown vivo.
• Los nuevos archivos se ubican por defecto en docs/ideas/IDEA-YYYYMMDD-<slug>.md.
• El único resultado legítimo del skill es la creación o actualización de ese Markdown, así como una breve conversación con el usuario.
• No modifica el código fuente del proyecto, no crea Issues, tareas, PRD, planes de implementación ni prototipos, no ejecuta builds, tests o despliegues, y no invoca agentes de implementación.
• status: shaped solo indica que la idea ha tomado forma; nunca equivale a implementation_authorization: granted.
• Mientras no se reciba autorización explícita del autor, se mantiene implementation_authorization: not-granted.
• Después de la autorización, solo actualiza el documento, genera la entrega y finaliza el skill; no se permite comenzar la implementación dentro de este skill.

1. Determinar el Modo de Interacción

Se determina según la siguiente prioridad:

1. Idea explícita: El usuario utiliza /idea, Tengo una idea, I have an idea o una expresión claramente equivalente. Capturar directamente, sin preguntar si se debe crear un documento.

2. Idea implícita de alta confianza: El usuario propone algo nuevo y de largo plazo (producto, experiencia, arquitectura o forma de crear), como "Ojalá hubiera...". Primero decirle al usuario "Voy a capturar esta idea", y luego capturarla.

3. Intención ambigua: Una frase que podría ser una nueva idea o una modificación inmediata, por ejemplo "¿No debería haber un botón de exportar aquí?". Solo preguntar:

   ¿Estás proponiendo una idea que vale la pena desarrollar, o quieres que lo modifique ahora?

   No crear un documento hasta que el usuario responda.

4. Ejecución explícita: Bugs, modificaciones mecánicas, implementaciones específicas, preguntas factuales o avance de tareas existentes. No activar este skill.

5. Mezcla de nueva idea y solicitud de inicio: Primero ejecutar este skill para documentar la idea; registrar la solicitud explícita de inicio como autorización. Una vez completada la entrega, finalizar este skill para que otro flujo de trabajo lea el documento después.

Prohibido preguntar "¿Quieres crear un documento de idea?". Al instalar y habilitar este skill, el anfitrión otorga autorización continua para este flujo de trabajo de registro de ideas; si el proyecto anfitrión tiene reglas explícitas diferentes, se siguen las reglas del anfitrión. Lo que realmente necesita aclaración es el modo de colaboración, no la operación de archivos.

2. Buscar Antes de Crear

Antes de crear un nuevo documento, se debe buscar:

1. Extraer del discurso del usuario el tema, sinónimos, entidades clave y posibles etiquetas.
2. Buscar en Markdown existente con rg, en el siguiente orden:
   • docs/ideas/
   • docs/product/
   • docs/architecture/
   • docs/adr/
3. Leer los documentos candidatos más relevantes, juzgando por semántica y no solo por nombre de archivo.
4. Procesar según las siguientes reglas:
   • Misma idea: Actualizar el documento de idea original.
   • Documento existente de producto, arquitectura o ADR que ya sea fuente de verdad: Actualizar ese Markdown, o enlazar desde el nuevo documento de idea; no duplicar una conclusión contradictoria.
   • Relacionado pero con límites diferentes: Explicar la superposición, preguntar si continuar en el documento original o crear una idea independiente.
   • Sin registros relacionados: Crear un nuevo documento.
   • No se puede determinar si hay duplicación: No fusionar automáticamente; dejar que el autor decida la identidad de la idea.

Priorizar rg --files y rg -n -i --glob '*.md'. Si un directorio no existe, omitirlo; no considerar la falta de docs/ideas/ como un error.

3. Captura Mínima

Al crear un nuevo documento, usar la estructura de assets/idea-record-template.md y completar todo el contenido. Respetar las siguientes reglas:

• Usar fecha local y hora ISO 8601.
• Nombre de archivo: IDEA-YYYYMMDD-<slug>.md; slug usar kebab-case ASCII corto y estable.
• id debe coincidir con el nombre base del archivo; no cambiar después de la creación inicial.
• Si la ruta ya existe, primero determinar si es un duplicado; solo si se confirma que es una idea diferente, agregar el sufijo numérico más corto, nunca sobrescribir.
• status inicial usar captured, version usar 0.1, autorización de implementación usar not-granted.
• Conservar tal cual la expresión del usuario que determina la dirección de la idea; no mezclar la paráfrasis de la IA en la cita.
• En "Forma actual", escribir solo la comprensión preliminar más fuerte, y marcar explícitamente las partes aún no formadas.
• Marcar las inferencias de la IA como "juicio" o "suposición"; no disfrazarlas como decisiones del usuario o hechos.
• Después de crear o actualizar, informar al usuario la ruta del documento y luego pasar naturalmente a la discusión.

Crear o actualizar solo este Markdown. No generar un segundo archivo de salida para índices, resúmenes o gestión de tareas.

4. Co-desarrollar la Idea

Cada ronda debe seguir este orden:

1. Primero, desde la perspectiva del usuario, repetir por qué esta idea es válida, demostrando que se ha comprendido el punto de partida.
2. Luego, proporcionar la contribución sustancial de la IA: completar la estructura, proponer soluciones, señalar compensaciones, ofrecer contraejemplos o recomendaciones.
3. Enfocarse en una sola pregunta que pueda cambiar la dirección; no interrogar al usuario con un cuestionario.
4. Leer la información disponible de los archivos del proyecto por sí mismo; no preguntar repetidamente al usuario.
5. Distinguir explícitamente entre intención del autor, hechos, juicios, suposiciones, decisiones y preguntas sin resolver.
6. Cada vez que surja una nueva intención del autor, corrección importante, decisión, límite o incógnita clave, actualizar el mismo documento:
   • Reescribir "Forma actual" como la instantánea más reciente y concisa;
   • En "Evolución, decisiones y límites", agregar la trayectoria;
   • Marcar, reescribir o agregar preguntas sin resolver;
   • Actualizar updated_at y el registro de versiones.

No actualizar mecánicamente el documento por cortesía, pulido de redacción o contenido repetitivo que no cambie la comprensión.

5. Mantener el Documento de Cinco Bloques

Mantener los cinco bloques de nivel superior de la plantilla y su semántica:

1. Forma actual / Current Shape: Definición en una oración, valor central, recomendación actual.
2. Origen y palabras del autor / Origin & Raw Intent: Expresión original y causa real; solo agregar citas clave, no reescribirlas en silencio.
3. Evolución, decisiones y límites / Evolution, Decisions & Boundaries: Trayectoria de la discusión, decisiones y sus razones, alternativas descartadas, límites y no-objetivos.
4. Preguntas abiertas y suposiciones / Open Questions & Assumptions: Contenido que aún espera el juicio del autor o verificación mediante evidencia.
5. Registro de cambios / Changelog: Solo agregar; explicar qué ha cambiado en la comprensión, el estado y las decisiones.

Mantener sincronizados el Frontmatter y el indicador de estado superior. La forma actual puede reescribirse; las palabras del autor, las decisiones históricas y el registro de cambios no deben eliminarse. Cuando una decisión anterior sea reemplazada, marcarla como superseded y enlazar a la nueva decisión; no falsificar un consenso único.

6. Transiciones de Estado

• captured: Se ha guardado el origen, aún no se ha entrado en exploración sustancial.
• exploring: Al menos una discusión sustancial ha cambiado o ampliado la comprensión.
• shaped: La IA ha proporcionado una síntesis completa, y el autor la ha confirmado explícitamente con frases naturales como "Estoy de acuerdo", "Así es", "Casi está", "Podemos converger".
• parked: El autor pausa explícitamente, o las condiciones necesarias para continuar aún no se cumplen; registrar la razón de la pausa y las condiciones para reiniciar.
• superseded: Una nueva idea o decisión reemplaza explícitamente esta idea; mantener referencias bidireccionales.

La IA puede sugerir convergencia, pero no puede cambiar exploring a shaped por sí misma. Elogios generales, preguntas sobre el siguiente paso o "Suena bien" no se consideran automáticamente autorización para comenzar.

7. Autorización de Implementación y Entrega

Solo considerar como autorización las expresiones inequívocas del autor, como:

• "Empieza"
• "Comienza a implementar esta idea"
• "Autorizado a hacerlo"
• Expresiones equivalentes en el mismo contexto continuo

Después de obtener la autorización:

1. Actualizar implementation_authorization a granted.
2. En la evolución y el registro de cambios, guardar las palabras del autor, la hora y el alcance de la autorización.
3. Generar una breve entrega: ID de la idea, ruta absoluta del documento, forma actual, incógnitas aún existentes.
4. Indicar explícitamente que este skill ha finalizado y que el implementador debe leer primero ese Markdown.
5. Detenerse inmediatamente; no invocar el skill de implementación, modificar el código fuente ni ejecutar comandos de implementación.

La autorización solo se aplica a la idea específicamente señalada; no se propaga a otras ideas ni se extiende a un alcance mayor.

8. Excepciones y Correcciones

• El autor corrige la intención original: Conservar la expresión antigua, registrar la corrección en la evolución y actualizar la forma actual.
• El autor cambia completamente de dirección: Conservar el historial antiguo; tratar la nueva dirección como un gran giro de la misma idea, a menos que el autor confirme que es una idea independiente.
• Captura automática seguida de que el autor indique "Esto no es una idea": Marcar el documento como parked, registrar la razón de la clasificación errónea y no entrar en exploración.
• Se descubre un documento duplicado: No eliminar ni fusionar silenciosamente; presentar la evidencia y dejar que el autor decida la fuente de verdad.
• Diálogo interrumpido: Mantener el estado actual y las preguntas sin resolver, de modo que el próximo agente de IA pueda continuar desde el documento.

9. Salida para el Usuario

Mantener la concisión: Indicar qué documento se actualizó, el status actual, el estado de autorización de implementación y la pregunta más relevante para continuar la discusión en esta ronda. No volver a pegar todo el documento en el chat.