Usando Claude Code para revitalizar proyectos personales abandonados: una guía práctica

Matthew Brunelle escribe sobre el uso de herramientas de asistencia de codificación con IA (específicamente Claude Code con Opus 4.6) para revivir proyectos personales abandonados. Su proyecto: un shim entre YouTube Music y la API de OpenSubsonic que permite a cualquier cliente compatible con Subsonic (Navidrome, Feishin, Symfonium) reproducir música desde YouTube Music. El proyecto se estancó originalmente debido a la larga lista de endpoints por implementar.

Configuración

Brunelle creó un proyecto uv con fastapi, pydantic, ytmusicapi y yt-dlp como dependencias. Colocó el especificación OpenAPI de OpenSubsonic en la carpeta, añadió un breve README, un archivo TODO vacío y generó un CLAUDE.md mediante /init. También añadió convenciones a CLAUDE.md:

## Convenciones
- Los métodos deben tener anotaciones de tipo para argumentos y retornos, así como docstrings.
- Usa Pydantic para el modelado de datos. Usa las convenciones modernas de Pydantic V2.
- Los docstrings deben usar el formato de estilo Google con secciones de args y returns.
- Escribe pruebas unitarias con el estilo moderno de pytest, por ejemplo métodos de nivel superior usando `assert` y fixtures.

Flujo de trabajo

El flujo de trabajo típico de Brunelle:

• Entrar en modo de planificación. Indicar la siguiente tarea.
• Después de obtener el plan inicial, buscar brechas/problemas y hacer preguntas de seguimiento hasta estar satisfecho.
• Proporcionar enlaces a recursos cuando Claude se equivoque.
• Pedir a Claude que use la herramienta de búsqueda para enfoques idiomáticos.
• Usar "Aceptar y limpiar contexto". Repetir.

Implementación inicial

Primera indicación: Echa un vistazo al archivo openapi.json. Este es un spec para la api de opensubsonic. Implementa un servidor fastapi asíncrono que genere stubs para todos los métodos. Solo necesitas manejar los endpoints json más nuevos.

Después de implementar los stubs, verificó la corrección con una indicación de seguimiento. Incluso con un spec, Claude cometió errores la primera vez pero los corrigió en el segundo pase. También volvió a ejecutar /init para actualizar CLAUDE.md.

Siguiente indicación importante

Los métodos para todos los endpoints están como stubs ahora. Quiero conectar un cliente subsonic, buscar una canción y transmitirla al cliente. ¿Cuál es la cantidad mínima de funcionalidad necesaria para implementar eso? Usa ytmusicapi para buscar en YouTube Music y yt-dlp para la transmisión.

Brunelle informa que la implementación inicial de transmisión parecía razonable pero falló al conectarse con Feishin. El artículo se corta antes de detallar la solución, pero el post completo contiene la resolución.

Brunelle señala que los proyectos abandonados son candidatos ideales para probar la asistencia de codificación con IA: "nunca iban a terminarse de todos modos". Planea hacer un seguimiento con un post en OpenCode.