mirror of
https://github.com/affaan-m/ECC.git
synced 2026-08-17 21:15:40 +02:00
haelyraandGitHub
569b1d5b32
* fix: disable Claude co-author attribution by default * fix: harden default co-author opt-out and correct the docs Follow-up on the co-author default in this PR. - Remove the existsSync/writeFileSync race in the installer settings write (CodeQL js/file-system-race, high). A single guarded read now covers the fresh-install case, and unreadable or non-object settings are left untouched. - Respect `attribution` as an explicit user choice. It supersedes `includeCoAuthoredBy` in Claude Code 2.1.x, so a user who configured it would otherwise have had a dead key written into their settings. - Share one opt-out rule via scripts/lib/claude-commit-attribution.js instead of duplicating it across the installer and plugin setup. - Update the git-workflow rule and its nine mirrors and translations, which still told users ECC does not ship this setting. We keep writing the deprecated `includeCoAuthoredBy` key rather than `attribution`: unknown keys fail Claude Code settings validation, so writing `attribution` would break users on older versions.
Reglas (Rules)
Convenciones de codificación y mejores prácticas para Claude Code.
Estructura de Directorios
Common (Reglas Independientes del Lenguaje)
Reglas fundamentales que aplican a todos los lenguajes de programación:
- agents.md - Orquestación y uso de agentes
- coding-style.md - Reglas generales de estilo de código (inmutabilidad, organización de archivos, manejo de errores)
- development-workflow.md - Flujo de trabajo de desarrollo de features (investigación, planificación, TDD, revisión de código)
- git-workflow.md - Flujo de trabajo de commits y PRs en Git
- hooks.md - Sistema de hooks (PreToolUse, PostToolUse, Stop)
- patterns.md - Patrones de diseño comunes (Repository, Formato de Respuesta de API)
- performance.md - Optimización de rendimiento (selección de modelo, gestión de la ventana de contexto)
- security.md - Reglas de seguridad (gestión de secretos, verificaciones de seguridad)
- testing.md - Requisitos de pruebas (TDD, cobertura mínima del 80%)
TypeScript/JavaScript
Reglas específicas para proyectos TypeScript y JavaScript:
- coding-style.md - Sistemas de tipos, inmutabilidad, manejo de errores, validación de entrada
- hooks.md - Prettier, verificación de TypeScript, advertencias de console.log
- patterns.md - Formato de respuesta de API, custom hooks, patrón Repository
- security.md - Gestión de secretos, variables de entorno
- testing.md - Testing E2E con Playwright
Python
Reglas específicas para proyectos Python:
- coding-style.md - PEP 8, anotaciones de tipos, inmutabilidad, herramientas de formateo
- hooks.md - Formateo con black/ruff, verificación de tipos con mypy/pyright
- patterns.md - Protocol (duck typing), dataclasses, context managers
- security.md - Gestión de secretos, escaneo de seguridad con bandit
- testing.md - Framework pytest, cobertura, organización de pruebas
Golang
Reglas específicas para proyectos Go:
- coding-style.md - gofmt/goimports, principios de diseño, manejo de errores
- hooks.md - Formateo con gofmt/goimports, go vet, staticcheck
- patterns.md - Functional options, interfaces pequeñas, inyección de dependencias
- security.md - Gestión de secretos, escaneo de seguridad con gosec, context y timeouts
- testing.md - Pruebas table-driven, detección de condiciones de carrera, cobertura
Uso
Estas reglas son cargadas y aplicadas automáticamente por Claude Code. Las reglas:
- Independientes del lenguaje - Las reglas en el directorio
common/aplican a todos los proyectos - Específicas por lenguaje - Las reglas en los directorios de lenguaje (typescript/, python/, golang/) extienden las reglas comunes
- Basadas en rutas - Las reglas se aplican a archivos que coinciden con los patrones de rutas en el frontmatter YAML
Documentación Original
El original en inglés de esta documentación se encuentra en el directorio rules/.