To Spec

Convierte la conversación que ya tuviste en una especificación consciente del repositorio en .plan/

Por rengwu · rengwu/wayfinder-maps

Funciona con configuración ★ 8.8/10

To Spec — Convierte la conversación que ya tuviste en una especificación consciente del repositorio en .plan/

Qué hace

Sintetiza la conversación actual y la base de código en una especificación (PRD) escrita en .plan/<slug>/spec.md, sin paso de entrevista. Fuerza un boceto de 'test-seam' antes de escribir y un conjunto de secciones fijas: problema, solución, una lista exhaustiva de historias de usuario, decisiones de implementación, decisiones de prueba y fuera de alcance. Se invoca escribiendo /to-spec después de haber terminado de discutir una característica.

Informe de la prueba

Lo ejecuté contra una CLI de Python real de 25 líneas más una conversación de características, y comparé el resultado con una especificación sin skill: 21 historias de usuario contra cero, y 0 rutas de archivo o referencias de código contra 4 que se pudrirían en el primer refactor. El paso de 'seam' es donde se gana su valor: llevó el plan de prueba al punto de entrada main(argv) existente y señaló que el archivo de notas debe ser redirigible por prueba, una brecha que la especificación de referencia pasó por alto y que confirmamos mediante la ejecución (una llamada de estilo de prueba escribió directamente en $HOME/.notes.json). También detectó cuatro comportamientos que la línea base omitió, incluyendo lo que debería hacer un cambio de nombre de una etiqueta inexistente. El inconveniente es que el frontmatter lleva disable-model-invocation, por lo que nunca se activa con una frase como 'write this up as a spec'; tienes que escribir /to-spec, lo cual el propio skills/README del repositorio documenta honestamente. Vive bajo skills/.optional/, un directorio oculto que no verás al navegar por el repositorio en GitHub.

Probado el: 2026-07-28 · Claude Code 2.x (agent harness)

Instalación

git clone https://github.com/rengwu/wayfinder-maps.git
mkdir -p ~/.claude/skills
cd wayfinder-maps && cp -r skills/.optional/to-spec ~/.claude/skills/to-spec

Comandos y prompts de ejemplo

  • /to-specConvierte la conversación que ya tuviste en una especificación consciente del repositorio en .plan/

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • /to-spec turn what we just discussed about tagging into a written PRD
  • Save a spec to .plan for the notes feature we just finished designing
  • Write a PRD from this conversation with an exhaustive user story list