$ywc
8 stars
Guidebook / Guías por situación

08. Entrando en un repositorio existente por primera vez

Guide2 min de lectura

Usa esto cuando entres por primera vez a un repositorio desconocido que ya tiene código y necesites entender "cómo es esta base de código." Por el contrario, si estás diseñando un proyecto nuevo desde cero, ve a 07.

Back to table of contents

08. Entrando en un repositorio existente por primera vez

Cuándo usar este flujo

Usa esto cuando entres por primera vez a un repositorio desconocido que ya tiene código y necesites entender "cómo es esta base de código." Por el contrario, si estás diseñando un proyecto nuevo desde cero, ve a 07. Starting a new Project. Estos dos flujos se mueven en direcciones opuestas y no deben usarse juntos en la misma sesión.

Lo que hace

ywc-onboard-repo utiliza el reconocimiento Glob/Grep para extraer la pila tecnológica / arquitectura / convenciones y producir dos cosas.

  1. Guía de incorporación - Un documento impreso directamente en la conversación (Stack tecnológico, Arquitectura, Puntos clave de entrada, Mapa de directorios, Ciclo de vida de las solicitudes, Convenciones y más)
  2. Starter CLAUDE.md: un archivo escrito en la raíz del repositorio. Si CLAUDE.md ya existe, no se sobrescribe; se amplía con una sección ## Detected Conventions.

Ejemplo de ejecución

Ejecución predeterminada - inspecciona todo el repositorio y genera tanto la Guía de incorporación como el Starter CLAUDE.md

claude code
ywc-onboard-repo

Inspeccionar solo un espacio de trabajo específico en un monorepo

claude code
ywc-onboard-repo --scope apps/web/

Cuando solo necesites el documento explicativo, no Starter CLAUDE.md

claude code
ywc-onboard-repo --guide-only

Cuando solo necesitas CLAUDE.md, no la Guía de Introducción

claude code
ywc-onboard-repo --claude-md-only

Qué hacer a continuación

  • Si la investigación encuentra código muerto acumulado, el informe de resultados incluye orientación. Divida la limpieza posterior en un PR separado con ywc-refactor-clean; no lo mezcle en el PR de incorporación.
  • Una vez que hayas leído la Guía de Integración, pasa al flujo de desarrollo normal para cambiar el código existente. Comienza con 02. Core concepts para confirmar los criterios de escala Pequeña/Mediana/Grande.

Previous: 07. Starting a new Project - Next: 09. Writing and running Tests