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
25 lines
2.0 KiB
Markdown
25 lines
2.0 KiB
Markdown
# 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. |