docs: update README with bilingual documentation

- Add English and Spanish sections
- Improve project description and features
- Add professional formatting
This commit is contained in:
Renato97
2026-03-31 01:32:53 -03:00
parent 0994725183
commit 60b1597ff4

243
README.md
View File

@@ -1,209 +1,76 @@
# Claude Code Configuration # 🤖 Claude Code Configuration / Configuración de Claude Code
> Mi configuración personal de Claude Code con todos los agentes, skills y reglas para desarrollo profesional. ## 📝 Description / Descripción
## 🚀 ¿Qué incluye? **English:**
Personalized Claude Code configuration repository containing custom rules, agent definitions, and settings optimized for software development workflows. Includes specialized agents for different programming languages and tasks.
### 📁 Reglas de Desarrollo (rules/) **Español:**
- **Go Coding Style** - Formato con gofmt/goimports, principios de diseño Repositorio de configuración personalizada de Claude Code que contiene reglas personalizadas, definiciones de agentes y ajustes optimizados para flujos de trabajo de desarrollo de software. Incluye agentes especializados para diferentes lenguajes de programación y tareas.
- **Git Workflow** - Formato de commits convencional, workflow de PRs
- **Testing** - Estrategias de testing con table-driven tests y race detection
- **Performance** - Selección de modelos (Haiku/Sonnet/Opus) y optimización
- **Patterns** - Patrones Go: functional options, interfaces pequeñas, DI
- **Security** - Gestión de secretos, gosec, context con timeouts
- **Hooks** - Auto-formatting, go vet, staticcheck
### 🤖 Plugins Instalados (24 total) ## 🚀 What's Included / Qué Incluye
#### Voltagent Subagents (11 plugins) **English:**
- **voltagent-core-dev** - API designer, backend developer, electron-pro, frontend-developer, fullstack-developer, graphql-architect, microservices-architect, mobile-developer, react-specialist, rust-engineer, swift-expert, typescript-pro, vue-expert - Custom agent definitions for specialized tasks
- **voltagent-lang** - Angular architect, C++ pro, C# developer, Django developer, Elixir expert, Flutter expert, Go pro, Java architect, JavaScript pro, Kotlin specialist, Laravel specialist, Next.js developer, PHP pro, PowerShell 5.1/7 expert, Python pro, Rails expert, React specialist, Rust engineer, Spring Boot engineer, SQL pro, Swift expert, TypeScript pro, Vue expert - Coding style rules and guidelines
- **voltagent-infra** - Azure infra engineer, cloud architect, database administrator, deployment engineer, DevOps engineer, incident responder, Kubernetes specialist, network engineer, platform engineer, security engineer, SRE engineer, Terraform engineer, Terragrunt expert, Windows infra admin - Git workflow patterns
- **voltagent-qa-sec** - Accessibility tester, AD security reviewer, architect reviewer, chaos engineer, code reviewer, compliance auditor, debugger, error detective, penetration tester, performance engineer, PowerShell security hardening, QA expert, security auditor, test automator - Performance optimization rules
- **voltagent-data-ai** - AI engineer, data analyst, data engineer, data scientist, database optimizer, LLM architect, machine learning engineer, ML engineer, MLOps engineer, NLP engineer, Postgres pro, prompt engineer - Security best practices
- **voltagent-dev-exp** - Build engineer, CLI developer, dependency manager, documentation engineer, DX optimizer, git workflow manager, legacy modernizer, MCP developer, PowerShell module architect, PowerShell UI architect, refactoring specialist, Slack expert, tooling engineer - Testing methodologies
- **voltagent-domains** - API documenter, blockchain developer, embedded systems, Fintech engineer, game developer, IoT engineer, M365 admin, mobile app developer, payment integration, quant analyst, risk manager, SEO specialist
- **voltagent-biz** - Business analyst, content marketer, customer success manager, legal advisor, product manager, project manager, sales engineer, scrum master, technical writer, UX researcher, WordPress master
- **voltagent-meta** - Agent organizer, context manager, error coordinator, IT ops orchestrator, knowledge synthesizer, multi-agent coordinator, performance monitor, task distributor, workflow orchestrator
- **voltagent-research** - Competitive analyst, data researcher, market researcher, research analyst, search specialist, trend analyst
#### Claude Code Workflows (10 plugins) **Español:**
- **python-development** - Python pro, async patterns, type safety, packaging - Definiciones de agentes personalizados para tareas especializadas
- **javascript-typescript** - Modern JavaScript, TypeScript advanced types, Node.js backend - Reglas y guías de estilo de código
- **backend-development** - API design, architecture patterns, event store design, microservices, saga orchestration - Patrones de flujo de trabajo Git
- **kubernetes-operations** - Helm charts, GitOps, K8s security, manifests - Reglas de optimización de rendimiento
- **cloud-infrastructure** - Hybrid cloud networking, Linkerd, mTLS, service mesh observability - Mejores prácticas de seguridad
- **security-scanning** - Attack tree construction, STRIDE analysis, SAST configuration - Metodologías de testing
- **code-review-ai** - Architect review specialist
- **full-stack-orchestration** - Test automator, performance engineer, deployment engineer
- **conductor** - Track management, context-driven development, workflow patterns
- **agent-teams** - Multi-reviewer patterns, task coordination, team composition, communication
#### Skills Plugins (2 plugins) ## 📦 Installation / Instalación
- **document-skills** - Theme factory, doc coauthoring, XLSX, PDF, algorithmic art, internal comms, skill creator, canvas design, PPTX, Slack GIF creator, webapp testing, frontend design, MCP builder, brand guidelines, DOCX, web artifacts
- **example-skills** - Same as document-skills (examples)
#### Official Plugins (1 plugin) **English:**
- **swift-lsp** - Swift language server support 1. Install Claude Code CLI
2. Clone this repository
3. Run install script: `./install.sh` (Linux/Mac) or `install.ps1` (Windows)
4. Configuration will be applied automatically
#### Everything Claude Code (1 plugin) **Español:**
- **everything-claude-code** - Complete toolkit with instincts, TDD, code review, Go patterns, Django patterns, Python testing, iterative retrieval, Spring Boot patterns, PostgreSQL patterns, ClickHouse IO, Spring Boot security, coding standards, eval harness, backend patterns, JPA patterns, continuous learning, continuous learning v2, TDD workflow, Django TDD, frontend patterns, Go testing, Python testing patterns, Python packaging, Python type safety, Python code style, uv package manager, Python resilience, Python design patterns, Python anti-patterns, Python error handling, Python resource management, Python observability, async Python patterns, Python configuration, Python project structure, Python performance optimization, JavaScript testing patterns, TypeScript advanced types, modern JavaScript patterns, NodeJS backend patterns, API design principles, architecture patterns, event store design, microservices patterns, workflow orchestration patterns, saga orchestration, projection patterns, Temporal Python testing, CQRS implementation, Helm chart scaffolding, GitOps workflow, K8s security policies, K8s manifest generator, hybrid cloud networking, Linkerd patterns, mTLS configuration, service mesh observability, cost optimization, multi-cloud architecture, Terraform module library, Istio traffic management, attack tree construction, STRIDE analysis patterns, threat mitigation mapping, SAST configuration, security requirement extraction, track management, context-driven development, workflow patterns, multi-reviewer patterns, task coordination strategies, team composition patterns, team communication protocols, parallel feature development, parallel debugging 1. Instala Claude Code CLI
2. Clona este repositorio
3. Ejecuta script de instalación: `./install.sh` (Linux/Mac) o `install.ps1` (Windows)
4. La configuración se aplicará automáticamente
### 🤖 Agentes Incluidos (141 archivos .md) ## 🛠️ Configuration Files / Archivos de Configuración
El repositorio incluye las definiciones completas de **141 agentes** en la carpeta `agents/`: - **plugins.json** - Plugin definitions and settings
- **settings.json.template** - Template for user settings
- **install.sh / install.ps1** - Installation scripts
**Core Development (14):** ## 🔧 Customization / Personalización
planner, architect, tdd-guide, code-reviewer, security-reviewer, python-reviewer, go-reviewer, go-build-resolver, build-error-resolver, database-reviewer, refactor-cleaner, doc-updater, e2e-runner, api-designer, backend-developer, electron-pro, frontend-developer, fullstack-developer, graphql-architect, microservices-architect, mobile-developer, ui-designer, websocket-engineer
**Languages (23):** **English:**
angular-architect, cpp-pro, csharp-developer, django-developer, dotnet-core-expert, dotnet-framework-4.8-expert, elixir-expert, flutter-expert, golang-pro, java-architect, javascript-pro, kotlin-specialist, laravel-specialist, nextjs-developer, php-pro, powershell-5.1-expert, powershell-7-expert, python-pro, rails-expert, react-specialist, rust-engineer, spring-boot-engineer, swift-expert, typescript-pro, vue-expert Edit `settings.json` to customize:
- Default AI model preferences
- Code review rules
- Auto-formatting options
- Notification settings
**Infrastructure (14):** **Español:**
azure-infra-engineer, cloud-architect, database-administrator, deployment-engineer, devops-engineer, devops-incident-responder, incident-responder, kubernetes-specialist, network-engineer, platform-engineer, security-engineer, sre-engineer, terraform-engineer, terragrunt-expert, windows-infra-admin Edita `settings.json` para personalizar:
- Preferencias de modelo de IA predeterminado
- Reglas de revisión de código
- Opciones de auto-formateo
- Ajustes de notificaciones
**QA & Security (14):** ## 👨‍💻 Author / Autor
accessibility-tester, ad-security-reviewer, architect-reviewer, chaos-engineer, code-reviewer, compliance-auditor, debugger, error-detective, penetration-tester, performance-engineer, powershell-security-hardening, qa-expert, security-auditor, test-automator
**Data & AI (13):** **Renato CBC**
ai-engineer, data-analyst, data-engineer, data-researcher, data-scientist, database-optimizer, llm-architect, machine-learning-engineer, ml-engineer, mlops-engineer, nlp-engineer, postgres-pro, prompt-engineer, sql-pro - GitHub: [renato97](https://gitea.cbcren.online/renato97)
**Developer Experience (13):** ## 📄 License / Licencia
build-engineer, cli-developer, dependency-manager, documentation-engineer, dx-optimizer, git-workflow-manager, legacy-modernizer, mcp-developer, powershell-module-architect, powershell-ui-architect, refactoring-specialist, slack-expert, tooling-engineer
**Domains (12):** MIT License / Licencia MIT
api-documenter, blockchain-developer, embedded-systems, fintech-engineer, game-developer, iot-engineer, m365-admin, mobile-app-developer, payment-integration, quant-analyst, risk-manager, seo-specialist
**Business (11):**
business-analyst, content-marketer, customer-success-manager, legal-advisor, product-manager, project-manager, sales-engineer, scrum-master, technical-writer, ux-researcher, wordpress-master
**Meta (10):**
agent-installer, agent-organizer, context-manager, error-coordinator, it-ops-orchestrator, knowledge-synthesizer, multi-agent-coordinator, performance-monitor, task-distributor, workflow-orchestrator
**Research (6):**
competitive-analyst, data-researcher, market-researcher, research-analyst, search-specialist, trend-analyst
**Y más...**
## 📦 Instalación Rápida
### Linux/macOS
```bash
# Clonar el repositorio
git clone https://gitea.cbcren.online/renato97/claude.git ~/claude-config
cd ~/claude-config
# Ejecutar el instalador
chmod +x install.sh
./install.sh
```
### Windows (PowerShell)
```powershell
# Clonar el repositorio
git clone https://gitea.cbcren.online/renato97/claude.git $env:USERPROFILE\claude-config
cd $env:USERPROFILE\claude-config
# Ejecutar el instalador
.\install.ps1
```
### Instalación Manual
```bash
# 1. Copiar las reglas
cp -r rules/* ~/.claude/rules/
# 2. Instalar plugins (ejemplos)
claude plugin install everything-claude-code@everything-claude-code
claude plugin install voltagent-core-dev@voltagent-subagents
claude plugin install python-development@claude-code-workflows
# ... etc para todos los plugins
```
## 🎯 Uso
Una vez instalado, tendrás acceso a:
### Agents (Comando `/agent` o uso automático)
- `/planner` - Planificación de implementación
- `/architect` - Diseño de sistemas
- `/tdd-guide` - Desarrollo TDD
- `/code-reviewer` - Review de código
- `/security-reviewer` - Análisis de seguridad
### Skills (Comando `/skill`)
- `/tdd` - Forzar workflow TDD
- `/plan` - Planificación estructurada
- `/go-review` - Review de código Go
- `/security` - Hardening de seguridad
- `/python-review` - Review Python
- `/e2e` - Tests end-to-end
- ...y muchos más
### Reglas Automáticas
Las reglas en `rules/` se aplican automáticamente durante:
- Edición de código Go (gofmt, goimports)
- Creación de commits (formato convencional)
- Creación de PRs (workflow definido)
- Testing (race detection, coverage)
- Desarrollo (TDD, code review obligatorio)
## 🔄 Actualización
```bash
cd ~/claude-config
git pull origin main
./install.sh
```
## 📁 Estructura del Repositorio
```
claude/
├── rules/ # Reglas de desarrollo
│ ├── agents.md # Referencia de agentes
│ ├── coding-style.md # Estilo Go
│ ├── git-workflow.md # Workflow Git
│ ├── hooks.md # Hooks post-edición
│ ├── patterns.md # Patrones Go
│ ├── performance.md # Optimización
│ ├── security.md # Seguridad Go
│ └── testing.md # Testing Go
├── plugins.json # Lista de plugins instalados
├── install.sh # Instalador Linux/macOS
├── install.ps1 # Instalador Windows
├── settings.json.template # Plantilla de configuración
└── README.md # Este archivo
```
## 🛠️ Personalización
Para agregar tus propias reglas o agentes:
1. Crear nuevos archivos `.md` en `rules/`
2. Modificar `settings.json.template` con tus preferencias
3. Actualizar `plugins.json` con plugins adicionales
4. Commit y push al repositorio
## 📚 Recursos Adicionales
- [Claude Code Documentation](https://docs.anthropic.com/claude-code)
- [Everything Claude Code](https://github.com/anthropics/everything-claude-code)
- [Voltagent Agents](https://github.com/voltagent/voltagent-subagents)
## 🤝 Contribuciones
Este repositorio es para uso personal, pero si encuentras algo útil:
1. Fork el repositorio
2. Crea una rama para tus cambios
3. Abre un Pull Request
## 📄 Licencia
MIT - Usa libremente para tu propio desarrollo
--- ---
**Repository**: https://gitea.cbcren.online/renato97/claude **Tags / Etiquetas:** `claude-code` `configuration` `ai` `development` `productivity` `automation`
**Author**: @renato97
**Last Updated**: 2026-02-09