Back to table of contents

07. Empezando un nuevo proyecto

#Cuándo usar este flujo

Usa esto cuando aún no hay un repositorio Git, o cuando el repositorio existe pero es básicamente un lienzo en blanco con poco código. Si estás intentando entender un repositorio desconocido que ya tiene código, ve a 08. Entering an existing Repo for the first time en su lugar. Estos flujos se mueven en direcciones opuestas y no deberían usarse juntos en la misma sesión.

Antes de empezar: si prefieres no pasar --lang en cada llamada, fija el idioma de salida una vez con ywc-setup-language. A partir de entonces los skills de abajo siguen esa configuración.

#Flujo general

Este flujo es un embudo: divergir → decidir → converger → puerta de arranque. Extiende la idea a lo ancho (uno), fija el porqué y el qué (dos–tres), estréchala en estructura y especificación (cuatro–nueve), pasa la puerta que dice que estás listo para construir (diez) y luego entra en la implementación. Los pasos marcados como (opcional) pueden omitirse cuando ya están resueltos.

#Ejemplo de ejecución

1. Dar forma a la idea (opcional)

/ywc-brainstorm Quiero que una pequeña empresa de construcción registre la entrada/salida sin una aplicación aparte, pero no sé por dónde empezar

$ywc-brainstorm Quiero que una pequeña empresa de construcción registre la entrada/salida sin una aplicación aparte, pero no sé por dónde empezar

Estrecha el propósito, las restricciones y las alternativas mediante un diálogo socrático de una pregunta a la vez. Si ya sabes claramente qué construir, omítelo y empieza desde el paso 2.

2. Registra el porqué del proyecto

/ywc-mission El objetivo de este project es permitir que una pequeña empresa de construcción registre la entrada/salida de los trabajadores sin una aplicación aparte. Criterio de éxito: si un solo administrador puede cerrar la asistencia de 10 trabajadores o menos en 5 minutos

$ywc-mission El objetivo de este project es permitir que una pequeña empresa de construcción registre la entrada/salida de los trabajadores sin una aplicación aparte. Criterio de éxito: si un solo administrador puede cerrar la asistencia de 10 trabajadores o menos en 5 minutos

Fija el porqué y los criterios de éxito antes que la estructura del directorio o la especificación: cada paso posterior se juzga contra esta mission.

3. Decide la pila tecnológica (opcional)

/ywc-tech-research --compare 'PostgreSQL,SQLite' --depth 50

$ywc-tech-research --compare 'PostgreSQL,SQLite' --depth 50

El paso 4 (scaffold) dibuja la estructura después de decidir la pila, así que si la pila aún no está resuelta, compara aquí los candidatos y deja la justificación antes de continuar. Omítelo si ya está decidida.

4. Diseñar la estructura del directorio

/ywc-project-scaffold FastAPI + GraphQL + Clean Architecture, medium scale

$ywc-project-scaffold FastAPI + GraphQL + Clean Architecture, medium scale

Se requiere el idioma. Si faltan otros detalles, el Skill hace preguntas de seguimiento, por lo que especifique Framework / Arquitectura / Escala juntos cuando sea posible. Esta habilidad produce solo un plan Markdown. La creación real del archivo la maneja ywc-code-gen.

5. Glosario de dominio (recomendado para proyectos ricos en dominio)

/ywc-ubiquitous-language --ddd --output docs/ubiquitous-language.md

$ywc-ubiquitous-language --ddd --output docs/ubiquitous-language.md

Definir los términos canónicos por adelantado hace que la especificación siguiente y ywc-code-gen usen los mismos nombres, evitando que los sinónimos se cuelen en el código. Omítelo en proyectos con vocabulario simple.

6. Escribe la especificación completa

/ywc-spec-writer --full --lang ko

$ywc-spec-writer --full --lang ko

7. Validar la especificación

/ywc-spec-validate --spec docs/specification/01-overview.md

$ywc-spec-validate --spec docs/specification/01-overview.md

Si devuelve DONE_WITH_CONCERNS, vuelva al paso 6 ywc-spec-writer, refine la especificación y valide de nuevo. Repita hasta que devuelva DONE. (ywc-spec-ready es un bucle de convergencia automática solo para especificaciones creadas por ywc-plan, así que no lo use aquí.)

8. Documentos adicionales (cuando sea necesario)

/ywc-project-docs --lang kr

$ywc-project-docs --lang kr

9. Descomponer en Tasks

/ywc-task-generator --lang ko

$ywc-task-generator --lang ko

10. Puerta de arranque

/ywc-confidence-gate revisa si es seguro empezar a implementar con esta spec y estas tasks

$ywc-confidence-gate revisa si es seguro empezar a implementar con esta spec y estas tasks

Puntúa cinco dimensiones: scope clarity / architecture compliance / evidence quality / reuse verified / root cause. Con PROCEED (≥90) entra en 05. general cycle; con STOP (<70), refuerza primero la dimensión señalada.

#Notas

• ▪ywc-brainstorm, ywc-tech-research y ywc-ubiquitous-language son pasos auxiliares que puedes omitir según la situación. Si la intención, la pila y el vocabulario de dominio ya están claros, seguir solo la columna vertebral dos → cuatro → seis → siete → nueve → diez es suficiente.
• ▪Si ywc-confidence-gate devuelve STOP (<70), no entres en la implementación: completa primero la dimensión señalada y luego vuelve a pasar la puerta.
• ▪Si el alcance es lo suficientemente pequeño como para implementarse directamente sin descomposición de especificaciones, ywc-plan puede dirigir al camino Pequeño y saltarse todo este flujo.
• ▪ywc-onboard-repo se mueve en dirección opuesta a este flujo (investigando un repositorio existente), así que no lo uses al crear un proyecto nuevo.

Previous: 06. Finish automatically from one goal - Next: 08. Entering an existing Repo for the first time