vibe-coding-cn: la guía china de programación con IA que sus propios issues acusan de copia
2025Emma/vibe-coding-cn · 22.991★ · 2.420 forks
2025Emma/vibe-coding-cn es una base de conocimiento en chino titulada «Vibe Coding 指南» (Guía de Vibe Coding): un repositorio que reúne una metodología de programación por pareja con IA, cientos de prompts organizados, un conjunto de skills y una pequeña herramienta de conversión de prompts. No es un producto instalable, un servidor ni una librería pública: su valor está en el contenido leíble (metodología, prompts, skills, documentación) y en un único script ejecutable para gestionar la base de prompts. Lo que define a este repositorio no es su contenido técnico —que proviene de otra parte— sino su procedencia: es una copia de la versión china mantenida por tukuaiai (hoy tradecatlabs), y esa circunstancia explica tanto sus más de 22.000 estrellas como la crítica abierta que recibe en sus propios issues.

Origen
El contenido de este repositorio no nace aquí, sino que se remonta a una guía en inglés:
EnzeD/vibe-coding— «Ultimate Guide to Vibe Coding V1.2.2», creada por Nicolas Zullo (@NicolasZu) el 12 de marzo de 2025. Es la obra original en inglés (4.782 estrellas y 2.064 bifurcaciones, medidas el 10 de septiembre de 2026). Su README declara explícitamente la autoría de Zullo y la fecha de creación.tradecatlabs/vibe-coding-cn(antestukuaiai/vibe-coding-cn, id 1102195393) — la adaptación y ampliación al chino, creada el 23 de noviembre de 2025 como bifurcación de la guía original. Muestra 16.149 estrellas y 1.618 bifurcaciones; su portada enlaza ax.com/123olpy su README atribuye el proyecto a tukuaiai, Nicolas Zullo y 123olp.2025Emma/vibe-coding-cn(este repositorio) — creado el 17 de diciembre de 2025 por la cuenta2025Emma(cuenta abierta el 23 de enero de 2025, 103 seguidores, 10 repositorios públicos, sin nombre ni biografía). Es una copia de la versión detukuaiai: sus 130 commits están firmados íntegramente portukuaiai, el primero de ellos «Initial commit: Synchronize local state with remote» (13 de diciembre de 2025). El README sigue enlazando insignias, issues e imágenes de contribuidores atukuaiai/vibe-coding-cn, y repite el trío de autores (tukuaiai, Nicolas Zullo, 123olp).

El propio README lo deja escrito al pie de su «Entrada»: esa sección de instalación es «del autor original, no la escribí yo; solo actualicé a lo que creo que es el mejor modelo». La guía ha evolucionado a lo largo de versiones de modelos: su README documenta el paso de Grok 3 → Gemini 2.5 Pro → Claude / Codex. En síntesis, este repositorio es un espejo re-hosted de una traducción, y no la fuente del método.
Filosofía y principios
El README sintetiza la filosofía en una máxima central y un marco de cuatro niveles:
- Máxima: «规划就是一切» (Planificar es todo). No hay que dejar que la IA planifique de forma autónoma, o el código se convertirá en un desorden inmanejable. La definición operativa que da el repo es: Vibe Coding = planificación por diseño + contexto fijo + ejecución por pareja con IA.
- Marco 道法术器 (Dao–Fa–Shu–Qi), tomado de la estructura clásica china:
- 道 (Vía) — principios: «si la IA puede hacerlo, no lo hagas a mano»; «todo problema, pregúntaselo a la IA»; el contexto es el elemento de primera importancia (basura entra, basura sale); estructura antes que código; navaja de Occam; ley de Pareto (el 20 % importante).
- 法 (Método): objetivo en una frase + no-objetivos; «si se puede copiar, no escribir» (reutilizar repos existentes); leer primero la documentación oficial y dársela a la IA; dividir por responsabilidad; interfaz primero, implementación después; tocar un solo módulo a la vez; la documentación es el contexto.
- 术 (Técnica): dejar claro qué se puede y qué no se puede cambiar; el debug solo con «esperado vs. real + mínimo reproducible»; las pruebas puede hacerlas la IA pero las aserciones las revisa el humano; abrir una nueva sesión cuando el código crece.
- 器 (Herramientas): IDE/terminal, modelos de IA, herramientas de desarrollo y plantillas.

