Communitygithub.com

aiswarya797/encuentra-tus-desconocidos

Habilidad de agente de codificación de IA para convertir desconocidos ocultos en conocimientos accionables antes de la implementación.

¿Qué es encuentra-tus-desconocidos?

Esta habilidad, 'Encuentra tus Desconocidos', implementa un flujo de trabajo enrutado diseñado para cerrar la brecha entre la comprensión inicial de un usuario (el 'mapa') y la realidad del código o producto (el 'territorio') antes de tomar decisiones de implementación arriesgadas. Es especialmente útil cuando las tareas son vagas, de alto riesgo, en áreas de código no inspeccionadas, o cuando se enfrentan a la posibilidad de restricciones ocultas de producto, diseño, API, seguridad o datos. El sistema clasifica los elementos de la tarea en 'conocidos conocidos', 'conocidos desconocidos', 'desconocidos conocidos' y 'desconocidos desconocidos', y luego evalúa el nivel de incertidumbre e impacto para enrutar a uno de varios 'playbooks' especializados (por ejemplo, para parches ciegos, búsqueda de referencias o documentación de compra). Las reglas operativas enfatizan la inspección directa del territorio, el uso de sondeos económicos antes de la implementación irreversible, la formulación de una pregunta de alto impacto a la vez, y la producción de artefactos concretos como tablas de riesgo, mocks o registros de decisiones. El flujo de trabajo predeterminado implica reafirmar el mapa, inspeccionar el territorio, nombrar los desconocidos de mayor impacto, enrutar a un playbook y actuar, con un formato de salida compacto disponible para tareas que no requieren un playbook especializado.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add aiswarya797/find-your-knowns

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Encuentra Tus Desconocidos

Usa este flujo de trabajo enrutado para cerrar la brecha entre el "mapa" del usuario y el verdadero "territorio" antes de tomar decisiones de implementación arriesgadas. El mapa es el prompt, ticket, plan o referencia que el usuario te dio. El territorio es el repositorio real, el comportamiento del producto, el sistema de diseño, los datos, las API, las restricciones de producción y las expectativas tácitas del usuario.

Atribución: este es un flujo de trabajo de agente original inspirado en el artículo de Thariq Shihipar "A Field Guide to Fable: Finding Your Unknowns" y los ejemplos complementarios "Know your unknowns". Atribuye el marco de trabajo al producir artefactos reutilizables, pero no copies el texto fuente.

Política de Activación

Usa este flujo de trabajo cuando la tarea sea vaga, estética, estratégica, de alto riesgo, desconocida, de larga duración, en un área de código no inspeccionada, o probablemente oculte restricciones de producto, diseño, API, seguridad, datos, migración u operativas.

Las frases de activación fuertes incluyen "mejor", "más limpio", "bonito", "intuitivo", "listo para producción", "tú decides" y "como X". También úsalo antes de crear un plan de implementación grande, cuando la realidad de la implementación contradiga el plan, o después de la implementación para la aceptación del revisor/interesado, la explicación previa a la fusión, o los flujos de trabajo de comprensión de cambios.

No uses este flujo de trabajo para revisiones de código ordinarias, revisión de errores, revisión de seguridad o solicitudes de detección de defectos en PR. Esas tareas necesitan métodos específicos de revisión, no enrutamiento de descubrimiento de desconocidos. Mantén este flujo de trabajo ligero o saltarlo por completo cuando el cambio sea pequeño, obvio, directamente especificado, de bajo impacto o más barato de arreglar que de explorar.

Reglas Operativas

  1. Evita la ceremonia para trabajo pequeño y obvio. Si el cambio es directo, de bajo riesgo y bien especificado, di que los desconocidos son de bajo impacto y continúa.
  2. Prefiere inspeccionar el territorio antes de especular. Lee archivos relevantes, pruebas, documentos, configuraciones, esquemas, registros o referencias de producto antes de presentar los riesgos como hechos.
  3. Prefiere sondeos económicos antes de la implementación irreversible. Usa mocks, pases de grep, pruebas pequeñas, scripts desechables o mapas de referencia antes de comprometerte con una arquitectura grande.
  4. Haz una pregunta de alto impacto a la vez cuando se necesite la entrada del usuario. Prioriza preguntas que cambiarían la arquitectura, el modelo de datos, la UX, la postura de seguridad, la estrategia de migración, la API pública o el riesgo de lanzamiento.
  5. Produce artefactos concretos. Un artefacto útil puede ser una tabla de riesgos, mapa de semántica, mock, registro de decisión, archivo de notas de implementación, documento de aceptación o cuestionario. Evita listas genéricas de "considera X" sin próximas acciones.
  6. Continúa trabajando a menos que estés bloqueado. Si el usuario no está disponible y el riesgo no es crítico para la arquitectura/API/seguridad/datos, elige el valor predeterminado reversible más conservador, registra la suposición y continúa.

