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
2026-07-04 21:38:47 -03:00
parent 31e98c56da
commit 47fc69508d
20 changed files with 465 additions and 1 deletions
@@ -0,0 +1,12 @@
+# Decisiones globales de comportamiento para Claude Code
+**Los lineamientos a seguir por los modelos de Claude se alojan en este archivo.**
+
+1. CLAUDE.md sirve como documento guia que orquestra .claude entre otras cosas como las etapas que se deben seguir
+
+2. .claude/ es donde vive toda la documentación necesaria para que los modelos puedan trabajar y guardar las referncias de código y demás documentación que entiendan necearia
+
+2.1. .claude/codigo/ Aquí vive lo que sea necesario para que los modelos coordinen correctamente los aspectos del código.
+
+2.2. .claude/decisiones/ Es donde el usuario pauta las decisiones tomadas que deben ser respetadas por el agente de IA. Este archivo explica las decisiones globales del proyecto; las decisiones específicas de código están en [codigo.md](codigo.md).
+
+2.3. .claude/referencias/ Contiene archivos que pueden ser resumenes o textos que sirven para que el modelo se guíe en determinados momentos, al evaluar las prácticas de programación por ejemplo.
@@ -0,0 +1,25 @@
+# Decisiones en cuanto a código para Claude Code
+
+> Las decisiones generales del proyecto están en [DECISIONS.md](DECISIONS.md).
+
+## Buenas prácticas de programación
+- El modelo de Claude deberá siempre que desarrolle código apegarse a las buenas prácticas de pogramación establecidas por la comunidad.
+    - 'Clean code' por Robert C. Martin es la referencia principal en cuanto a buenas prácticas en el desarrollo de proyectos como este. Un archivo con un resumen de los aspectos principales del libro está en .claude/references/clean_code_RobertCMartin.md
+    Referencia "principal" en este sentido quiere decir que a medida que se vayan cargando nuevas referencias es posible que se encuentren contradicciones, en ese caso las prácticas de 'Clean code' por Robert C. Martin tienen prioridad.
+
+## Estilo del usuario
+- Los nombres de las variables, métodos y clases se deben escribir en formato **camelCase** .
+- Los nombres de las variables, métodos y clases deben reflejar el nombre claro de lo que se quiere representar:
+    - `const configuracionDb = {...}`
+    - `async function verificarConexion() {...}`
+    - `async function resolverUuidUsuario() {...}`
+- Hay casos donde se aplican excepciones como si una buenas práctica o una práctica habitual es escribir de una manera especifica algo que es practicamente un estandar como las clases en Java, en ese caso no usamos camelCase, usamos las buenas prácticas de programación.
+    - `public class Algoritmo {...}`
+    - `public class Conexion {...}`
+- En caso de trabajar con digramas que documenten lo desarrollado en una base de datos usaremos los nombres reservados por los lenguajes de programación para los tipos de datos.
+    - Ej: `STRING` en lugar de "CADENA"
+    - Ej: `INTEGER` en lugar de "ENTERO"
+
+## Scripts de uso puntual de Claude Code
+- Los scripts que crea Claude Code para una tarea puntual (generar artefactos, transformar datos, etc.) y que **no forman parte del proyecto** se crean dentro de `.claude/codigo/scripts/`.
+- Motivo: separar las herramientas internas del agente del código.
@@ -0,0 +1,6 @@
+# Decisiones en cuanto a los commits creados por Claude Code
+
+- Los commits deben ser sencillos de leer por humanos.
+- No deben firmarse por la IA (a menos que se indique lo contrario).
+- Deben reflejar la etapa en la que se está trabajando.
+    - Ej / Referencia: [ejemplo_commit.md](../referencias/ejemplo_commit.md).
@@ -0,0 +1,21 @@
+# Decisiones en cuanto a la documentación creada por Claude Code
+
+## README.md
+- El archivo README.md no se utilizará como archivo que incorpore un índice sobre la documentación del proyecto.
+- Este archivo README.md contendrá un resumen de la organización de las etapas del proyecto, plazos por etapa, planes de acción por etapa, requisitos indispensables establecidos por los docentes.
+- Más información sobre como construir el archivo [README.md](README.md) en [.claude/decisiones/sobreREADME.md](.claude/decisiones/sobreREADME.md)
+
+## Estilos
+- Si el usuario no indica lo contrario usar Markdown como tipo de documento predeterminado para crear documentación.
+- No se usarán emojis en la documentación
+- No se firmará como en colaboración con IA
+
+## Índices
+- Todos los grandes directorios de documentación deberán contar con un índice.
+- En [Indice.md](docs/Indice.md) se encontrará el índice que mantiene actualizada la documentación de cada etapa.
+
+## Estructura
+- Es posible que a medida que se avance con las etapas la documentación crezca y se haga insostenible tener todo dentro de un único archivo con la documentación.
+- Dentro de la carpeta [docs/](docs) va a alojarse la documentación.
+- Dentro de [docs/](docs) encontraremos sub-carpetas correspondientes a cada hito, [Hito 1](docs/H1/) es una de ella.
+- Dentro de cada sub-carpeta de etapa habrán archivos que corresponderán a secciones, estas secciones pueden definirse anteriormente al iniciar una nueva etapa dentro de [secciones.md](docs/H1/secciones.md) o puede actualizarse a medida que se vayan creando las secciones si no se precargó.
@@ -0,0 +1,21 @@
+# Decisiones en cuanto a las minutas de sesión de trabajo creadas por Claude Code
+
+## Evitar la mención de ajustes de configuracione de Claude o del repositorio
+- No es relevante para registrar en la minuta las acciones realizadas dentro de .claude o CLAUDE.md o de caracter IA.
+- Evitar cualquier punto que mencione la IA, en caso de haber trabajado en conjunto únicamente mencionar sobre lo que se trabajó.
+
+## Nombre del archivo sobre el cual guardar la minuta de trabajo
+- Minuta_00N_DD-MM-YYYY
+- Donde N en el número de la minuta - 001, 005
+
+## Pequeño recuadro con información sobre la minuta
+- Campo y Detalle
+- **Fecha** Fecha de la minuta en formato DD-MM-YYYY
+- **Duración estimada** Duración estimada de la sesión de trabajo. Suele rondar las 2 horas.
+- **Etapa** Etapa sobre la que se trabajó en la sesión de trabajo, pese a estar atrasado o adelantado del cronograma
+
+## Títulos que deberán aparecer en la minuta con doble almohadilla.
+- Temas tratados
+- Decisiones tomadas
+- Tareas pendientes de la etapa actual
+- Proxima sesión prevista
@@ -0,0 +1,8 @@
+# Decisiones en cuanto a los comentarios creados por Claude Code
+
+- No se debe usar emojis.
+- Debe ser claro y usar la menor cantidad de comentarios posibles. 
+- Si existe un archivo o sección de un archivo que documente el funcionamiento del código que se creó ajustar esa documentación en lugar de agregar un comentario sobre el código.
+
+> Las decisiones sobre la forma de escribir en la documentación está en [documentacion.md](documentacion.md).
+> Las decisiones sobre la forma de escribir los commits está en [commits.md](commits.md).
@@ -0,0 +1,17 @@
+# Acerca de la construicción adecuada de [CLAUDE.md](CLAUDE.md)
+
+- En este archivo se encontraran las decisiones tomadas sobre como se organizará el archivo [CLAUDE.md](CLAUDE.md).
+- Es posible y recomendable modificar este archivo para que refleje el conteneido de [CLAUDE.md](CLAUDE.md) a medida que el proyecto avance. Esto es solo una plantilla para ayudarle a empezar.
+
+## Guías para Claude al ajustar [CLAUDE.md](CLAUDE.md)
+- Estamos hablando de una archivo que routea y orquestra al agente hacia [.claude/](.claude) donde encontrará deciciones, ajustes respecto al código, referencias para tomar como ejemplo.
+
+## Estructura
+    - Una sección '# Datos generales del proyecto' que incluirá aspectos globales a todo proyecto. 1. **Nombre:** 2. **Repositorio oficial:** 3. **Institución:** puede ser una organización o un particular
+    - Equipo trabajando sobre el desarrollo '## Equipo' que incluirá nombres de los integrantes con **Integrantes: ** Nombre y Apellido
+    - Otra sección '## Descripción general' incluirá entre 1 o 2 párafos describiendo el proyecto.
+    - Sección '## Stack tecnológico' donde se incluirán detalles como tecnologías utilizadas, versiones especificas de lenguajes o frameworks, así como herramientas utilizadas.
+    - Sección de '## Restricciones técnicas obligatorias de programación' donde se especifican desde el vamos del proyecto restricciones para el desarrollo.
+    - Sección '## Etapas del proyecto' puede ser dificil al comienzo pero si el poroyecto avanza será neceario organizar y planear tiempos.
+    - Sección '## Complejidad esperada' es una nota del usuario hacia el agente de IA para basarse sobre una linea de compleijidad, no es lo mismo un proyecto que se desarrolla en los tiempos libres a un proyecto de empresa que necesita cumplir ciertos strandares.
+    - Sección '## Notas de trabajo' incluirá un redireccionamiento 
@@ -0,0 +1,7 @@
+# Acerca de la construicción adecuada de [README.md](README.md)
+
+En este archivo se encontraran las decisiones tomadas sobre como se organizará el archivo [README.md](README.md).
+- Es posible y recomendable modificar este archivo para que refleje el conteneido de [README.md](README.md) a medida que el proyecto avance. Esto es solo una plantilla para ayudarle a empezar.
+
+## Guías para Claude al ajustar [README.md](README.md)
+- Estamos hablando de una archivo que es la puerta de entrada a usuarios interesados en el proyecto, donde encontrarán la información más importante del proyecto, plazos del proyecto, una guía sobre como usar o implementar los servicios que levanta el código.