- Metodología α/Ω (auto-optimización recursiva): un prompt «madre» generador (α) y otro optimizador (Ω) forman un ciclo recursivo: Ω optimiza α, α genera los prompts objetivo, y el resultado se reintroduce para la siguiente iteración. El repo enlaza un documento interno titulado «A Formalization of Recursive Self-Optimizing Generative Systems».

- Jerarquía de modelos: el README clasifica los modelos en tres escalafones y recomienda usar solo el primero para tareas complejas (en su lectura,
codex-5.1-max-xhigh,claude-opus-4.5-xhigh,gpt-5.2-xhigh).
El README advierte, además, que «las siguientes experiencias no son universalmente aplicables; adóptalas de forma dialéctica según el contexto».
Cómo funciona
El flujo documentado (espejo de la guía original) es un ciclo planificado y auditable:
- Documento de diseño (GDD) o PRD: pedir a la IA un
game-design-document.md(o un PRD si es una aplicación) en Markdown; revisarlo y mantenerlo deliberadamente simple. - Pila tecnológica + reglas (
CLAUDE.md/AGENTS.md): pedir la pila «más simple pero robusta» y guardartech-stack.md; usar/initen Claude Code o Codex CLI para generar las reglas; revisarlas y marcar como «Always» las reglas críticas (por ejemplo, «lee siemprememory-bank/architecture.mdy el documento de diseño antes de escribir código»). - Plan de implementación: con el GDD y la pila, generar un plan en Markdown de pasos pequeños y concretos; cada paso incluye una prueba de verificación; sin código, solo instrucciones; centrarse primero en el juego base.
- Banco de memoria (
memory-bank): carpeta del proyecto con cinco archivos:game-design-document.md,tech-stack.md,implementation-plan.md,progress.md(vacío, para anotar pasos hechos) yarchitecture.md(vacío, para anotar la función de cada archivo).

- Programar por pasos: leer
memory-bank, pedir clarificación (la IA suele hacer 9–10 preguntas), ejecutar el paso 1; el humano corre las pruebas; al validar, commit, abrir un chat nuevo (/clearo/new) y continuar con el paso 2; repetir hasta agotar el plan. - Añadir detalles: por cada función importante, crear un
feature-implementation.mdcon pasos cortos y pruebas. - Corregir errores y atascos:
/rewinden Claude Code (ogit reseten Codex); pegar el error del console del navegador (F12); para atascos graves, comprimir todo el repositorio con RepoPrompt/uithub y pedir ayuda a la IA. - Trucos: fuerza de pensamiento
think < think hard < think harder < ultrathink;/compactpara acortar contexto; y, bajo el riesgo del propio usuario,--yolo/--dangerously-skip-permissionspara desactivar las confirmaciones.
El contenido material del repo se organiza en i18n/zh/prompts/ (subcarpetas system_prompts, coding_prompts, assistant_prompts, user_prompts), i18n/zh/skills/ (incluida una meta-skill claude-skills que genera skills), i18n/zh/documents/ (metodología, plantillas y tutoriales) y libs/ (con la herramienta de prompts y la de localización).
El ecosistema
El «ecosistema» de este repositorio es sobre todo su linaje y sus herramientas internas, no una comunidad de plugins a su alrededor:
EnzeD/vibe-coding(Nicolas Zullo) — la obra original en inglés; 4.782 estrellas, 2.064 bifurcaciones.tradecatlabs/vibe-coding-cn(antestukuaiai/vibe-coding-cn) — la versión china de la que este repo se copia; 16.149 estrellas, 1.618 bifurcaciones.2025Emma/vibe-coding-cn(este repositorio) — 22.972 estrellas, 2.416 bifurcaciones.- Bifurcaciones destacadas de este repo:
MaoTouHU/vibecodingcn(303 estrellas, la más visible); además decenas de bifurcaciones con 1 estrella (por ejemploMiranda-2000/vibe-coding-cn,zhanggan0607-blip/vibe-coding-cn,viasyllable/vibe-coding-cn, entre otras). - Herramientas internas del repo (mismo proyecto):
libs/external/prompts-library/— conversor de prompts entre Excel (.xlsx) y Markdown; ylibs/external/l10n-tool/(mencionado en el historial de commits) — mapas de traducción entre idiomas. - Localización: el repo mantiene 27 directorios de idioma bajo
i18n/(zh, en, ja, ko, es, fr, de, ru, ar, bn, fa, he, hi, id, it, ms, nl, pl, pt, sw, ta, th, tr, uk, ur, vi, ha).

