CodeGuide

¿Qué es CodeGuide?

CodeGuide es un generador de contexto basado en especificaciones para herramientas de IA de programación. Ayuda a convertir una idea o un repositorio de GitHub existente en documentos de proyecto estructurados —como PRDs, especificaciones técnicas y wireframes— que los modelos de IA pueden consultar al implementar software.

El propósito principal es reducir el problema de la “caja negra” en el desarrollo asistido por IA creando una base de conocimiento del proyecto con un contexto más claro para la planificación y documentación, ya sea que empieces desde una descripción o extiendas un repositorio heredado.

Características principales

• Generación de documentación basada en especificaciones (entrada en inglés natural): Describe tu proyecto en inglés natural para generar un kit de documentación, incluyendo PRDs, guía de pila tecnológica y wireframes.
• Documentación de repositorios de GitHub existentes: Alimenta proyectos de GitHub existentes para mapear el código y que las herramientas de IA tengan un contexto más claro sobre el contenido del repositorio.
• Flujo de trabajo de documentación con IA (preguntas aclaratorias → plan → docs): Proporciona un resumen del proyecto y responde preguntas abiertas (p. ej., comportamiento de notificaciones, onboarding, restricciones de funciones) para dar forma a la documentación resultante.
• Agente de codificación autónomo Software v2: Usa un agente que puede analizar un codebase, planificar documentación y ejecutar tareas de codificación de forma “autónoma” en sesiones extendidas.
• Interfaz unificada para múltiples herramientas CLI / enrutamiento de modelos: Opera con una sola interfaz mientras varios modelos de IA trabajan en sincronía; un enrutador de modelos selecciona modelos para diferentes partes del flujo de trabajo.
• Extensión de Chrome para generación en navegador: Genera PRDs, especificaciones técnicas y documentación directamente desde tu navegador.
• Editor de UI en pantalla: Edita en pantalla y coordina múltiples agentes en paralelo para correcciones de UI o adiciones de funciones.
• Kits de inicio para reducir el esfuerzo de configuración: Plantillas de código abierto para modelos de IA de codificación incluyen infraestructura común como autenticación, configuración de base de datos y configuración de pagos con Stripe (como se describe para las plantillas).

Cómo usar CodeGuide

1. Empieza con una idea o un repo: Describe en inglés natural lo que quieres construir o apunta CodeGuide a un proyecto de GitHub existente.
2. Responde las preguntas del proyecto cuando se soliciten: Usa las preguntas aclaratorias para especificar el comportamiento del producto y las restricciones.
3. Genera el kit de documentación: Produce las salidas necesarias para la implementación, como PRDs, especificaciones técnicas, wireframes y artefactos de planificación relacionados.
4. Usa Software v2 para la ejecución: Si pasas a la codificación e implementación, ejecuta el agente autónomo para analizar el codebase y seguir la documentación planificada.
5. Opcionalmente usa la extensión de Chrome: Genera PRDs/especificaciones técnicas/documentación desde tu flujo de trabajo en el navegador.

Casos de uso

• Convierte una idea de app en especificaciones listas para implementación: Un desarrollador describe un concepto de app (p. ej., app móvil vs. sitio web) y responde preguntas sobre comportamiento del producto para obtener PRDs, especificaciones técnicas y wireframes.
• Documenta un repositorio de GitHub heredado para desarrollo con IA: Cuando trabajas con código antiguo difícil de interpretar, alimenta el repositorio para obtener un contexto mapeado y consumible por IA para tareas de codificación posteriores.
• Planifica requisitos de producto antes de usar un asistente de codificación con IA: Usa las especificaciones generadas como entrada estructurada para que una herramienta de codificación con IA implemente funciones basadas en requisitos explícitos en lugar de prompts ad hoc.
• Ejecuta trabajo de codificación autónomo con un agente: Usa Software v2 para coordinar análisis de codebase, planificación y ejecución de codificación en una sesión más larga con una interfaz unificada.
• Mejora o extiende una UI de forma iterativa: Usa el editor en pantalla para corregir problemas de UI o agregar funciones mientras múltiples agentes trabajan en paralelo.

Preguntas frecuentes

¿CodeGuide genera documentación a partir de una descripción, un repositorio o ambos?

CodeGuide soporta ambos: puede generar documentación a partir de una idea en lenguaje natural y puede generar documentación para codebases de GitHub existentes mapeando el repositorio para contexto de IA.

¿Qué tipos de documentos puede producir CodeGuide?

El sitio describe PRDs, tech specs y wireframes como salidas clave, junto con un kit de documentación más amplio vinculado a tu brief del proyecto.

¿Qué es Software v2?

Software v2 se describe como un agente de programación autónomo que puede analizar codebases, planificar documentación y ejecutar código, con una interfaz unificada y múltiples modelos sincronizados.

¿Cómo ayuda el producto con las alucinaciones de IA?

El sitio enmarca el enfoque como la creación de una base de conocimiento del proyecto y specs/contexto estructurado que los modelos de IA pueden referenciar, con el objetivo de reducir las “adivinanzas” causadas por contexto ausente o poco claro.

¿Hay herramientas para usar CodeGuide fuera de la app principal?

Sí. El sitio menciona una extensión de Chrome para generar PRDs, tech specs y documentación directamente desde el navegador.

Alternativas

• Escritura manual de PRD/tech-spec más asistente de IA para programación: Escribe la documentación tú mismo (o con un chat de IA general) y luego proporciónala a una herramienta de programación; difiere en que depende de specs creados por el usuario en lugar de mapeo de repositorio y un flujo de generación estructurado.
• Copilotos de IA para programación de propósito general: Herramientas enfocadas en generación y refactorización de código pueden no proporcionar el mismo kit de documentación de extremo a extremo (PRDs/tech specs/wireframes) ni mapeo de repositorio descrito aquí.
• Herramientas de análisis de codebase centradas en documentación: Enfoques centrados en generar documentación desde código fuente (sin flujo de spec/PRD) pueden ayudar a la comprensión pero no producen los mismos artefactos de planificación vinculados a requisitos de producto.
• Plantillas iniciales/boilerplates con planificación separada: Usar boilerplates puede reducir el tiempo de configuración, pero aún necesitarías otro proceso para generar PRDs/tech specs y wireframes para flujos de programación con IA.