Tu repositorio tiene ADN.
Hunch se lo enseña a cada agente de programación.

Cada agente de programación llega dominando la sintaxis y sin conocer a tu equipo. Hunch le da el lenguaje, las decisiones, las correcciones difíciles y los límites que hay detrás del código antes de que lo cambie.

el problema del extraño brillante

Entiende la sintaxis. No entiende por qué tu equipo dice que no.

El código permanece. El criterio ganado con esfuerzo se desvanece.

Lunes

Un equipo resuelve un doloroso error de cierre de sesión.

Mueven las sesiones al servidor para poder revocar de inmediato un token filtrado. La decisión añade complejidad, pero cierra la brecha.

Meses después

El código permanece. El contexto se desvanece.

El incidente queda enterrado en un pull request antiguo. Dos personas cambian de equipo. El flujo inusual de la sesión ahora parece maquinaria innecesaria.

Siguiente sesión

Un extraño brillante propone «simplificarlo».

El cambio es limpio y correcto de forma local. También reabre el mismo fallo que el equipo ya pagó por comprender.

Con Hunch

El repositorio enseña al agente antes de editar.

Hunch recupera qué se eligió, qué se descartó y qué error evita la decisión. El agente trabaja con el criterio del equipo sin fingir que es el equipo.

cómo funciona el ADN del proyecto

Hunch aprende cómo funciona este repositorio y después da a cada agente solo lo que importa.

Convierte la evidencia que ya existe en el repositorio en contexto acotado y relevante. Los hábitos observados siguen siendo consejos; solo las reglas en las que las personas confían de forma explícita pueden obtener autoridad de aplicación.

01 / observar

Lee las señales del propio repositorio.

Hunch estudia una revisión exacta de Git, historial acotado, convenciones comprometidas y evidencia de revisiones que tus herramientas están autorizadas a aportar.

02 / comprender

Construye una imagen trazable.

El lenguaje, los hábitos de contribución, las expectativas de revisión y las convenciones de ingeniería conservan su confianza, vigencia y evidencia.

03 / enseñar

Lleva el ADN adecuado al trabajo.

El agente recibe el contexto relevante antes de editar. El comportamiento común nunca se convierte en regla a escondidas y la autoridad sigue siendo humana.

ADN del proyecto en v1.22

Comprensión basada en evidencia, no en sensaciones.

Hunch construye un perfil ligado a una revisión concreta a partir del historial de Git, archivos de convenciones y evidencia acotada de revisiones. El texto bruto de la colaboración no entra en el perfil y los hábitos observados nunca se convierten en política.

npm i -g @davesheffer/hunch
revisión exactael perfil queda ligado al código que describe
confianza + vigenciacada rasgo indica con qué fuerza y actualidad está respaldado
evidencia selladael agente puede mostrar la base de cada observación

El ADN del proyecto puede orientar la exploración, la terminología y la revisión. No puede crear ni anular una decisión, restricción, política o permiso. Lee cómo funciona el límite de evidencia →

qué lo hace confiable

No es una personalidad. No es una política invisible. Es evidencia que puedes inspeccionar.

Hunch mantiene separados el ADN observado del proyecto, la memoria duradera de ingeniería y las reglas aprobadas por personas. Cada respuesta indica de dónde viene, su vigencia y la autoridad que realmente tiene.

ADN del proyecto

Aprende cómo habla el repositorio

El vocabulario, los hábitos de contribución, las expectativas de revisión y las convenciones de ingeniería provienen de evidencia del repositorio, no de una personalidad generada.

memoria de ingeniería

Recuerda por qué existe el código

Las decisiones, los enfoques descartados, las correcciones y los errores resueltos siguen disponibles cuando el chat, el pull request o el compañero ya no están.

grafo de código

Sabe qué puede afectar un cambio

Hunch sigue las conexiones entre archivos y funciones para mostrar la razón adecuada en el lugar adecuado.

autoridad humana

Nunca convierte popularidad en política

Los patrones observados siguen siendo orientativos. Solo una regla precisa en la que las personas decidan confiar puede obtener autoridad de aplicación.

evidencia adjunta

Muestra de dónde sale cada afirmación

La confianza, la vigencia, la procedencia y la revisión de respaldo viajan con el contexto que recibe el agente.

local primero

Tu memoria sigue siendo tuya

Hunch no requiere una cuenta alojada. Guarda la memoria en tu proyecto o en un repositorio Git privado que controle el equipo.

primeros pasos

Deja que tu repositorio se presente.

Instala Hunch

Un solo comando lee tu proyecto y conecta los asistentes de programación que ya usas.

Añade el historial que explica por qué

hunch backfill --since 90d encuentra decisiones y lecciones útiles en los commits de los últimos 90 días.

Mira lo que aprendió Hunch

Inspecciona el ADN de tu proyecto y después pregunta: «¿Por qué está construido así el módulo de sesiones?» Cada respuesta viene con evidencia.

Claude CodeCursorVS CodeWindsurfCodexAntigravityAGENTS.md
  ~/your-repo
# instalación desde npm — requiere Node 22.13+
$ npm install -g @davesheffer/hunch

# conecta Hunch al proyecto y a tus asistentes
$ cd your-repo && hunch init

# aprende opcionalmente de los últimos 90 días
$ hunch backfill --since 90d

# inspecciona el ADN del repositorio basado en evidencia
$ hunch dna inspect

# pregunta para qué sirve un archivo
$ hunch why src/auth/session.ts
npm i -g @davesheffer/hunch && hunch init

El ADN del proyecto y la memoria son orientativos por defecto. Nada se bloquea hasta que lo actives de forma explícita.

¿Usas Claude Code? Instálalo como plugin:
/plugin marketplace add davesheffer/hunch/plugin install hunch@hunch
Open VSX

Enseña a cada agente cómo funciona tu repositorio.

Dale el lenguaje, las decisiones, las lecciones difíciles y los límites que hay detrás del código antes de que lo cambie, y mantén cada afirmación trazable.