- Repos y herramientas externas que el README enlaza:
x1xhlol/system-prompts-and-models-of-ai-tools(biblioteca de system prompts de otros productos) yyusufkaraaslan/Skill_Seekers(generador de skills); también productos como Superwhisper, BrowserTools, RepoPrompt, uithub y Zread. (Para estos dos repos enlazados no se midieron cifras de estrellas en esta investigación.) - Base de prompts en línea: una hoja de cálculo de Google con cientos de prompts listos para copiar (enlazada desde el README).
Estado oficial / semioficial
Ninguno. Este repositorio no ha entrado en ningún marketplace oficial, no cuenta con respaldo de ningún vendor y no es un estándar de facto: es una base de conocimiento comunitaria bajo licencia MIT, sin releases, sin blog, sin canal de registro de paquetes y con la descripción de GitHub vacía. La referencia «canónica» del método es, de hecho, la guía original en inglés de Nicolas Zullo (EnzeD/vibe-coding) y su adaptación china por tukuaiai/tradecatlabs; la copia de 2025Emma no tiene estatus oficial propio y su propia documentación sigue derivando a los issues y contribuidores de tukuaiai.

Guía rápida de uso
Instalación y primer arranque
- Es un repo «primero leer». No hay
pip installni binario que instalar: se clona o se lee online. La lectura en línea está disponible en https://zread.ai/tukuaiai/vibe-coding-cn/1-overview (lectura asistida por IA del repo); la fuente está eni18n/zh/. - Para aplicar el método hay que tener instalado uno de los dos agentes que el flujo recomienda: Claude Code (
npm i -g @anthropic-ai/claude-code) o Codex CLI (npm i -g @openai/codex) — ambos comandos provienen de la guía original en inglés que este repo replica. El flujo funciona igual en las extensiones de VSCode que en el terminal. - El único componente ejecutable es el conversor de prompts. En el repositorio:
Requisitos: Python 3;cd libs/external/prompts-library python3 main.py # modo interactivo: elige la fuente python3 main.py --select "prompt_excel/<archivo>.xlsx" # Excel → Markdown python3 main.py --select "prompt_docs/<directorio>" # Markdown → ExcelricheInquirerPyson opcionales (caen a una interfaz de texto si no están).

