msaldain
47fc69508d
- 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
70 lines
3.7 KiB
Markdown
70 lines
3.7 KiB
Markdown
# CLAUDE.md
|
|
|
|
Este archivo proporciona orientación a Claude Code (claude.ai/code) para trabajar con el código de este repositorio.
|
|
|
|
## Guías para Claude Code
|
|
|
|
Este archivo es el **documento orquestador**: define las etapas e hitos del proyecto y deriva el detalle de trabajo a `.claude/`. Antes de codificar, consultar la carpeta correspondiente.
|
|
|
|
**`.claude/codigo/`** — coordinación de los aspectos del código:
|
|
- [`.claude/codigo/compilacion.md`](.claude/codigo/compilacion.md) — comandos para compilar, ejecutar y empaquetar
|
|
- [`.claude/codigo/arquitectura.md`](.claude/codigo/arquitectura.md) — flujo de llamadas, patrones de diseño, estado actual del código
|
|
- [`.claude/codigo/reglas.md`](.claude/codigo/reglas.md) — restricciones obligatorias de codificación y reglas de negocio
|
|
- [`.claude/codigo/designPatterns.md`](.claude/codigo/designPatterns.md) — patrones de diseño a aplicar; consultar antes de implementar cualquier patrón
|
|
|
|
**`.claude/decisiones/`** — decisiones del usuario que el agente **debe respetar** (no renegociar):
|
|
- [`.claude/decisiones/DECISIONS.md`](.claude/decisiones/DECISIONS.md) — decisiones sobre el proyecto y la organización del contexto (`.claude/`, hitos)
|
|
- [`.claude/decisiones/codigo.md`](.claude/decisiones/codigo.md) — decisiones sobre el desarrollo de código (mandato de buenas prácticas / Clean Code)
|
|
- [`.claude/decisiones/commits.md`](.claude/decisiones/commits.md) — decisiones sobre los commits (legibles, sin firma de IA, reflejan las tareas completadas de la etapa)
|
|
- [`.claude/decisiones/documentacion.md`](.claude/decisiones/documentacion.md) — decisiones sobre la documentación (Markdown por defecto, sin emojis, sin firma de IA, índices)
|
|
- [`.claude/decisiones/notas.md`](.claude/decisiones/notas.md) — decisiones sobre los comentarios en el código (mínimos, sin emojis, preferir ajustar documentación existente)
|
|
- [`.claude/decisiones/minutas.md`](.claude/decisiones/minutas.md) — decisiones sobre las minutas (nombre `Minuta_00N_DD-MM-YYYY`, recuadro Fecha/Duración/Etapa, títulos fijos, sin mencionar `.claude`/`CLAUDE.md`/repo ni la IA)
|
|
- [`.claude/decisiones/sobreCLAUDE.md`](.claude/decisiones/sobreCLAUDE.md) — guia para construir y mantener CLAUDE.md correctamente
|
|
- [`.claude/decisiones/sobreREADME.md`](.claude/decisiones/sobreREADME.md) — guia para construir y mantener README.md correctamente
|
|
|
|
**`.claude/referencias/`** — material de apoyo para guiar al modelo al evaluar prácticas de programación:
|
|
- [`.claude/referencias/clean_code_RobertCMartin.md`](.claude/referencias/clean_code_RobertCMartin.md) — *Clean Code* (R. C. Martin), referencia máxima de buenas prácticas; aplicarlo al desarrollar código
|
|
- [`.claude/referencias/ejemplo_commit.md`](.claude/referencias/ejemplo_commit.md) — ejemplo/plantilla de commit del usuario; referencia para redactar los mensajes de commit
|
|
|
|
|
|
---
|
|
|
|
# Datos generales del proyecto
|
|
|
|
**Nombre:**
|
|
**Repositorio oficial:**
|
|
**Institución:**
|
|
|
|
## Equipo
|
|
|
|
**Integrantes:**
|
|
- Mateo Saldain
|
|
|
|
## Descripción general
|
|
|
|
|
|
## Stack tecnológico
|
|
|
|
- **Lenguajes:**
|
|
- **Base de datos:**
|
|
- **Build:**
|
|
- **Testing:**
|
|
- **Herramientas:**
|
|
|
|
|
|
## Restricciones técnicas obligatorias de programación
|
|
|
|
|
|
## Etapas del proyecto
|
|
|
|
|
|
## Complejidad esperada
|
|
|
|
|
|
## Reglas del proyecto
|
|
Las reglas aquí marcadas deben tenerse siempre en cuenta a meenos que el usuario lo solicite explicitamente. Estas órdenes complementan la configuración en [settings.json](.claude/settings.json)
|
|
|
|
- Nunca ejecutar comandos de Git.
|
|
- No crear commits, ramas, tags o pull requests.
|
|
- No ejecutar `git add`, `git commit`, `git push`, `git pull`, `git merge`, `git rebase`, `git reset`, `git checkout` ni `git switch`.
|
|
- Si una tarea requiere operaciones de Git, solicitar al desarrollador que las ejecute manualmente. |