feat: initial commit of Claude Code configuration

Add comprehensive Claude Code setup including:
- Custom coding rules (Go, Git, Testing, Security, Patterns)
- 24 installed plugins (Voltagent, Workflows, Skills)
- Cross-platform installers (bash, PowerShell)
- Complete documentation

This configuration provides the same powerful development
environment across any Claude Code installation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-02-09 11:37:04 -03:00
parent 7e5bce80ff
commit f0ecc7acd5
13 changed files with 888 additions and 2 deletions

174
README.md
View File

@@ -1,3 +1,173 @@
# claude # Claude Code Configuration
Claude Code Configuration - Agents, Skills, and Rules > Mi configuración personal de Claude Code con todos los agentes, skills y reglas para desarrollo profesional.
## 🚀 ¿Qué incluye?
### 📁 Reglas de Desarrollo (rules/)
- **Go Coding Style** - Formato con gofmt/goimports, principios de diseño
- **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)
#### Voltagent Subagents (11 plugins)
- **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
- **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
- **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
- **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
- **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
- **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
- **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)
- **python-development** - Python pro, async patterns, type safety, packaging
- **javascript-typescript** - Modern JavaScript, TypeScript advanced types, Node.js backend
- **backend-development** - API design, architecture patterns, event store design, microservices, saga orchestration
- **kubernetes-operations** - Helm charts, GitOps, K8s security, manifests
- **cloud-infrastructure** - Hybrid cloud networking, Linkerd, mTLS, service mesh observability
- **security-scanning** - Attack tree construction, STRIDE analysis, SAST configuration
- **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)
- **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)
- **swift-lsp** - Swift language server support
#### Everything Claude Code (1 plugin)
- **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
## 📦 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
**Author**: @renato97
**Last Updated**: 2026-02-09

115
install.ps1 Normal file
View File

@@ -0,0 +1,115 @@
# Claude Code Configuration Installer for Windows
# Restores your Claude Code environment with agents, skills, and rules
# Error handling
$ErrorActionPreference = "Stop"
# Colors (PowerShell 7+)
function Print-Header {
param([string]$Message)
Write-Host "`n======================================" -ForegroundColor Blue
Write-Host $Message -ForegroundColor Blue
Write-Host "======================================" -ForegroundColor Blue
}
function Print-Step {
param([string]$Message)
Write-Host "[✓] $Message" -ForegroundColor Green
}
function Print-Info {
param([string]$Message)
Write-Host "[i] $Message" -ForegroundColor Yellow
}
# Get script directory
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
$ClaudeDir = Join-Path $env:USERPROFILE ".claude"
# Check if Claude Code is installed
if (-not (Get-Command "claude" -ErrorAction SilentlyContinue)) {
Write-Host "[Error] Claude Code CLI not found!" -ForegroundColor Red
Write-Host "Please install Claude Code first: https://claude.ai/code"
exit 1
}
Print-Header "Claude Code Configuration Installer (Windows)"
# Step 1: Backup existing configuration
Print-Step "Backing up existing configuration..."
if (Test-Path $ClaudeDir) {
$BackupDir = "$env:USERPROFILE\.claude.backup.$(Get-Date -Format 'yyyyMMdd_HHmmss')"
Copy-Item -Path $ClaudeDir -Destination $BackupDir -Recurse -Force
Print-Info "Backup created at: $BackupDir"
}
# Step 2: Copy rules
Print-Step "Installing coding rules and patterns..."
$RulesDir = Join-Path $ScriptDir "rules"
$TargetRulesDir = Join-Path $ClaudeDir "rules"
if (-not (Test-Path $TargetRulesDir)) {
New-Item -ItemType Directory -Path $TargetRulesDir -Force | Out-Null
}
Copy-Item -Path "$RulesDir\*" -Destination $TargetRulesDir -Recurse -Force
Print-Info "Rules installed to: $TargetRulesDir"
# Step 3: Install plugins via marketplace
Print-Step "Installing plugins from marketplace..."
$plugins = @(
"everything-claude-code@everything-claude-code",
"voltagent-core-dev@voltagent-subagents",
"voltagent-lang@voltagent-subagents",
"voltagent-infra@voltagent-subagents",
"voltagent-qa-sec@voltagent-subagents",
"voltagent-data-ai@voltagent-subagents",
"voltagent-dev-exp@voltagent-subagents",
"voltagent-domains@voltagent-subagents",
"voltagent-biz@voltagent-subagents",
"voltagent-meta@voltagent-subagents",
"voltagent-research@voltagent-subagents",
"python-development@claude-code-workflows",
"javascript-typescript@claude-code-workflows",
"backend-development@claude-code-workflows",
"kubernetes-operations@claude-code-workflows",
"cloud-infrastructure@claude-code-workflows",
"security-scanning@claude-code-workflows",
"code-review-ai@claude-code-workflows",
"full-stack-orchestration@claude-code-workflows",
"conductor@claude-code-workflows",
"agent-teams@claude-code-workflows",
"document-skills@anthropic-agent-skills",
"example-skills@anthropic-agent-skills",
"swift-lsp@claude-plugins-official"
)
foreach ($plugin in $plugins) {
Print-Info "Installing $plugin..."
try {
claude plugin install $plugin 2>$null
} catch {
Write-Host " Warning: Failed to install $plugin" -ForegroundColor DarkYellow
}
}
# Step 4: Settings template
$SettingsTemplate = Join-Path $ScriptDir "settings.json.template"
if (Test-Path $SettingsTemplate) {
Print-Step "Settings template available..."
Print-Info "To apply settings, copy manually to: ~/.claude/settings.json"
}
# Summary
Print-Header "Installation Complete!"
Write-Host ""
Write-Host "Your Claude Code environment has been configured with:" -ForegroundColor Green
Write-Host " • Custom coding rules (Go, Git, Testing, Security)"
Write-Host " • 24 specialized plugins (agents, skills, workflows)"
Write-Host " • Voltagent subagents for comprehensive coverage"
Write-Host ""
Write-Host "Next steps:" -ForegroundColor Yellow
Write-Host " 1. Restart Claude Code"
Write-Host " 2. Check available agents: /help"
Write-Host " 3. Check available skills: /skills"
Write-Host ""
Write-Host "Repository: https://gitea.cbcren.online/renato97/claude" -ForegroundColor Blue

