Configura la plantilla de contexto para Claude Code
- Agrega CLAUDE.md como documento orquestador - Estructura .claude/ en codigo/, decisiones/ y referencias/ - Documenta decisiones de codigo, commits, documentacion, notas y minutas - Incorpora las skills recontextualizar e inicializarProyecto - Corrige rutas rotas y agrega designPatterns, sobreCLAUDE y sobreREADME al orquestador
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
---
|
||||
name: inicializarProyecto
|
||||
description: Inicializa el proyecto cargando por lenguaje natural los datos indispensables (nombre, institución, stack, etapas, complejidad, entre otros) y los vuelca en las secciones de CLAUDE.md. Úsala cuando el proyecto sea una plantilla recién clonada, o cuando los campos de "Datos generales del proyecto" en CLAUDE.md estén vacíos o incompletos y el usuario quiera completarlos.
|
||||
---
|
||||
|
||||
# Inicializar el proyecto
|
||||
|
||||
Esta skill completa los datos iniciales indispensables del proyecto conversando con el usuario en lenguaje natural y volcando el resultado en la sección `# Datos generales del proyecto` de `CLAUDE.md`. A diferencia de [recontextualizar](../recontextualizar/SKILL.md), sí edita archivos, pero solo para rellenar esos datos; no toca decisiones, referencias ni código.
|
||||
|
||||
`CLAUDE.md` es el documento orquestador. La estructura y el significado de cada sección están definidos en [sobreCLAUDE.md](../../decisiones/sobreCLAUDE.md), documento vinculante que se debe respetar al escribir. También aplican las decisiones de [documentacion.md](../../decisiones/documentacion.md) (Markdown, sin emojis, sin firma de IA) y de [codigo.md](../../decisiones/codigo.md) (camelCase en nombres) para cualquier identificador o ejemplo que se genere.
|
||||
|
||||
## Antes de empezar
|
||||
|
||||
1. Lee el estado actual. Lee `CLAUDE.md` completo y [sobreCLAUDE.md](../../decisiones/sobreCLAUDE.md). Identifica qué campos ya están completos y cuáles vacíos. No sobrescribas datos ya cargados sin confirmación del usuario.
|
||||
2. No inventes datos. Todo campo indispensable proviene del usuario. Si un dato aún no lo sabe, déjalo vacío y anótalo como pendiente; no lo rellenes con suposiciones.
|
||||
|
||||
## Datos a recoger
|
||||
|
||||
Recorre estas secciones de `CLAUDE.md`, definidas en `sobreCLAUDE.md`. Pregunta de a grupos temáticos, en lenguaje natural, evitando un interrogatorio campo por campo:
|
||||
|
||||
1. Identidad del proyecto: nombre, repositorio oficial, institución (organización o particular).
|
||||
2. Equipo: integrantes con nombre y apellido. Mateo Saldain ya figura; consulta si hay más.
|
||||
3. Descripción general: uno o dos párrafos sobre qué es y qué resuelve el proyecto.
|
||||
4. Stack tecnológico: lenguajes con versiones si las hay, base de datos, build, testing, herramientas.
|
||||
5. Restricciones técnicas obligatorias de programación: tecnologías obligadas o prohibidas, límites del entorno, requisitos de docentes o cliente.
|
||||
6. Etapas del proyecto: etapas o hitos con sus plazos y objetivos en la medida en que el usuario los conozca. Es esperable que al inicio estén parcialmente definidas; captura lo disponible.
|
||||
7. Complejidad esperada: línea de complejidad de referencia (proyecto de tiempo libre frente a estándar de empresa o curso).
|
||||
|
||||
Para campos con opciones acotadas, como la complejidad esperada o la elección entre stacks candidatos, usa `AskUserQuestion`. Para descripciones y listados abiertos, conversa en texto libre.
|
||||
|
||||
## Pasos
|
||||
|
||||
1. Muestra el estado inicial. Resume brevemente qué campos están vacíos y cuáles ya tienen datos.
|
||||
2. Recoge los datos por grupos temáticos según la lista anterior. Confirma dudas antes de escribir y deja constancia de lo que quede pendiente.
|
||||
3. Vuelca los datos en `CLAUDE.md`, en sus secciones correspondientes, respetando la estructura de `sobreCLAUDE.md` y el estilo de `documentacion.md`. No alteres las secciones `## Guías para Claude Code` ni `## Reglas del proyecto`.
|
||||
4. No ejecutes Git. Rige la regla del proyecto de nunca ejecutar comandos de Git. Si el usuario quiere versionar la inicialización, pídele que lo haga manualmente.
|
||||
|
||||
## Salida esperada
|
||||
|
||||
- Confirmación de qué secciones de `CLAUDE.md` quedaron completadas.
|
||||
- Lista de datos pendientes que el usuario aún no proporcionó, para retomarlos luego.
|
||||
- Sugerencia de correr [recontextualizar](../recontextualizar/SKILL.md) si quiere reflejar el nuevo contexto en la sesión.
|
||||
|
||||
No completes campos con datos inventados ni edites archivos fuera de `CLAUDE.md` salvo que el usuario lo pida.
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
name: recontextualizar
|
||||
description: Relee CLAUDE.md y toda la carpeta .claude/ para refrescar el contexto del proyecto SIENEP. Úsala cuando el usuario indique que es momento de actualizar el contexto, tras agregar o modificar decisiones, pautas de código, referencias, o nuevas secciones en CLAUDE.md o .claude/.
|
||||
---
|
||||
|
||||
# Recontextualizar el proyecto
|
||||
|
||||
Esta skill recarga el contexto de trabajo releyendo el documento orquestador `CLAUDE.md` y toda la carpeta `.claude/`. Es de **solo lectura**: no edites archivos salvo que el usuario lo pida explícitamente.
|
||||
|
||||
`CLAUDE.md` es el documento orquestador; `.claude/` contiene el detalle. Los roles de cada carpeta están definidos en `.claude/decisiones/DECISIONS.md`:
|
||||
- `.claude/codigo/` — coordinación de aspectos del código (build, arquitectura, reglas).
|
||||
- `.claude/decisiones/` — decisiones del usuario que **debes respetar** (no renegociar); divididas en `DECISIONS.md` (proyecto y organización del contexto) y `codigo.md` (desarrollo de código).
|
||||
- `.claude/referencias/` — material de apoyo para evaluar prácticas de programación (ej. Clean Code).
|
||||
|
||||
## Pasos
|
||||
|
||||
1. **Descubre todos los archivos de contexto.** Lista de forma recursiva `.claude/` (`find .claude -type f` o glob equivalente) y registra `CLAUDE.md`. No asumas que solo existen las carpetas/archivos ya conocidos: detecta archivos, carpetas o secciones nuevas.
|
||||
|
||||
2. **Lee CLAUDE.md completo.** Identifica secciones nuevas o modificadas (hitos, módulos, restricciones, contexto del curso).
|
||||
|
||||
3. **Lee cada archivo de `.claude/`.** Cubre como mínimo `codigo/`, `decisiones/` y `referencias/`, más cualquier archivo o carpeta nuevo encontrado en el paso 1.
|
||||
|
||||
4. **Trata `.claude/decisiones/` como vinculante.** Cualquier decisión nueva o cambiada ahí tiene prioridad y condiciona cómo trabajas de ahora en más.
|
||||
|
||||
5. **Incorpora las referencias.** Si hay referencias nuevas o actualizadas en `.claude/referencias/` (ej. guías de estilo, Clean Code), tenlas presentes al desarrollar o revisar código.
|
||||
|
||||
## Salida esperada
|
||||
|
||||
Entrega un resumen conciso (no repitas los archivos verbatim) que cubra:
|
||||
|
||||
- **Mapa de orquestación al día:** qué hay hoy en `CLAUDE.md` y en cada subcarpeta de `.claude/`.
|
||||
- **Novedades destacables:** decisiones nuevas, pautas de código nuevas, referencias cargadas, o secciones nuevas en `CLAUDE.md` — solo lo que cambia cómo debes trabajar.
|
||||
- **Inconsistencias o contradicciones** entre archivos que convenga que el usuario resuelva.
|
||||
- **Hitos del proyecto** y qué implica para el trabajo inmediato, si está claro en CLAUDE.md.
|
||||
|
||||
Cierra confirmando que el contexto quedó recargado. No edites archivos ni propongas cambios salvo que el usuario lo pida.
|
||||
Reference in New Issue
Block a user