Communitygithub.com

shimo4228/search-first

Skill para Claude Code: obliga a los agentes a investigar soluciones existentes antes de construir — reduce la reinvención

¿Qué es search-first?

Este skill impone una disciplina de investigación previa a la implementación, diseñada para agentes de IA como Claude Code. Su objetivo es minimizar la reinvención de la rueda asegurando que el agente busque, evalúe y documente soluciones existentes antes de escribir código nuevo. El skill define un flujo de trabajo de tres pasos: articular el requisito en texto legible, buscar por orden de prioridad (repositorio local, registros de paquetes, servidores MCP, herramientas instaladas, código abierto) y registrar un veredicto final. Además, ofrece un modo rápido para necesidades simples y un modo completo que delega la investigación a un subagente. Incluye un manejo explícito para cuando el usuario pide saltar la investigación, asegurando que la decisión quede registrada. El skill es independiente del mecanismo de búsqueda concreto, por lo que funciona con cualquier harness de agente que soporte invocación de herramientas o subagentes.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/search-first

Preguntar en tu IA favorita

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

Documentación

/search-first — Investiga antes de codificar

Antes de escribir una nueva funcionalidad, utilidad, integración o elegir una biblioteca, busca primero una solución existente. El mejor código es el código que no tienes que escribir.

Este skill es disciplina, no mecanismo. El cómo de la búsqueda — subagentes paralelos, consulta de documentación en vivo, consultas a registros — pertenece a tu harness de agente y sigue cambiando. Lo que este skill fija es la parte que sobrevive a esos cambios: articula antes de buscar, busca por prioridad de fuente y termina con un veredicto registrado. Lidera con la disciplina; delega el mecanismo.

Paso 0 — Articular el requisito (obligatorio, texto visible para el usuario)

Antes de cualquier llamada a herramienta o subagente, escribe 2–3 frases de texto simple de asistente (no oculto dentro de argumentos de herramienta) indicando:

  • Qué funcionalidad se necesita — concretamente, no "soporte para X"
  • Lenguaje / framework que usará la implementación
  • Restricciones — dependencias existentes, límites de rendimiento, requisitos de licencia

Por qué: esto externaliza la consulta de búsqueda para que el usuario pueda redirigir antes de que gastes esfuerzo, y deja un registro auditable. Una llamada a subagente cuyos args llevan el requisito no satisface este paso — el usuario lee texto del chat, no argumentos de herramienta. Emite la articulación como texto primero, luego llama a herramientas cuyos argumentos pueden reflejarlo.

Paso 1 — Buscar por prioridad de fuente

Revisa estos en orden; detente temprano cuando encuentres una coincidencia sólida:

  1. Este repositorio — rg / grep en los módulos y pruebas relevantes. La cosa puede que ya exista aquí.
  2. Registros de paquetes — npm / PyPI / crates / módulos de Go para el lenguaje en uso.
  3. Servidores MCP — primero los servidores ya configurados, luego el registro. La capacidad puede que ya esté integrada.
  4. Skills / agentes / herramientas instaladas — tu harness puede que ya lo tenga.
  5. OSS mantenido / plantillas — busca en GitHub antes de escribir código nuevo.

Consulta la documentación en vivo en el momento de la decisión (ej. context7, o el propio registro) en lugar de confiar en hechos recordados sobre paquetes — las recomendaciones envejecen.

Paso 2 — Decidir y registrar un Veredicto

Evalúa los candidatos de forma integral: ajuste funcional, mantenimiento (último commit, rapidez de respuesta a incidencias), comunidad, documentación, licencia, huella de dependencias. Describe fortalezas y debilidades en prosa. No asignes puntuaciones numéricas (8/10), calificaciones con letras, o tablas de puntos ponderados — fabrican falsa precisión; un veredicto basado en evidencia es la salida honesta.

VeredictoCuándoAcción
AdoptarCoincidencia exacta, bien mantenido, licencia permisivaInstalar y usar directamente
ExtenderBuena base, ajuste parcialInstalar + envoltorio delgado / configuración
ComponerVarias coincidencias débilesCombinar 2–3 paquetes pequeños
ConstruirNada adecuadoEscribir personalizado — pero informado por lo encontrado

Termina cada pase con una línea de veredicto reconocible — esta línea es el entregable:

Veredicto: <Adoptar|Extender|Componer|Construir> — <paquete(s) o "personalizado"> — <razón basada en evidencia>

Una búsqueda sin línea de veredicto es un pase incompleto: hiciste el trabajo pero dejaste ninguna decisión en la que el usuario (o el siguiente paso) pueda actuar — el error más común de este flujo de trabajo. Respalda la razón con evidencia (estrellas, fecha del último commit, la coincidencia de funcionalidad específica), nunca con adjetivos ("se ve bien", "popular").

Modo Rápido vs Modo Completo

  • Modo Rápido (en línea) — para una necesidad única y obvia: ejecuta los Pasos 0–2 tú mismo con unas pocas búsquedas y declara el veredicto.
  • Modo Completo (delegar) — para necesidades no triviales: después del Paso 0, entrega el barrido a un subagente de investigación (lo que tu harness proporcione para descubrimiento de soluciones). Refleja la articulación en su prompt y haz que devuelva candidatos más un veredicto en el formato anterior. Reserva la investigación pesada de múltiples fuentes para preguntas realmente difíciles — encontrar una biblioteca es más ligero que un informe de investigación.

Cuando el usuario dice "saltar investigación"

Si el usuario te dice que saltes la investigación ("solo implementa", "no hay tiempo", "usa lo que sea"), aún así registra la decisión como una línea de veredicto antes de implementar — saltar la investigación es en sí misma una decisión, así que recibe un veredicto como cualquier otro pase (esto mantiene la elección auditable y la ventana de corrección de rumbo abierta):

Saltando la investigación a tu petición — no he comprobado si existe una biblioteca existente para X. Veredicto: <Adoptar|Construir> — <elección tentativa o "personalizado"> — elegido sin investigación a tu petición; di la palabra para un escaneo de 60 segundos.

Por qué: el usuario puede no saber que ya existe una solución; un salto silencioso les quita su oportunidad de corregir el rumbo. Después de la línea de veredicto, procede sin buscar — no uses esto como una puerta trasera para hacer investigación completa de todos modos.

Anti-patrones

  • Saltar al código — escribir una utilidad sin comprobar si existe una.
  • Ignorar MCP / capacidad instalada — reconstruir lo que ya está integrado.
  • Sobrepersonalizar — envolver una biblioteca tan pesadamente que se pierde su beneficio.
  • Inflar dependencias — instalar un paquete enorme para una pequeña funcionalidad.
  • Buscar sin veredicto — hacer el trabajo de piernas pero nunca registrar una decisión.

Ejemplos (ilustrativos — verifica paquetes en vivo)

Estos muestran cómo se lee un veredicto; no son respaldos actuales de paquetes. Vuelve a buscar antes de confiar en cualquier paquete específico.

  • Verificación de enlaces rotos → una regla de verificación de enlaces mantenida, con licencia permisiva que cubre todos los tipos de enlace → Veredicto: Adoptar — textlint-rule-no-dead-link — mantenimiento activo, MIT, cobertura completa
  • Publicación cruzada en Qiita → solo existen envoltorios parciales sin mantenimiento → Veredicto: Construir — personalizado — no hay solución completa mantenida; reutiliza la API de la plataforma mediante un cliente HTTP
  • Consistencia de terminología en JP → un verificador basado en diccionario que necesita una configuración de proyecto → Veredicto: Extender — textlint-rule-prh — instalar + un diccionario de proyecto

Skills relacionados