119
install.sh Executable file
View File

@@ -0,0 +1,119 @@
#!/bin/bash
# Claude Code Configuration Installer
# Restores your Claude Code environment with agents, skills, and rules
set -e
# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
# Print functions
print_header() {
echo -e "${BLUE}======================================${NC}"
echo -e "${BLUE}$1${NC}"
echo -e "${BLUE}======================================${NC}"
}
print_step() {
echo -e "${GREEN}[✓]${NC} $1"
}
print_info() {
echo -e "${YELLOW}[i]${NC} $1"
}
# Get the script directory
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
CLAUDE_DIR="$HOME/.claude"
# Check if Claude Code is installed
if ! command -v claude &> /dev/null; then
echo -e "${RED}Error: Claude Code CLI not found!${NC}"
echo "Please install Claude Code first: https://claude.ai/code"
exit 1
fi
print_header "Claude Code Configuration Installer"
# Step 1: Backup existing configuration
print_step "Backing up existing configuration..."
if [ -d "$CLAUDE_DIR" ]; then
BACKUP_DIR="$HOME/.claude.backup.$(date +%Y%m%d_%H%M%S)"
cp -r "$CLAUDE_DIR" "$BACKUP_DIR"
print_info "Backup created at: $BACKUP_DIR"
fi
# Step 2: Copy rules
print_step "Installing coding rules and patterns..."
mkdir -p "$CLAUDE_DIR/rules"
cp -r "$SCRIPT_DIR/rules/"* "$CLAUDE_DIR/rules/"
print_info "Rules installed to: $CLAUDE_DIR/rules"
# Step 3: Install plugins via marketplace
print_step "Installing plugins from marketplace..."
# Function to install plugin from marketplace
install_plugin() {
local plugin_id="$1"
print_info "Installing $plugin_id..."
claude plugin install "$plugin_id" 2>/dev/null || echo " Warning: Failed to install $plugin_id"
}
# List of all plugins to install
plugins=(
"everything-claude-code@everything-claude-code"
"voltagent-core-dev@voltagent-subagents"
"voltagent-lang@voltagent-subagents"
"voltagent-infra@voltagent-subagents"
"voltagent-qa-sec@voltagent-subagents"
"voltagent-data-ai@voltagent-subagents"
"voltagent-dev-exp@voltagent-subagents"
"voltagent-domains@voltagent-subagents"
"voltagent-biz@voltagent-subagents"
"voltagent-meta@voltagent-subagents"
"voltagent-research@voltagent-subagents"
"python-development@claude-code-workflows"
"javascript-typescript@claude-code-workflows"
"backend-development@claude-code-workflows"
"kubernetes-operations@claude-code-workflows"
"cloud-infrastructure@claude-code-workflows"
"security-scanning@claude-code-workflows"
"code-review-ai@claude-code-workflows"
"full-stack-orchestration@claude-code-workflows"
"conductor@claude-code-workflows"
"agent-teams@claude-code-workflows"
"document-skills@anthropic-agent-skills"
"example-skills@anthropic-agent-skills"
"swift-lsp@claude-plugins-official"
)
# Install each plugin
for plugin in "${plugins[@]}"; do
install_plugin "$plugin"
done
# Step 4: Copy settings (optional, as template)
if [ -f "$SCRIPT_DIR/settings.json.template" ]; then
print_step "Settings template available..."
print_info "To apply settings, copy: cp settings.json.template ~/.claude/settings.json"
print_info "Then edit to your preferences"
fi
# Summary
print_header "Installation Complete!"
echo ""
echo -e "${GREEN}Your Claude Code environment has been configured with:${NC}"
echo " • Custom coding rules (Go, Git, Testing, Security)"
echo " • 24 specialized plugins (agents, skills, workflows)"
echo " • Voltagent subagents for comprehensive coverage"
echo ""
echo -e "${YELLOW}Next steps:${NC}"
echo " 1. Restart Claude Code"
echo " 2. Check available agents: /help"
echo " 3. Check available skills: /skills"
echo ""
echo -e "${BLUE}Repository: https://gitea.cbcren.online/renato97/claude${NC}"

