house-rules
Skill0 starsChanged 10 days agoMITView on GitHub
Estándares de código de la casa — simplicidad, cambios quirúrgicos, alcance y verificación. Úsala al escribir o modificar código, al revisar un diff, o cuando haya que decidir cuánto código escribir. No la uses para preguntas de hecho ni para exploración.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- devnu11/claude-skillstheir own version, first seen Nov 1, 2026
- fangdididi/house-rulestheir own version, first seen Oct 25, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- devnu11/claude-skills★ 1same name
- fangdididi/house-rules★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
No supongas. No escondas la confusión.
- Distinctive: line 49
No refactorices lo que no está roto.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Reglas de la casa
Cuatro principios contra los modos de fallo predecibles de un LLM escribiendo código: suposición silenciosa, sobrecomplejidad, deriva de alcance y ejecución vaga.
Atribución. Se citan a menudo como "los principios de Karpathy". No hay fuente primaria. Son una formulación de la comunidad derivada de sus observaciones (
multica-ai/andrej-karpathy-skills, literal: "derived from Andrej Karpathy's observations on LLM coding pitfalls"). Aquí son principios de la casa, y valen por lo que hacen, no por quién los firma. Verificado 2026-08-21.
1 · Pensar antes de escribir
No supongas. No escondas la confusión. Saca los compromisos a la luz.
Ante ambigüedad, el fallo típico no es elegir mal: es elegir en silencio. Si dos lecturas producen entregables distintos, preséntalas. Si producen lo mismo, elige, dilo, y sigue — preguntar lo irrelevante también es un fallo.
Empuja cuando haga falta. Un "de acuerdo" que sabes que es malo es peor que una objeción.
2 · Simplicidad primero
El mínimo código que resuelve el problema. Nada especulativo.
El defecto es escribir 1.000 líneas donde bastan 100. Concretamente:
- Ninguna funcionalidad más allá de lo pedido.
- Ninguna abstracción para un solo uso.
- Ninguna "flexibilidad" o "configurabilidad" que nadie pidió.
- Ningún manejo de errores para escenarios imposibles.
- Sin comentarios salvo que el porqué no sea obvio. El qué ya lo dice el código.
Prueba del ingeniero senior: si 200 líneas podrían ser 50, reescríbelas antes de entregar.
3 · Cambios quirúrgicos
Toca solo lo que debas. Limpia solo tu propio desorden.
- No "mejores" código, comentarios ni formato adyacentes.
- No refactorices lo que no está roto. Imita el estilo existente aunque tú lo harías de otra forma: un fichero coherente y mediocre es mejor que uno inconsistente y brillante a medias.
- Regla del huérfano: elimina los imports, variables y funciones que tus cambios dejaron sin usar. No elimines código muerto preexistente — menciónalo y sigue.
- Prefiere editar un fichero existente a crear uno nuevo.
4 · Ejecución dirigida a un objetivo
Define el criterio de éxito. Itera hasta verificarlo.
Un objetivo verificable es un comando. "Que funcione" no es un criterio; make test
devolviendo 0 sí lo es. Si no puedes nombrar el comando, no has definido el objetivo — y
eso se arregla con /spec, no escribiendo código y esperando.
Verificar no es opinar: es ejecutar y enseñar la salida.
Cómo se aplican en revisión
Ante un diff, en este orden:
- ¿Hace lo que se pidió? ¿Y solo lo que se pidió?
- ¿Sobra código? ¿Alguna abstracción tiene un solo llamante?
- ¿Toca ficheros que la tarea no requería?
- ¿Dejó huérfanos? ¿Borró código muerto que no le tocaba?
- ¿Hay un comando que demuestre que funciona, y se ejecutó?
Señales de que estás incumpliendo
| Estás a punto de… | Significa | Haz esto |
| Añadir un parámetro "por si acaso" | Especulación | Bórralo. Se añade cuando haga falta |
| Crear una clase base con un hijo | Abstracción prematura | Código directo |
| Arreglar un typo en una función que no tocabas | Deriva de alcance | Menciónalo, no lo toques |
Escribir try/except sin saber qué falla | Defensa ritual | Deja que falle ruidosamente |
| Decir "debería funcionar" | No has verificado | Ejecuta el oráculo |
Encadenar cmd | grep -q con pipefail | El exit de cmd contamina el del pipeline | Captura en variable y filtra después (MISTAKES M-003) |
| Reescribir un fichero para "dejarlo limpio" | Refactor no pedido | Edición incremental |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.