Reglas CLAUDE.md para Claude Code que se pueden comprobar

Una lista larga de preferencias no hace predecible a un agente. Una regla indica permiso, prohibición y una prueba observable. Si el workflow usa API, abre la guía BetterToken Claude Code vigente, configura tu propia clave y ejecuta un test corto: Dashboard debe mostrar el modelo, estado y tokens esperados. Guarda la clave en el entorno, nunca en CLAUDE.md.

Un contrato pequeño

## Goal
- Keep changes limited to the requested feature.
## Checks
- Run `npm test` after code changes.
## Forbidden
- Do not read, print, or commit `.env`.

«Código de calidad» no es comprobable; una orden y su código de salida sí.

Alcance y jerarquía

La documentación actual de Memory explica cómo Claude Code descubre instrucciones de distintos ámbitos. En este ejemplo, «la regla local puede sustituir una regla raíz normal, pero no la seguridad raíz» es un contrato escrito por el proyecto, no una excepción universal incorporada. Revisa las reglas visibles y elimina duplicados.

Separa tipos de regla

Tipo	Ejemplo	Prueba
Objetivo	leer perfil	solo cambia módulo objetivo
Límite	sin migración	no aparece en diff
Check	npm test	salida 0
Estilo	nombres existentes	sin refactor extra

Explicaciones largas van a docs/ con enlace.

Conflictos y ejemplo

Antes de editar lee package.json, los archivos solicitados y reglas locales. No inventes comandos. Si dos reglas dan checks distintos, conserva uno local y verificable y elimina el duplicado.

Prueba reversible

Cambia el nombre de una variable local en un test y ejecuta:

git diff --check
git diff --stat
npm test

Rechaza si cambió otro archivo o falta el check.

Secretos y mantenimiento

Nunca guardes API keys, tokens CI, datos personales o .env en CLAUDE.md; usa API_KEY=your_api_key_here. Los secretos reales pasan por entorno o secret store. Revisa el contrato al cambiar tests, paquetes o directorios.

Fuentes

• Claude Code memory
• BetterToken Claude Code documentation