173
plugins.json Normal file
View File

@@ -0,0 +1,173 @@
{
"version": 2,
"plugins": {
"everything-claude-code@everything-claude-code": [
{
"scope": "user",
"version": "1.2.0",
"gitCommitSha": "90ad2f3885033c981ae1ab72120cef252296aa6c"
}
],
"voltagent-core-dev@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"voltagent-lang@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"voltagent-infra@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"voltagent-qa-sec@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"voltagent-data-ai@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"voltagent-dev-exp@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"voltagent-domains@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"voltagent-biz@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"voltagent-meta@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"voltagent-research@voltagent-subagents": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd975af03cc4eea78cd46c84f092f136e3f02c5"
}
],
"python-development@claude-code-workflows": [
{
"scope": "user",
"version": "1.2.1",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"javascript-typescript@claude-code-workflows": [
{
"scope": "user",
"version": "1.2.1",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"backend-development@claude-code-workflows": [
{
"scope": "user",
"version": "1.3.0",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"kubernetes-operations@claude-code-workflows": [
{
"scope": "user",
"version": "1.2.1",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"cloud-infrastructure@claude-code-workflows": [
{
"scope": "user",
"version": "1.2.2",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"security-scanning@claude-code-workflows": [
{
"scope": "user",
"version": "1.3.0",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"code-review-ai@claude-code-workflows": [
{
"scope": "user",
"version": "1.2.0",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"full-stack-orchestration@claude-code-workflows": [
{
"scope": "user",
"version": "1.3.0",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"conductor@claude-code-workflows": [
{
"scope": "user",
"version": "1.2.0",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"agent-teams@claude-code-workflows": [
{
"scope": "user",
"version": "1.0.2",
"gitCommitSha": "5d65aa10638bcc1b390738e11f9bff213f61955a"
}
],
"document-skills@anthropic-agent-skills": [
{
"scope": "user",
"version": "1ed29a03dc85",
"gitCommitSha": "1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563"
}
],
"example-skills@anthropic-agent-skills": [
{
"scope": "user",
"version": "1ed29a03dc85",
"gitCommitSha": "1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563"
}
],
"swift-lsp@claude-plugins-official": [
{
"scope": "user",
"version": "1.0.0",
"gitCommitSha": "2cd88e7947b7382e045666abee790c7f55f669f3"
}
]
}
}

49
rules/agents.md Normal file
View File

@@ -0,0 +1,49 @@
# Agent Orchestration
## Available Agents
Located in `~/.claude/agents/`:
| Agent | Purpose | When to Use |
|-------|---------|-------------|
| planner | Implementation planning | Complex features, refactoring |
| architect | System design | Architectural decisions |
| tdd-guide | Test-driven development | New features, bug fixes |
| code-reviewer | Code review | After writing code |
| security-reviewer | Security analysis | Before commits |
| build-error-resolver | Fix build errors | When build fails |
| e2e-runner | E2E testing | Critical user flows |
| refactor-cleaner | Dead code cleanup | Code maintenance |
| doc-updater | Documentation | Updating docs |
## Immediate Agent Usage
No user prompt needed:
1. Complex feature requests - Use **planner** agent
2. Code just written/modified - Use **code-reviewer** agent
3. Bug fix or new feature - Use **tdd-guide** agent
4. Architectural decision - Use **architect** agent
## Parallel Task Execution
ALWAYS use parallel Task execution for independent operations:
```markdown
# GOOD: Parallel execution
Launch 3 agents in parallel:
1. Agent 1: Security analysis of auth module
2. Agent 2: Performance review of cache system
3. Agent 3: Type checking of utilities
# BAD: Sequential when unnecessary
First agent 1, then agent 2, then agent 3
```
## Multi-Perspective Analysis
For complex problems, use split role sub-agents:
- Factual reviewer
- Senior engineer
- Security expert
- Consistency reviewer
- Redundancy checker

26
rules/coding-style.md Normal file
View File

@@ -0,0 +1,26 @@
# Go Coding Style
> This file extends [common/coding-style.md](../common/coding-style.md) with Go specific content.
## Formatting
- **gofmt** and **goimports** are mandatory — no style debates
## Design Principles
- Accept interfaces, return structs
- Keep interfaces small (1-3 methods)
## Error Handling
Always wrap errors with context:
```go
if err != nil {
return fmt.Errorf("failed to create user: %w", err)
}
```
## Reference
See skill: `golang-patterns` for comprehensive Go idioms and patterns.

45
rules/git-workflow.md Normal file
View File

@@ -0,0 +1,45 @@
# Git Workflow
## Commit Message Format
```
<type>: <description>
<optional body>
```
Types: feat, fix, refactor, docs, test, chore, perf, ci
Note: Attribution disabled globally via ~/.claude/settings.json.
## Pull Request Workflow
When creating PRs:
1. Analyze full commit history (not just latest commit)
2. Use `git diff [base-branch]...HEAD` to see all changes
3. Draft comprehensive PR summary
4. Include test plan with TODOs
5. Push with `-u` flag if new branch
## Feature Implementation Workflow
1. **Plan First**
- Use **planner** agent to create implementation plan
- Identify dependencies and risks
- Break down into phases
2. **TDD Approach**
- Use **tdd-guide** agent
- Write tests first (RED)
- Implement to pass tests (GREEN)
- Refactor (IMPROVE)
- Verify 80%+ coverage
3. **Code Review**
- Use **code-reviewer** agent immediately after writing code
- Address CRITICAL and HIGH issues
- Fix MEDIUM issues when possible
4. **Commit & Push**
- Detailed commit messages
- Follow conventional commits format

11
rules/hooks.md Normal file
View File

@@ -0,0 +1,11 @@
# Go Hooks
> This file extends [common/hooks.md](../common/hooks.md) with Go specific content.
## PostToolUse Hooks
Configure in `~/.claude/settings.json`:
- **gofmt/goimports**: Auto-format `.go` files after edit
- **go vet**: Run static analysis after editing `.go` files
- **staticcheck**: Run extended static checks on modified packages

39
rules/patterns.md Normal file
View File

@@ -0,0 +1,39 @@
# Go Patterns
> This file extends [common/patterns.md](../common/patterns.md) with Go specific content.
## Functional Options
```go
type Option func(*Server)
func WithPort(port int) Option {
return func(s *Server) { s.port = port }
}
func NewServer(opts ...Option) *Server {
s := &Server{port: 8080}
for _, opt := range opts {
opt(s)
}
return s
}
```
## Small Interfaces
Define interfaces where they are used, not where they are implemented.
## Dependency Injection
Use constructor functions to inject dependencies:
```go
func NewUserService(repo UserRepository, logger Logger) *UserService {
return &UserService{repo: repo, logger: logger}
}
```
## Reference
See skill: `golang-patterns` for comprehensive Go patterns including concurrency, error handling, and package organization.

55
rules/performance.md Normal file
View File

@@ -0,0 +1,55 @@
# Performance Optimization
## Model Selection Strategy
**Haiku 4.5** (90% of Sonnet capability, 3x cost savings):
- Lightweight agents with frequent invocation
- Pair programming and code generation
- Worker agents in multi-agent systems
**Sonnet 4.5** (Best coding model):
- Main development work
- Orchestrating multi-agent workflows
- Complex coding tasks
**Opus 4.5** (Deepest reasoning):
- Complex architectural decisions
- Maximum reasoning requirements
- Research and analysis tasks
## Context Window Management
Avoid last 20% of context window for:
- Large-scale refactoring
- Feature implementation spanning multiple files
- Debugging complex interactions
Lower context sensitivity tasks:
- Single-file edits
- Independent utility creation
- Documentation updates
- Simple bug fixes
## Extended Thinking + Plan Mode
Extended thinking is enabled by default, reserving up to 31,999 tokens for internal reasoning.
Control extended thinking via:
- **Toggle**: Option+T (macOS) / Alt+T (Windows/Linux)
- **Config**: Set `alwaysThinkingEnabled` in `~/.claude/settings.json`
- **Budget cap**: `export MAX_THINKING_TOKENS=10000`
- **Verbose mode**: Ctrl+O to see thinking output
For complex tasks requiring deep reasoning:
1. Ensure extended thinking is enabled (on by default)
2. Enable **Plan Mode** for structured approach
3. Use multiple critique rounds for thorough analysis
4. Use split role sub-agents for diverse perspectives
## Build Troubleshooting
If build fails:
1. Use **build-error-resolver** agent
2. Analyze error messages
3. Fix incrementally
4. Verify after each fix

28
rules/security.md Normal file
View File

@@ -0,0 +1,28 @@
# Go Security
> This file extends [common/security.md](../common/security.md) with Go specific content.
## Secret Management
```go
apiKey := os.Getenv("OPENAI_API_KEY")
if apiKey == "" {
log.Fatal("OPENAI_API_KEY not configured")
}
```
## Security Scanning
- Use **gosec** for static security analysis:
```bash
gosec ./...
```
## Context & Timeouts
Always use `context.Context` for timeout control:
```go
ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
defer cancel()
```

25
rules/testing.md Normal file
View File

@@ -0,0 +1,25 @@
# Go Testing
> This file extends [common/testing.md](../common/testing.md) with Go specific content.
## Framework
Use the standard `go test` with **table-driven tests**.
## Race Detection
Always run with the `-race` flag:
```bash
go test -race ./...
```
## Coverage
```bash
go test -cover ./...
```
## Reference
See skill: `golang-testing` for detailed Go testing patterns and helpers.

31
settings.json.template Normal file
View File

@@ -0,0 +1,31 @@
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
},
"enabledPlugins": {
"everything-claude-code@everything-claude-code": true,
"voltagent-core-dev@voltagent-subagents": true,
"voltagent-lang@voltagent-subagents": true,
"voltagent-infra@voltagent-subagents": true,
"voltagent-qa-sec@voltagent-subagents": true,
"voltagent-data-ai@voltagent-subagents": true,
"voltagent-dev-exp@voltagent-subagents": true,
"voltagent-domains@voltagent-subagents": true,
"voltagent-biz@voltagent-subagents": true,
"voltagent-meta@voltagent-subagents": true,
"voltagent-research@voltagent-subagents": true,
"python-development@claude-code-workflows": true,
"javascript-typescript@claude-code-workflows": true,
"backend-development@claude-code-workflows": true,
"kubernetes-operations@claude-code-workflows": true,
"cloud-infrastructure@claude-code-workflows": true,
"security-scanning@claude-code-workflows": true,
"code-review-ai@claude-code-workflows": true,
"full-stack-orchestration@claude-code-workflows": true,
"conductor@claude-code-workflows": true,
"agent-teams@claude-code-workflows": true,
"document-skills@anthropic-agent-skills": true,
"example-skills@anthropic-agent-skills": true,
"swift-lsp@claude-plugins-official": true
}
}