Flujos de trabajo habituales
- Iniciar un proyecto: pedir a la IA un
game-design-document.md(oPRD.mdpara apps) → pedirtech-stack.md→/initpara generarCLAUDE.md/AGENTS.md→ plan de implementación → crear la carpetamemory-bankcon los cinco archivos. Todo queda en Markdown versionado en Git. - Ejecutar un paso: «lee todo
memory-bank, haz el paso N; yo corro las pruebas; no empieces el paso N+1 hasta que las valide»; al validar, commit y/clear; el resultado se anota enprogress.mdy las novedades de arquitectura enarchitecture.md. - Gestionar la base de prompts: usar
python3 main.py --select …para convertir la colección entre Excel y Markdown (por ejemplo, para versionar en Git un corpus mantenido en una hoja de cálculo). - Depurar: si un prompt rompe el proyecto,
/rewinden Claude Code ogit reseten Codex; copiar el error del console (F12) y pegarlo; si se queda atascado,RepoPrompt/uithubpara compactar el repo y pedir ayuda.
Configuración esencial
memory-bank/— los cinco archivos que anclan el contexto de larga duración (diseño, pila, plan, progreso, arquitectura); es la pieza central del método.CLAUDE.md/AGENTS.md— las reglas que el agente debe leer; las críticas se marcan como «Always».i18n/zh/prompts/system_prompts/— prompts de sistema que limitan el comportamiento del agente.i18n/zh/prompts/coding_prompts/— prompts de la cadena de trabajo (requisitos, plan, ejecución).libs/external/prompts-library/scripts/config.yaml— configuración del conversor (carpetas origen/destino y mapeo de formatos).
Trampas frecuentes y soluciones
- Procedencia confusa: todos los commits están firmados por
tukuaiaiaunque el repo vive bajo2025Emma, y el README enlaza issues/insignias atukuaiai. → Antes de citar o depender del repo, verificar cuál es la fuente canónica (EnzeD/vibe-codingytradecatlabs/vibe-coding-cn). - Contenido desactualizado: el issue #4 señala que faltan herramientas recientes (Claude Code, Codex, Antigravity). → Contrastar la versión de modelo recomendada con lo actual antes de copiarla.
- Tutorial de juegos disfrazado de guía general: el flujo original está orientado a juegos (GDD); para aplicaciones hay que sustituir el GDD por un PRD (lo aclara la FAQ del propio README).
- Mezcla de voces: el README combina texto del autor original con adiciones del traductor (lo reconoce el propio repo). → No asumir que todo el contenido es del mismo autor.
- Spam en los issues: el issue #4 contiene un comentario promocionando un servicio de licencias de Cursor. → No tratar el registro de issues como fuente técnica fiable.
- Sin descripción ni releases: la descripción de GitHub está vacía y no hay tags; la única señal de estado es el historial de commits.
Integraciones y migración
- Agentes: el método integra con Claude Code y Codex CLI (CLI y extensiones de VSCode); el README cita además Cursor, Gemini CLI, Kiro, Antigravity, Copilot, Qwen, GLM y Kimi K2 como alternativas de modelos/servicios.
- MCP: el README documenta la configuración de Augment MCP (
auggie-mcp), el motor de contexto de Augment, en la carpeta de tutoriales. - Migración desde la versión original en inglés (
EnzeD/vibe-coding): al ser este repo su traducción/ampliación, «migrar» a él es simplemente leeri18n/zh/; para volver a la versión canónica, leeri18n/en/o clonarEnzeD/vibe-codingdirectamente. - Herramientas adyacentes: Zread (lectura de repos), NotebookLM (resumen de material), RepoPrompt/uithub (compactar el repo en un archivo para pedir ayuda a la IA).
Métricas actuales
Medición: 10 de septiembre de 2026, API de GitHub.
| Métrica | Valor |
|---|---|
| Estrellas | 22.972 |
| Bifurcaciones | 2.416 |
| Suscriptores (watchers reales) | 104 |
| Commits | 130 |
| Incidencias abiertas según la API | 8 |
| Lenguaje principal | Python (34.941), Shell (28.256), Makefile (842) |
| Licencia | MIT |
| Rama por defecto | main |
| Creación | 17 de diciembre de 2025 |
| Último push | 17 de diciembre de 2025 |
| Última actualización de metadatos | 10 de septiembre de 2026 |
| Último release | Ninguno (no hay tags/releases) |
Aclaraciones: el campo watchers_count de la API replica las estrellas, así que se informa por separado subscribers_count (104) como los watchers reales. El conteo de 130 commits se obtuvo del encabezado de paginación link (última página) de la API. La API expone open_issues_count (8), que puede incluir solicitudes de cambios abiertas y no es un conteo exclusivo de incidencias; la primera página de la lista de issues muestra 10 elementos entre issues y PR. El campo author de la API de commits firma los 130 commits de main como tukuaiai y ninguno como 2025Emma; el endpoint de contribuidores (sin anonimización) atribuye 34 contribuciones a tukuaiai.
Recepción de la comunidad
La recepción documentada es predominantemente crítica, y aparece de forma explícita en el propio registro de issues del repositorio:
- Issue #8 «哗众取宠,污染数据» (cerrado): little-KaoKao sostiene que «el proyecto plagia, es caótico, se aprovecha de los temas del momento en redes sociales nacionales para ganar tráfico, acumula estrellas inútiles y contamina el ecosistema open source». Otro usuario, potato-vita, le pide que exponga su opinión sin apoyarse en IA.
- Issue #5 «直接copy?» (¿copia directa?) (abierto): whx156580 pregunta «¿así que cuál es el original?»; zivonx escribe «esta copia tiene aún más estrellas 😂»; Felyx-Fu responde «¿¿¿???».
- Issue #2 «建议加一下原作者的链接» (sugerencia: añadir el enlace al autor original) (abierto): bgzo cuenta que «hoy me quedé totalmente confuso, creí que el autor forzó un revert, y resulta que son dos personas… y esta tiene hasta más estrellas, increíble 😂»; LynPtl añade «por eso este repo es tan doloroso de leer, pasé mucho sin entender el hilo y el README es un desastre»; dkpress concluye «por eso se ve tan raro, resulta que roba a los demás, asqueroso».
- Issue #4 «Hay más herramientas nuevas, como Claude Code, Codex, Antigravity, etc.» (abierto): reclamo de que el contenido está desactualizado; el hilo contiene además un comentario de spam que promociona un servicio de licencias de Cursor.
- Issue #7 (abierto): «añade una descripción para mejorar la discoverability» — señal de que el repo carece de descripción.
Como contexto amplio (y no atribuible a este repo): el concepto «vibe coding» generó hilos grandes en Hacker News (por ejemplo, Simon Willison, «Vibe coding and agentic engineering are getting closer than I’d like», 787 puntos / 885 comentarios, item 48037128; y «The cult of vibe coding is dogfooding run amok», 616 puntos / 512 comentarios, item 47664912). Ninguno de esos hilos hace referencia a este repositorio, así que no se infiere de ellos la recepción de 2025Emma/vibe-coding-cn.
No se detectó lanzamiento en Product Hunt, ningún endorsement de vendor y ningún hilo de Reddit verificable (la API de Reddit devolvió bloqueo 403 durante esta investigación, por lo que no se afirma su ausencia total, solo que no se pudo confirmar ningún hilo concreto).
Comparación con proyectos similares
| Proyecto | Coincidencia verificable | Diferencia verificable |
|---|---|---|
EnzeD/vibe-coding (original, Nicolas Zullo) | Misma metodología de planificación (GDD/PRD → pila → plan → memory-bank → pasos con prueba). | Es la fuente original en inglés (4.782 estrellas); la versión china copia y amplía este contenido. |
tradecatlabs/vibe-coding-cn (antes tukuaiai/vibe-coding-cn) | Es la versión china que este repo replica; mismos créditos (tukuaiai, Nicolas Zullo, 123olp). | 16.149 estrellas; es la «otra» versión que los issues de este repo señalan como canónica. |
x1xhlol/system-prompts-and-models-of-ai-tools | Referenciado por el README como biblioteca de system prompts. | Recopila prompts de otros productos de IA; no es una metodología de flujo de trabajo. |
yusufkaraaslan/Skill_Seekers | Referenciado por el README como generador de skills. | Herramienta para generar skills; este repo almacena skills ya escritas. |
obra/superpowers (adyacente, no competidor directo) | Ambos imponen un proceso disciplinado sobre un agente de código. | Superpowers es un plugin instalable con skills ejecutables y ganchos; este repo es una base de conocimiento de prompts y texto. |
La comparación más útil es por legitimidad de origen: para el método canónico, EnzeD/vibe-coding y tradecatlabs/vibe-coding-cn están mejor documentados; el valor de 2025Emma/vibe-coding-cn reside en ser un espejo con más idiomas y un corpus de prompts, no en ser la fuente.
Cómo contribuir
El CONTRIBUTING.md documenta un flujo sencillo (y, de nuevo, enlaza al rastreador de issues de tukuaiai, no al de 2025Emma):
- Informar de errores o sugerencias a través de Issues, describiendo el problema con detalle.
- Propuesta de cambios (PR): (1) bifurcar el repo; (2)
git checkout -b feature/YourAmazingFeature; (3) hacer los cambios; (4)git commit -m 'feat: Add some AmazingFeature'; (5)git push origin feature/YourAmazingFeature; (6) abrir una Pull Request. - Hay un
CODE_OF_CONDUCT.mdque se pide leer antes de contribuir.
No se observó plantilla de PR ni un arnés de pruebas/evaluación para el contenido (es un repositorio de documentación); el único código real (prompts-library) lleva Makefile y requirements.txt. Dado que la documentación de contribución deriva a tukuaiai, un contribuyente debería aclarar a qué repositorio dirige su PR.
Casos de uso y a quién puede ayudar este repositorio
- Desarrolladores hispanohablantes o de lengua china que buscan un flujo de programación por pareja con IA orientado a la planificación, con una gran biblioteca de prompts curada (
system/coding/assistant/user) y el patrónmemory-bankpara mantener el contexto estable a lo largo de sesiones largas. - Quien prefiere copiar prompts probados antes que redactarlos: el corpus de
i18n/zh/prompts/y la hoja de cálculo en línea de Google ofrecen cientos de prompts listos para pegar en Claude Code o Codex CLI. - Equipos que quieren una referencia local, bifurcable y bajo licencia MIT para flujos de Claude Code / Codex CLI (el README documenta ambos y alternativas como Cursor y Gemini CLI), y que puedan clonarlo y adaptarlo sin depender de una cuenta.
- Estudiantes e investigadores de la metodología «vibe coding» que buscan un ejemplo concreto y documentado del marco 道法术器 y de la meta-metodología α/Ω, con un diagrama de arquitectura y una tabla de métricas de observabilidad (tasa de acierto de prompts, tiempo de rotación, capacidad de revisión).
- Mantenedores de un corpus de prompts en Excel que necesitan pasarlo a Markdown para versionarlo en Git (o viceversa): la herramienta
prompts-library(main.py) cubre exactamente esa conversión, de forma interactiva o con la bandera--selectpara automatizarla. - Advertencia para elegir bien la fuente: para la versión canónica del método, la guía original de Zullo (
EnzeD/vibe-coding) y la versión china detukuaiai/tradecatlabsestán mejor documentadas; el valor específico de este repo es como espejo con más idiomas y un corpus de prompts, no como origen.
Recursos
- Repositorio: https://github.com/2025Emma/vibe-coding-cn
- Documentación: el README principal (https://github.com/2025Emma/vibe-coding-cn) y la carpeta
i18n/zh/documents/ - Versión original (inglés): https://github.com/EnzeD/vibe-coding
- Versión china original: https://github.com/tradecatlabs/vibe-coding-cn (antes
tukuaiai/vibe-coding-cn) - Skills oficiales (del repo): https://github.com/2025Emma/vibe-coding-cn/tree/main/i18n/zh/skills (incluida la meta-skill
claude-skills) - Base de prompts en línea (Google Sheets): https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/
- Lectura del repo asistida por IA (Zread): https://zread.ai/tukuaiai/vibe-coding-cn/1-overview
- Comunidad / Telegram: https://t.me/glue_coding (grupo) y https://t.me/tradecat_ai_channel (canal)
- Autor original: https://x.com/NicolasZu
- Reviews / issues de la comunidad (incl. #2, #4, #5, #8): https://github.com/2025Emma/vibe-coding-cn/issues
- Contexto del concepto «vibe coding» en HN (no referencian a este repo): https://news.ycombinator.com/item?id=48037128 , https://news.ycombinator.com/item?id=47664912
- Registros de paquetes: N/A (no publica en npm/PyPI/crates.io; solo un script local
prompts-library) - Blog o changelog oficial: N/A (sin releases ni blog detectado)
Nota: este artículo combina el README y el CONTRIBUTING.md del repositorio, la API de GitHub (repo, commits, contribuidores, issues y bifurcaciones), la API de Hacker News/Algolia y las respuestas a los issues, consultadas el 10 de septiembre de 2026. Las cifras cambian con el tiempo; la procedencia del contenido (original → versión china → esta copia) se verifica a partir de los repos y commits recuperados en esta investigación.
Comentarios