Triage Rápido

Clasifica la tarea antes de elegir un manual de juego:

  • Conocidos conocidos: Requisitos que el usuario dio explícitamente.
  • Conocidos desconocidos: Preguntas abiertas que el usuario ya nombró o implicó claramente.
  • Desconocidos conocidos: Gusto, convenciones, estándares de calidad y expectativas del dominio que el usuario reconocería una vez mostradas.
  • Desconocidos desconocidos: Restricciones ocultas, comportamiento, riesgos o conocimiento de dominio faltante que ninguna de las partes ha sacado a la luz todavía.

Luego clasifica la incertidumbre:

  • Baja incertidumbre, bajo impacto: Implementa directamente. Opcionalmente, anota la única suposición que usaste.
  • Incertidumbre media: Ejecuta un manual de juego enfocado y continúa.
  • Alta incertidumbre o alto radio de explosión: Inspecciona el repositorio, ejecuta una pasada de puntos ciegos, luego enruta a entrevista, búsqueda de referencia, mock o plan ajustable.
  • El plan contradice la realidad a mitad del trabajo: Usa notas de implementación y replanifica la porción afectada.
  • El trabajo está hecho pero falta comprensión o aceptación: Usa un documento de aceptación o un cuestionario de cambios.

Tabla de Enrutamiento

Carga solo los manuales de juego necesarios para la tarea actual:

  • Módulo de código base desconocido, restricciones ocultas o área de alto riesgo: lee references/blindspot-pass.md.
  • Al usuario le falta vocabulario del dominio o estándares de calidad de expertos: lee references/teach-me-my-unknowns.md.
  • Diseño vago, gusto de UX, "hazlo más bonito", "intuitivo" o "como X": lee references/design-directions.md.
  • La forma de UX/producto no está clara antes del trabajo de backend, API o estado: lee references/mock-before-wire.md.
  • El espacio de soluciones está abierto y las compensaciones de costo/riesgo importan: lee references/effort-axis-brainstorm.md.
  • Ambigüedad conocida que necesita decisiones del usuario: lee references/interview.md.
  • El comportamiento de una implementación, producto o competidor existente debe ser la especificación: lee references/reference-hunt.md.
  • Está a punto de hacerse un plan grande: lee references/tweakable-plan.md.
  • La implementación revela una sorpresa o invalida el plan: lee references/implementation-notes.md.
  • El trabajo terminado necesita aceptación del revisor o interesado: lee references/buy-in-doc.md.
  • El usuario quiere entender un cambio grande antes de fusionar: lee references/change-quiz.md.

Flujo de Trabajo Predeterminado

  1. Vuelve a exponer el mapa brevemente: lo que el usuario pidió y lo que ya se sabe.
  2. Inspecciona el territorio: recopila evidencia de la superficie relevante del repositorio/producto antes de clasificar los riesgos.
  3. Nombra los desconocidos de mayor impacto: mantén esto breve a menos que el usuario haya solicitado exploración.
  4. Enruta: elige uno o más manuales de juego de referencia de la tabla.
  5. Actúa: produce el artefacto solicitado, haz una pregunta de alto impacto o implementa con suposiciones registradas.

Usa esta salida compacta cuando no se necesite un manual de juego especializado:

Verificación de desconocidos:
- Conocidos conocidos: ...
- Desconocido de mayor riesgo: ...
- Sonda económica realizada: ...
- Suposición o pregunta: ...
- Próxima acción: ...

Ejemplo de Enrutamiento

  • Módulo de código base desconocido: "Agrega SSO a este paquete de autenticación; no lo he tocado antes" -> blindspot-pass.md, luego tweakable-plan.md si el riesgo es alto.
  • Solicitud de diseño vaga: "Haz que el panel de reseñas sea más limpio y premium" -> design-directions.md, opcionalmente mock-before-wire.md.
  • Ambigüedad arquitectónica conocida: "¿Debería vivir esto en la puerta de enlace de API o en el trabajador?" -> interview.md, luego tweakable-plan.md.
  • Implementación basada en referencia: "Porta el comportamiento de reintento de esta caja de Rust a nuestro cliente de TypeScript" -> reference-hunt.md.
  • Desviación a mitad de la implementación: "El esquema no admite la migración planificada" -> implementation-notes.md, luego pregunta solo si el nuevo camino cambia el contrato de datos/API.
  • Cuestionario previo a la fusión: "Asegúrate de que entiendo esta rama antes de fusionar" -> change-quiz.md.

Skills relacionados