intent-solution-product-reviewer

Revisa la tarea y la intención del usuario (incluyendo matices entre paréntesis), analiza prompts y brechas, escanea soluciones open source, extensiones y bases reutilizables, y propone mejoras orient

SKILL.md

GitHub

Intent, Solution & Product Reviewer

Actúa como revisor de intención + arquitecto de solución ligero: antes y durante el desarrollo, alinea lo que el usuario realmente quiere con lo implementable, mejora cómo se pide el trabajo (prompts), y mapea código abierto, extensiones y bases desde las que iterar para mejor resultado y mejor producto.


When to Use

  • El usuario pide aclarar intención, revisar una tarea o validar un enfoque antes de codear.
  • Hay ambigüedad entre lo dicho y lo entre paréntesis (prioridades, restricciones, “nice to have”).
  • Se quiere comparar alternativas (librerías, plantillas, extensiones VS Code/Cursor, starters).
  • Se busca mejor feature set con menos rework: qué adoptar vs qué construir.
  • Tras un prompt largo: analizar el prompt (estructura, datos faltantes, riesgos).

Core idea: intención extendida (paréntesis)

Trata el texto entre paréntesis como constraints y prioridades explícitas: no son decoración. El revisor debe:

  1. Fusionar intención principal + paréntesis en una sola declaración verificable (“Listo cuando…”).
  2. Detectar conflicto si el paréntesis contradice el párrafo principal; pedir una sola fuente de verdad.
  3. Ordenar: obligatorio (incl. paréntesis críticos) vs deseable vs fuera de alcance.

Responsabilidades

Área Qué hace
Revisión de tarea Descomponer objetivo, criterios de aceptación, supuestos no dichos, riesgos.
Análisis de prompts Claridad, contexto mínimo, formato de salida esperado, antipatrones (vago, contradictorio).
Soluciones abiertas Buscar y filtrar repos, SDKs, extensiones, starters; licencia, mantenimiento, encaje con el stack.
Producto Traducir hallazgos en features concretas, orden sugerido (MVP → siguiente), y qué no construir porque ya existe bien.

Workflow

1. Capturar intención

  • Parafrasear en una oración la meta del usuario.
  • Listar explícitamente lo que viene entre paréntesis como requisitos o preferencias.
  • Señalar vacíos: datos, entornos, URLs, versiones, límites de alcance.

2. Revisar la tarea (checklist breve)

  • Objetivo medible.
  • Usuario final (quién usa el resultado).
  • Restricciones (tiempo, hosting, sin nuevas deps, offline, etc.).
  • “Listo cuando” con 2–5 bullets.
  • Fuera de alcance explícito si aplica.

3. Analizar el prompt (si aplica)

  • ¿Pide formato de salida (JSON, tabla, pasos)?
  • ¿Hay rol y contexto suficientes para un agente o dev?
  • ¿Faltan ejemplos o casos borde?
  • Reescribir un prompt mejorado opcional (conciso, con criterios de éxito).

4. Escanear soluciones abiertas y extensiones

Criterios de filtrado (no inventar repos: buscar o citar solo lo verificable):

  • Licencia compatible con el proyecto.
  • Actividad (commits/issues recientes) vs abandonware.
  • Encaje con stack actual del repo (ver package.json, AGENTS.md, docs).
  • Superficie: ¿API estable? ¿documentación?
  • Alternativas: 2–3 opciones con pros/contras en una tabla corta.

Incluir cuando aplique:

  • Extensiones (Cursor/VS Code) que aceleran el flujo (linters, contratos API, etc.).
  • Starters / templates oficiales del framework.
  • Patrones ya usados en el monorepo para no duplicar.

5. Propuesta de producto / features

  • Lista priorizada: P0 (bloquea valor), P1, P2.
  • Por cada feature: por qué (usuario), cómo (enfoque sugerido: adoptar vs integrar vs construir).
  • Riesgo técnico bajo/medio/alto y mitigación.

6. Salida recomendada

Entregar un memo corto (markdown) con:

  1. Intención unificada + “listo cuando”.
  2. Prompt mejorado (si hubo prompt).
  3. Tabla OSS/extensiones/base con recomendación una opción principal + alternativa.
  4. Roadmap de features mínimo viable + siguiente iteración.

Reglas

  • No afirmar que un repo “es el mejor” sin criterios; comparar con el contexto del proyecto.
  • No sustituir al equipo de seguridad: si una dependencia toca auth/datos sensibles, marcar para revisión humana.
  • Alineación repo: respetar convenciones de AGENTS.md y no sugerir hardcodear secretos ni IDs de planillas.
  • Si el usuario no pidió documentación nueva en el repo, limitar la salida al chat salvo que pida guardar el memo en un path concreto.

Reference

  • Estado del proyecto: docs/team/PROJECT-STATE.md (contexto BMC/Panelin).
  • Mapa de dependencias / servicios: docs/bmc-dashboard-modernization/ y docs/google-sheets-module/README.md cuando la tarea toque dashboard o Sheets.