mirror of
https://github.com/affaan-m/ECC.git
synced 2026-08-17 21:15:40 +02:00
fd1b11cfc7
Model-routing guidance across the rules, skills, and harness-steering docs still recommends Sonnet 4.6 / Opus 4.5-4.6 by name. Readers on the current generation have to map those onto Sonnet 5 / Opus 5 themselves, and the recommendation reads as pinned to a superseded generation. Renames the recommended models in guidance tables and updates two pinned model IDs in code samples: - rules/steering guidance: .cursor, .kiro, and the seven translated performance.md copies (ja-JP, zh-CN, zh-TW, ko-KR, pt-BR, es, tr) - skills/prompt-optimizer complexity-routing table (+ zh-CN copy) - skills/cost-aware-llm-pipeline MODEL_SONNET constant (+ zh-CN, ja-JP) - docs/examples project-guidelines template, which pinned the invalid ID claude-sonnet-4-5-20250514 (+ zh-TW, ja-JP copies) Deliberately left alone: - The "Pricing Reference (2025-2026)" table in cost-aware-llm-pipeline. Renaming those rows while keeping the existing per-token figures would assert Claude 5 pricing this change has not verified. - Executable model config (.opencode/opencode.json, agent.yaml). Those pins change real agent behavior and belong in their own reviewed change. - Historical and illustrative references: the-shortform-guide session transcripts, the ECC-PRO roadmap log entry, gan-style-harness's "Opus 4.5-class"/"Opus 4.6-class" capability tiers, and strategic-compact's deliberately generic "400k Opus 4.x" example. - docs/ATLAS-CLOUD-GUIDE.md, which lists a third-party provider's catalog. Documentation wording only; no behavioral change. Co-authored-by: Phumchai Tanonsi <274848436+phumchai1515-prog@users.noreply.github.com>
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/.