Nexus - AI Task Orchestrator

00-master-procedures
Procedimiento Maestro: Orquestaci├│n de Procedimientos

Documentacion
1 plugin(s)
Titulo
Descripcion
Contenido Markdown
35625 caracteres
# Procedimiento Maestro: Orquestaci├│n de Procedimientos

## Metadata
- **ID**: PROC-00
- **Frecuencia**: Referencia continua
- **Duraci├│n estimada**: Variable
- **Requiere**: Conocimiento de todos los procedimientos
- **Actualizado**: 2025-01-05
- **Versi├│n**: 2.0

## Objetivo

Servir como ├¡ndice y gu├¡a de orquestaci├│n para todos los procedimientos del proyecto, indicando cu├índo usar cada uno, qu├® agentes IA cargar, y en qu├® orden ejecutarlos.

---

## ­ƒÅù´©Å Estructura de Numeraci├│n

| Rango | Categor├¡a | Descripci├│n |
|-------|-----------|-------------|
| **00-09** | Gesti├│n y Documentaci├│n | Procedimientos meta, docs, onboarding |
| **10-19** | Base de Datos | Migraciones, performance, backups (decimales disponibles) |
| **20-29** | Despliegue y Release | Planning, deploy (21 = producci├│n Ô¡É), rollback |
| **30-39** | Testing y Calidad | Tests, reviews, QA |
| **40-49** | Seguridad | SAST, auditor├¡as, secrets, compliance |
| **50-59** | Observabilidad e Incidentes | Monitoring, errores, postmortems |
| **60-69** | MCP Espec├¡fico | Tools, debugging, optimizaci├│n |
| **70-79** | Arquitectura y Mantenimiento | Tech debt, dependencies, refactoring |
| **80-99** | Integraciones Externas | Icecat, Amara, APIs terceros |
| **100+** | Operaciones Especiales | DR, compliance, auditor├¡as externas |

---

## ­ƒñû Sistema de Ejecuci├│n con Agentes

### C├│mo Ejecutar un Procedimiento

```
Usuario dice: "Ejecuta PROC-XX"

Claude debe:
1. Detectar la ruta del sistema de agentes ($AI_PATH):
   - Buscar en orden: docs/.ai/, src/docs/.ai/, src/docs/ai-orchestrator/
   - Usar la primera que exista como $AI_PATH
2. Leer este archivo (00-master-procedures.md)
3. Buscar PROC-XX en la tabla de mapeo
4. Cargar el ORCHESTRATOR.md desde $AI_PATH/
5. Cargar los agentes y skills indicados
6. Ejecutar el procedimiento actuando como el agente principal
```

### Prompt de Ejecuci├│n Est├índar

```markdown
# Detectar $AI_PATH (usar la primera ruta que exista):
# - docs/.ai/
# - src/docs/.ai/
# - src/docs/ai-orchestrator/

Lee $AI_PATH/ORCHESTRATOR.md

Carga los siguientes recursos para PROC-XX:
- Agente principal: $AI_PATH/agents/[agent].md
- Agentes de apoyo: $AI_PATH/agents/[agents].md
- Skills: $AI_PATH/skills/[skill]/SKILL.md

Luego ejecuta $AI_PATH/procedures/XX-nombre.md actuando como [agent] principal.
```

---

## ­ƒôï Inventario de Procedimientos con Agentes

### 00-09: Gesti├│n y Documentaci├│n

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-00 | Master Procedures | - | - | - |
| PROC-01 | Documentation Maintenance | `context-manager` | `code-reviewer` | `documentation-standards` |
| PROC-02 | Infrastructure Health Check | `devops-troubleshooter` | `security-specialist` | `deployment-pipeline-design`, `secrets-management` |
| PROC-03 | README Health Check | `documentation-engineer` | `code-reviewer` | `documentation-standards` |
| PROC-04 | Developer Onboarding | `context-manager` | `code-reviewer` | - |
| PROC-05 | API Documentation Sync | `documentation-engineer` | `dotnet-architect` | `api-design-principles` |
| PROC-06 | Changelog Generation | `documentation-engineer` | `devops-troubleshooter` | `documentation-standards` |
| PROC-07 | ADR Compliance Check | `documentation-engineer` | `architect-review` | `architecture-patterns` |
| PROC-08 | Documentation Links Validator | `documentation-engineer` | - | `documentation-standards` |
| PROC-09 | Diagram Sync Check | `documentation-architect` | `dotnet-architect` | `documentation-standards`, `architecture-patterns` |

### 10-19: Base de Datos

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-10 | Database Performance Review | `database-optimizer` | `cache-architect`, `dotnet-architect` | `dotnet-backend-patterns` |
| PROC-11 | Database Schema Migration | `database-optimizer` | `backend-architect` | `architecture-patterns` |
| PROC-12 | Database Backup Verification | `database-optimizer` | `devops-troubleshooter` | `incident-runbook-templates` |
| PROC-13 | Database Index Analysis | `database-optimizer` | `performance-engineer` | `dotnet-backend-patterns` |
| PROC-14 | Database Maintenance Tasks | `database-optimizer` | `devops-troubleshooter` | - |
| PROC-15 | Database Growth Analysis | `database-optimizer` | `architect-review` | - |
| PROC-16 | Database Connection Pool Monitor | `database-optimizer` | `observability-engineer` | `slo-implementation` |
| PROC-17 | Database Lock Analysis | `database-optimizer` | `incident-responder` | `incident-runbook-templates` |

### 20-29: Despliegue y Release

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-20 | Release Planning | `devops-troubleshooter` | `tdd-orchestrator`, `security-auditor` | `deployment-pipeline-design`, `gitlab-ci-patterns` |
| PROC-21 | Deploy Production Ô¡É | `devops-troubleshooter` | `security-auditor` | `deployment-pipeline-design`, `gitlab-ci-patterns` |
| PROC-22 | Rollback Procedure | `devops-troubleshooter` | `incident-responder` | `incident-runbook-templates` |
| PROC-23 | Pipeline Health Monitor | `devops-engineer` | `observability-engineer` | `gitlab-ci-patterns`, `slo-implementation` |
| PROC-24 | Feature Flags Cleanup | `devops-engineer` | `code-reviewer` | - |
| PROC-25 | Environment Drift Detection | `devops-engineer` | `security-auditor` | `deployment-pipeline-design` |
| PROC-26 | Container Images Cleanup | `devops-engineer` | - | `deployment-pipeline-design` |
| PROC-27 | Build Performance Analysis | `devops-engineer` | `performance-engineer` | `gitlab-ci-patterns` |

### 30-39: Testing y Calidad

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-30 | Unit Tests Review | `tdd-orchestrator` | `code-reviewer` | - |
| PROC-31 | Test Gaps Analysis | `tdd-orchestrator` | `code-reviewer` | - |
| PROC-32 | Code Review Checklist | `code-reviewer` | `architect-review`, `security-auditor` | `api-design-principles`, `architecture-patterns` |
| PROC-33 | Code Duplication Analysis | `code-quality-engineer` | `architect-review` | `architecture-patterns` |
| PROC-34 | Code Complexity Analysis | `code-quality-engineer` | `architect-review` | `architecture-patterns` |
| PROC-35 | Dead Code Detection | `code-quality-engineer` | `code-reviewer` | - |
| PROC-36 | Flaky Tests Detection | `qa-engineer` | `tdd-orchestrator` | - |
| PROC-37 | E2E Tests Health | `qa-engineer` | `tdd-orchestrator` | - |
| PROC-38 | Performance Regression Check | `qa-engineer` | `performance-engineer`, `dotnet-architect` | `slo-implementation` |

### 40-49: Seguridad

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-40 | Semgrep Security Review | `security-auditor` | `threat-modeling-expert` | `sast-configuration`, `stride-analysis-patterns` |
| PROC-41 | Security Scope Audit | `security-auditor` | `threat-modeling-expert` | `stride-analysis-patterns`, `secrets-management` |
| PROC-42 | Secrets Rotation | `security-auditor` | `devops-troubleshooter` | `secrets-management` |
| PROC-43 | Secrets Scanning | `security-specialist` | `devops-troubleshooter` | `secrets-management`, `stride-analysis-patterns` |
| PROC-44 | IAM Permissions Audit | `security-auditor` | `devops-engineer` | `secrets-management`, `stride-analysis-patterns` |
| PROC-45 | OWASP Top 10 Checklist | `security-auditor` | `threat-modeling-expert` | `sast-configuration`, `stride-analysis-patterns` |

### 50-59: Observabilidad e Incidentes

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-50 | *Monitoring Setup* | `observability-engineer` | `devops-troubleshooter` | `slo-implementation`, `distributed-tracing` | ÔÅ│ Pendiente
| PROC-51 | Incident Investigation | `incident-responder` | `integration-engineer`, `observability-engineer` | `incident-runbook-templates`, `distributed-tracing` |
| PROC-52 | Incident Postmortem | `incident-responder` | `observability-engineer` | `postmortem-writing`, `incident-runbook-templates` |

### 60-69: MCP Espec├¡fico

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-60 | Add MCP Tool | `mcp-protocol-specialist` | `backend-architect`, `dotnet-architect` | `api-design-principles`, `dotnet-backend-patterns` |
| PROC-61 | MCP Context Optimization | `mcp-protocol-specialist` | `cache-architect`, `performance-engineer` | `api-design-principles`, `slo-implementation` |
| PROC-62 | MCP Debugging | `mcp-protocol-specialist` | `integration-engineer`, `dotnet-architect` | `distributed-tracing`, `dotnet-backend-patterns` |

### 70-79: Arquitectura y Mantenimiento

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-70 | Tech Debt Analysis | `architect-review` | `code-reviewer`, `performance-engineer` | `architecture-patterns` |
| PROC-71 | Dependency Update | `architect-review` | `security-auditor`, `tdd-orchestrator` | `architecture-patterns` |
| PROC-72 | NPM Security Audit | `security-specialist` | `architect-review` | `sast-configuration` |
| PROC-73 | License Compliance Check | `compliance-engineer` | `architect-review` | - |
| PROC-74 | Framework EOL Monitor | `architect-review` | `security-auditor` | `architecture-patterns` |

### 80-99: Integraciones Externas

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-80 | Sentry Error Review | `observability-engineer` | `incident-responder` | `slo-implementation`, `distributed-tracing` |
| PROC-81 | Log Anomaly Detection | `devops-engineer` | `observability-engineer` | `slo-implementation`, `distributed-tracing` |

### 100+: Operaciones Especiales (Reservado)

| ID | Nombre | Agente Principal | Agentes Apoyo | Skills |
|----|--------|------------------|---------------|--------|
| PROC-100 | *Disaster Recovery Drill* | `devops-troubleshooter` | `database-optimizer` | `incident-runbook-templates` |
| PROC-101 | *External Audit Prep* | `security-auditor` | `architect-review` | `stride-analysis-patterns` |

---

## ­ƒÜÇ Prompts de Ejecuci├│n por Procedimiento

### PROC-01: Documentation Maintenance
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/context-manager.md, agents/code-reviewer.md
Carga: skills/documentation-standards/SKILL.md
Ejecuta $AI_PATH/procedures/01-documentation-maintenance.md como context-manager
```

### PROC-02: Infrastructure Health Check
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-troubleshooter.md, agents/security-specialist.md
Carga: skills/deployment-pipeline-design/SKILL.md, skills/secrets-management/SKILL.md
Ejecuta $AI_PATH/procedures/02-infrastructure-health.md como devops-troubleshooter
```

### PROC-04: Developer Onboarding
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/context-manager.md, agents/code-reviewer.md
Ejecuta $AI_PATH/procedures/04-developer-onboarding.md como context-manager
```

### PROC-10: Database Performance Review
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/database-optimizer.md, agents/performance-engineer.md, agents/dotnet-architect.md
Carga: skills/dotnet-backend-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/10-database-performance-review.md como database-optimizer
```

### PROC-11: Database Schema Migration
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/database-optimizer.md, agents/backend-architect.md
Carga: skills/architecture-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/11-database-schema-migration.md como database-optimizer
```

### PROC-12: Database Backup Verification
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/database-optimizer.md, agents/devops-troubleshooter.md
Carga: skills/incident-runbook-templates/SKILL.md
Ejecuta $AI_PATH/procedures/12-database-backup-verification.md como database-optimizer
```

### PROC-20: Release Planning
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-troubleshooter.md, agents/tdd-orchestrator.md, agents/security-auditor.md
Carga: skills/deployment-pipeline-design/SKILL.md, skills/gitlab-ci-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/20-release-planning.md como devops-troubleshooter
```

### PROC-21: Deploy Production Ô¡É
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-troubleshooter.md, agents/security-auditor.md
Carga: skills/deployment-pipeline-design/SKILL.md, skills/gitlab-ci-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/21-deploy-production.md como devops-troubleshooter
```

### PROC-22: Rollback Procedure
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-troubleshooter.md, agents/incident-responder.md
Carga: skills/incident-runbook-templates/SKILL.md
Ejecuta $AI_PATH/procedures/22-rollback-procedure.md como devops-troubleshooter
```

### PROC-30: Unit Tests Review
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/tdd-orchestrator.md, agents/code-reviewer.md
Ejecuta $AI_PATH/procedures/30-unit-tests-review.md como tdd-orchestrator
```

### PROC-31: Test Gaps Analysis
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/tdd-orchestrator.md, agents/code-reviewer.md
Ejecuta $AI_PATH/procedures/31-test-gaps-analysis.md como tdd-orchestrator
```

### PROC-32: Code Review Checklist
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/code-reviewer.md, agents/architect-review.md, agents/security-auditor.md
Carga: skills/api-design-principles/SKILL.md, skills/architecture-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/32-code-review-checklist.md como code-reviewer
```

### PROC-40: Semgrep Security Review
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/security-auditor.md, agents/threat-modeling-expert.md
Carga: skills/sast-configuration/SKILL.md, skills/stride-analysis-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/40-semgrep-security-review.md como security-auditor
```

### PROC-41: Security Scope Audit
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/security-auditor.md, agents/threat-modeling-expert.md
Carga: skills/stride-analysis-patterns/SKILL.md, skills/secrets-management/SKILL.md
Ejecuta $AI_PATH/procedures/41-security-scope-audit.md como security-auditor
```

### PROC-42: Secrets Rotation
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/security-auditor.md, agents/devops-troubleshooter.md
Carga: skills/secrets-management/SKILL.md
Ejecuta $AI_PATH/procedures/42-secrets-rotation.md como security-auditor
```

### PROC-43: Secrets Scanning
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/security-specialist.md, agents/devops-troubleshooter.md
Carga: skills/secrets-management/SKILL.md, skills/stride-analysis-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/43-secrets-scanning.md como security-specialist
```

### PROC-80: Sentry Error Review
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/observability-engineer.md, agents/incident-responder.md
Carga: skills/slo-implementation/SKILL.md, skills/distributed-tracing/SKILL.md
Ejecuta $AI_PATH/procedures/80-sentry-error-review.md como observability-engineer
```

### PROC-51: Incident Investigation
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/incident-responder.md, agents/integration-engineer.md, agents/observability-engineer.md
Carga: skills/incident-runbook-templates/SKILL.md, skills/distributed-tracing/SKILL.md
Ejecuta $AI_PATH/procedures/51-incident-investigation.md como incident-responder
```

### PROC-52: Incident Postmortem
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/incident-responder.md, agents/observability-engineer.md
Carga: skills/postmortem-writing/SKILL.md, skills/incident-runbook-templates/SKILL.md
Ejecuta $AI_PATH/procedures/52-incident-postmortem.md como incident-responder
```

### PROC-60: Add MCP Tool
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/mcp-protocol-specialist.md, agents/backend-architect.md, agents/dotnet-architect.md
Carga: skills/api-design-principles/SKILL.md, skills/dotnet-backend-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/60-add-mcp-tool.md como mcp-protocol-specialist
```

### PROC-61: MCP Context Optimization
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/mcp-protocol-specialist.md, agents/cache-architect.md, agents/performance-engineer.md
Carga: skills/api-design-principles/SKILL.md, skills/slo-implementation/SKILL.md
Ejecuta $AI_PATH/procedures/61-mcp-context-optimization.md como mcp-protocol-specialist
```

### PROC-62: MCP Debugging
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/mcp-protocol-specialist.md, agents/integration-engineer.md, agents/dotnet-architect.md
Carga: skills/distributed-tracing/SKILL.md, skills/dotnet-backend-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/62-mcp-debugging.md como mcp-protocol-specialist
```

### PROC-70: Tech Debt Analysis
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/architect-review.md, agents/code-reviewer.md, agents/performance-engineer.md
Carga: skills/architecture-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/70-tech-debt-analysis.md como architect-review
```

### PROC-71: Dependency Update
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/architect-review.md, agents/security-auditor.md, agents/tdd-orchestrator.md
Carga: skills/architecture-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/71-dependency-update.md como architect-review
```

### PROC-03: README Health Check
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/documentation-engineer.md, agents/code-reviewer.md
Carga: skills/documentation-standards/SKILL.md
Ejecuta $AI_PATH/procedures/03-readme-health-check.md como documentation-engineer
```

### PROC-05: API Documentation Sync
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/documentation-engineer.md, agents/dotnet-architect.md
Carga: skills/api-design-principles/SKILL.md
Ejecuta $AI_PATH/procedures/05-api-documentation-sync.md como documentation-engineer
```

### PROC-06: Changelog Generation
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/documentation-engineer.md, agents/devops-troubleshooter.md
Carga: skills/documentation-standards/SKILL.md
Ejecuta $AI_PATH/procedures/06-changelog-generation.md como documentation-engineer
```

### PROC-07: ADR Compliance Check
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/documentation-engineer.md, agents/architect-review.md
Carga: skills/architecture-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/07-adr-compliance-check.md como documentation-engineer
```

### PROC-08: Documentation Links Validator
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/documentation-engineer.md
Carga: skills/documentation-standards/SKILL.md
Ejecuta $AI_PATH/procedures/08-documentation-links-validator.md como documentation-engineer
```

### PROC-09: Diagram Sync Check
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/documentation-architect.md, agents/dotnet-architect.md
Carga: skills/documentation-standards/SKILL.md, skills/architecture-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/09-diagram-sync-check.md como documentation-architect
```

### PROC-13: Database Index Analysis
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/database-optimizer.md, agents/performance-engineer.md
Carga: skills/dotnet-backend-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/13-database-index-analysis.md como database-optimizer
```

### PROC-14: Database Maintenance Tasks
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/database-optimizer.md, agents/devops-troubleshooter.md
Ejecuta $AI_PATH/procedures/14-database-maintenance-tasks.md como database-optimizer
```

### PROC-15: Database Growth Analysis
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/database-optimizer.md, agents/architect-review.md
Ejecuta $AI_PATH/procedures/15-database-growth-analysis.md como database-optimizer
```

### PROC-16: Database Connection Pool Monitor
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/database-optimizer.md, agents/observability-engineer.md
Carga: skills/slo-implementation/SKILL.md
Ejecuta $AI_PATH/procedures/16-database-connection-pool-monitor.md como database-optimizer
```

### PROC-17: Database Lock Analysis
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/database-optimizer.md, agents/incident-responder.md
Carga: skills/incident-runbook-templates/SKILL.md
Ejecuta $AI_PATH/procedures/17-database-lock-analysis.md como database-optimizer
```

### PROC-23: Pipeline Health Monitor
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-engineer.md, agents/observability-engineer.md
Carga: skills/gitlab-ci-patterns/SKILL.md, skills/slo-implementation/SKILL.md
Ejecuta $AI_PATH/procedures/23-pipeline-health-monitor.md como devops-engineer
```

### PROC-24: Feature Flags Cleanup
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-engineer.md, agents/code-reviewer.md
Ejecuta $AI_PATH/procedures/24-feature-flags-cleanup.md como devops-engineer
```

### PROC-25: Environment Drift Detection
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-engineer.md, agents/security-auditor.md
Carga: skills/deployment-pipeline-design/SKILL.md
Ejecuta $AI_PATH/procedures/25-environment-drift-detection.md como devops-engineer
```

### PROC-26: Container Images Cleanup
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-engineer.md
Carga: skills/deployment-pipeline-design/SKILL.md
Ejecuta $AI_PATH/procedures/26-container-images-cleanup.md como devops-engineer
```

### PROC-27: Build Performance Analysis
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-engineer.md, agents/performance-engineer.md
Carga: skills/gitlab-ci-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/27-build-performance-analysis.md como devops-engineer
```

### PROC-33: Code Duplication Analysis
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/code-quality-engineer.md, agents/architect-review.md
Carga: skills/architecture-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/33-code-duplication-analysis.md como code-quality-engineer
```

### PROC-34: Code Complexity Analysis
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/code-quality-engineer.md, agents/architect-review.md
Carga: skills/architecture-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/34-code-complexity-analysis.md como code-quality-engineer
```

### PROC-35: Dead Code Detection
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/code-quality-engineer.md, agents/code-reviewer.md
Ejecuta $AI_PATH/procedures/35-dead-code-detection.md como code-quality-engineer
```

### PROC-36: Flaky Tests Detection
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/qa-engineer.md, agents/tdd-orchestrator.md
Ejecuta $AI_PATH/procedures/36-flaky-tests-detection.md como qa-engineer
```

### PROC-37: E2E Tests Health
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/qa-engineer.md, agents/tdd-orchestrator.md
Ejecuta $AI_PATH/procedures/37-e2e-tests-health.md como qa-engineer
```

### PROC-38: Performance Regression Check
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/qa-engineer.md, agents/performance-engineer.md, agents/dotnet-architect.md
Carga: skills/slo-implementation/SKILL.md
Ejecuta $AI_PATH/procedures/38-performance-regression-check.md como qa-engineer
```

### PROC-44: IAM Permissions Audit
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/security-auditor.md, agents/devops-engineer.md
Carga: skills/secrets-management/SKILL.md, skills/stride-analysis-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/44-iam-permissions-audit.md como security-auditor
```

### PROC-45: OWASP Top 10 Checklist
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/security-auditor.md, agents/threat-modeling-expert.md
Carga: skills/sast-configuration/SKILL.md, skills/stride-analysis-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/45-owasp-top10-checklist.md como security-auditor
```

### PROC-72: NPM Security Audit
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/security-specialist.md, agents/architect-review.md
Carga: skills/sast-configuration/SKILL.md
Ejecuta $AI_PATH/procedures/72-npm-security-audit.md como security-specialist
```

### PROC-73: License Compliance Check
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/compliance-engineer.md, agents/architect-review.md
Ejecuta $AI_PATH/procedures/73-license-compliance-check.md como compliance-engineer
```

### PROC-74: Framework EOL Monitor
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/architect-review.md, agents/security-auditor.md
Carga: skills/architecture-patterns/SKILL.md
Ejecuta $AI_PATH/procedures/74-framework-eol-monitor.md como architect-review
```

### PROC-81: Log Anomaly Detection
```markdown
Lee $AI_PATH/ORCHESTRATOR.md
Carga: agents/devops-engineer.md, agents/observability-engineer.md
Carga: skills/slo-implementation/SKILL.md, skills/distributed-tracing/SKILL.md
Ejecuta $AI_PATH/procedures/81-log-anomaly-detection.md como devops-engineer
```

---

## ­ƒôè Flujos de Trabajo Comunes

### A. Desarrollo de Feature Nueva (MCP Tool)
```
PROC-60 (mcp-protocol-specialist) ÔåÆ PROC-32 (code-reviewer) ÔåÆ PROC-30 (tdd-orchestrator) ÔåÆ 
PROC-40 (security-auditor) ÔåÆ PROC-01 (context-manager) ÔåÆ PROC-20 (devops-troubleshooter) ÔåÆ PROC-21 Ô¡É
```

### B. Fix de Bug
```
PROC-80 (observability-engineer) ÔåÆ PROC-51 (incident-responder, opcional) ÔåÆ 
Fix + Tests ÔåÆ PROC-32 (code-reviewer) ÔåÆ PROC-20 (devops-troubleshooter) ÔåÆ PROC-21 Ô¡É
```

### C. Incidente en Producci├│n
```
PROC-51 (incident-responder) ÔåÆ PROC-21 Ô¡É (hotfix) ÔåÆ 
PROC-80 (observability-engineer) ÔåÆ PROC-52 (incident-responder, si P0/P1)
```

### D. Migraci├│n de Base de Datos
```
PROC-11 (database-optimizer) ÔåÆ PROC-10 (database-optimizer) ÔåÆ PROC-20 (devops-troubleshooter) ÔåÆ PROC-21 Ô¡É
```

### E. Rollback de Emergencia
```
PROC-22 (devops-troubleshooter) ÔåÆ PROC-80 (observability-engineer) ÔåÆ 
PROC-51 (incident-responder) ÔåÆ PROC-52 (incident-responder)
```

### F. Actualizaci├│n de Dependencias
```
PROC-71 (architect-review) ÔåÆ PROC-30 (tdd-orchestrator) ÔåÆ 
PROC-40 (security-auditor) ÔåÆ PROC-20 (devops-troubleshooter) ÔåÆ PROC-21 Ô¡É
```

### G. Rotaci├│n de Secretos
```
PROC-42 (security-auditor) ÔåÆ PROC-21 Ô¡É ÔåÆ PROC-80 (observability-engineer)
```

---

## ­ƒôà Calendario de Procedimientos

| Frecuencia | Procedimientos | Agente Principal |
|------------|----------------|------------------|
| **Diario** | PROC-02, PROC-16, PROC-23, PROC-80, PROC-81 | devops-troubleshooter, database-optimizer, devops-engineer, observability-engineer |
| **Cada PR** | PROC-32 | code-reviewer |
| **Pre-merge** | PROC-30 | tdd-orchestrator |
| **Pre-release** | PROC-06, PROC-20, PROC-38, PROC-40, PROC-45 | documentation-engineer, devops-troubleshooter, qa-engineer, security-auditor |
| **Cada Deploy** | PROC-21 Ô¡É | devops-troubleshooter |
| **Semanal** | PROC-01, PROC-02, PROC-03, PROC-05, PROC-08, PROC-10, PROC-12, PROC-13, PROC-14, PROC-15, PROC-25, PROC-26, PROC-36, PROC-37, PROC-43, PROC-72 | context-manager, documentation-engineer, database-optimizer, devops-engineer, qa-engineer, security-specialist |
| **Mensual** | PROC-07, PROC-09, PROC-24, PROC-27, PROC-31, PROC-33, PROC-34, PROC-35, PROC-70, PROC-71, PROC-73, PROC-74 | documentation-engineer, documentation-architect, devops-engineer, code-quality-engineer, tdd-orchestrator, architect-review, compliance-engineer |
| **Trimestral** | PROC-41, PROC-42, PROC-44, PROC-61 | security-auditor, mcp-protocol-specialist |
| **Bajo demanda** | PROC-04, PROC-11, PROC-17, PROC-22, PROC-51, PROC-52, PROC-60, PROC-62 | (varios) |

---

## ­ƒöì Quick Reference: ┬┐Qu├® Procedimiento y Agente Usar?

| Situaci├│n | PROC | Agente |
|-----------|------|--------|
| "Hay errores nuevos en Sentry" | PROC-80 | observability-engineer |
| "La aplicaci├│n va lenta" | PROC-10 | database-optimizer |
| "Necesito a├▒adir una tool MCP" | PROC-60 | mcp-protocol-specialist |
| "Hay un bug cr├¡tico en producci├│n" | PROC-51 | incident-responder |
| "Voy a hacer un PR" | PROC-32 | code-reviewer |
| "Voy a deployar a producci├│n" | PROC-21 Ô¡É | devops-troubleshooter |
| "Necesito rollback urgente" | PROC-22 | devops-troubleshooter |
| "Necesito cambiar una tabla" | PROC-11 | database-optimizer |
| "Resolvimos un incidente grave" | PROC-52 | incident-responder |
| "Semgrep reporta vulnerabilidades" | PROC-40 | security-auditor |
| "┬┐Qu├® deuda t├®cnica tenemos?" | PROC-70 | architect-review |
| "┬┐Los scopes est├ín bien configurados?" | PROC-41 | security-auditor |
| "La documentaci├│n est├í desactualizada" | PROC-01 | context-manager |
| "README est├í mal" | PROC-03 | documentation-engineer |
| "API docs no coinciden" | PROC-05 | documentation-engineer |
| "Generar changelog" | PROC-06 | documentation-engineer |
| "ADRs desactualizados" | PROC-07 | documentation-engineer |
| "Links rotos en docs" | PROC-08 | documentation-engineer |
| "Diagramas desactualizados" | PROC-09 | documentation-architect |
| "Los tests est├ín fallando" | PROC-30 | tdd-orchestrator |
| "Tests flaky" | PROC-36 | qa-engineer |
| "E2E tests rotos" | PROC-37 | qa-engineer |
| "Performance degradado" | PROC-38 | qa-engineer |
| "MCP no funciona / JSON-RPC error" | PROC-62 | mcp-protocol-specialist |
| "Optimizar tokens de contexto MCP" | PROC-61 | mcp-protocol-specialist |
| "Problemas con Redis / cache" | PROC-10 | cache-architect |
| "Falla integraci├│n Amara/Icecat" | PROC-51 | integration-engineer |
| "OAuth / JWT / token error" | PROC-62 | oauth-security-specialist |
| "Actualizar NuGet/npm packages" | PROC-71 | architect-review |
| "Rotar secretos / API keys" | PROC-42 | security-auditor |
| "Nuevo desarrollador en el equipo" | PROC-04 | context-manager |
| "Verificar backups de BD" | PROC-12 | database-optimizer |
| "├ìndices BD lentos" | PROC-13 | database-optimizer |
| "Mantenimiento BD" | PROC-14 | database-optimizer |
| "BD crece mucho" | PROC-15 | database-optimizer |
| "Pool conexiones lleno" | PROC-16 | database-optimizer |
| "Deadlocks en BD" | PROC-17 | database-optimizer |
| "Health check infraestructura" | PROC-02 | devops-troubleshooter |
| "Verificar SSL/certificados" | PROC-02 | devops-troubleshooter |
| "Pipeline falla mucho" | PROC-23 | devops-engineer |
| "Feature flags viejos" | PROC-24 | devops-engineer |
| "Drift entre entornos" | PROC-25 | devops-engineer |
| "Limpiar im├ígenes Docker" | PROC-26 | devops-engineer |
| "Build muy lento" | PROC-27 | devops-engineer |
| "C├│digo duplicado" | PROC-33 | code-quality-engineer |
| "C├│digo muy complejo" | PROC-34 | code-quality-engineer |
| "C├│digo muerto" | PROC-35 | code-quality-engineer |
| "Escanear secrets en c├│digo" | PROC-43 | security-specialist |
| "Buscar API keys expuestas" | PROC-43 | security-specialist |
| "Revisar permisos IAM" | PROC-44 | security-auditor |
| "Checklist OWASP" | PROC-45 | security-auditor |
| "Audit NPM security" | PROC-72 | security-specialist |
| "Revisar licencias" | PROC-73 | compliance-engineer |
| "Frameworks deprecados" | PROC-74 | architect-review |
| "Anomal├¡as en logs" | PROC-81 | devops-engineer |

---

## ­ƒöù Dependencias entre Procedimientos

```
PROC-51 (incident-responder) ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔû║ PROC-52 (incident-responder)
         Ôöé
         ÔööÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔû║ PROC-80 (observability-engineer)

PROC-60 (mcp-protocol-specialist) ÔöÇÔû║ PROC-30 (tdd-orchestrator)
         Ôöé
         Ôö£ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔû║ PROC-01 (context-manager)
         Ôöé
         ÔööÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔû║ PROC-32 (code-reviewer)

PROC-11 (database-optimizer) ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔû║ PROC-10 (database-optimizer)

PROC-20 (devops-troubleshooter) ÔùäÔöÇÔöÇÔöÇ PROC-30 + PROC-40 + PROC-32 + PROC-01
         Ôöé
         ÔööÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔû║ PROC-21 Ô¡É (deploy)
                                              Ôöé
                                              ÔööÔöÇÔöÇÔû║ PROC-80 (post-deploy)

PROC-22 (rollback) ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔû║ PROC-80 + PROC-51

PROC-71 (dependencies) ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔû║ PROC-30 + PROC-40

PROC-42 (secrets) ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔû║ PROC-21 Ô¡É
```

---

## Ô£à Checklist de Onboarding (PROC-04)

Para nuevos miembros del equipo:

1. [ ] PROC-32 - Code Review (code-reviewer)
2. [ ] PROC-30 - Unit Tests (tdd-orchestrator)
3. [ ] PROC-50 - Sentry Review (observability-engineer)
4. [ ] PROC-60 - Add MCP Tool (mcp-protocol-specialist)
5. [ ] PROC-20 - Release Planning (devops-troubleshooter)
6. [ ] PROC-21 Ô¡É - Deploy Production (devops-troubleshooter)

---

## ­ƒôê M├®tricas de Procedimientos

| M├®trica | Target | Agente Responsable |
|---------|--------|-------------------|
| Tiempo medio PROC-51 | < 4h | incident-responder |
| PROC-50 ejecutado | Diario | observability-engineer |
| Cobertura tests (PROC-30) | > 70% | tdd-orchestrator |
| Findings cr├¡ticos (PROC-40) | 0 | security-auditor |
| Tech debt items resueltos/mes | >= 3 | architect-review |
| Secretos rotados (PROC-42) | Trimestral | security-auditor |
| Dependencies actualizadas (PROC-71) | Mensual | architect-review |

---

## ­ƒôØ Notas

- **IMPORTANTE**: Al decir "Ejecuta PROC-XX", Claude debe leer este archivo y cargar los agentes/skills correspondientes
- Cada procedimiento tiene su propia secci├│n de "Historial de Ejecuciones"
- Los procedimientos evolucionan: sugerir mejoras cuando se detecten
- Los agentes est├ín en `$AI_PATH/agents/`
- Los skills est├ín en `$AI_PATH/skills/`
- **PROC-21 es el n├║mero favorito del owner** Ô¡É

**ACCI├ôN REQUERIDA AL FINALIZAR:**

```bash
echo "====== PROCESO TERMINADO [$(date +%H%M%S)] ======" && echo "RESULTADO: <mensaje espec├¡fico>"
```

---

## ­ƒô£ Historial de Actualizaciones

| Fecha | Cambio | Autor |
|-------|--------|-------|
| 2024-12-27 | Creaci├│n inicial de 14 procedimientos | @ramac21 |
| 2024-12-27 | A├▒adidos PROC-15 y PROC-21 | Claude Code |
| 2024-12-28 | Integraci├│n con sistema de agentes IA | Claude Code |
| 2024-12-28 | A├▒adido PROC-22 (Context Optimization) | Claude Code |
| 2025-01-05 | **v2.0**: Reestructuraci├│n completa por rangos | Claude |
| 2025-01-05 | Nuevos: PROC-04, PROC-12, PROC-22, PROC-42, PROC-71 | Claude |
| 2025-01-05 | Migraci├│n de numeraci├│n v1 ÔåÆ v2 | Claude |
| 2025-01-07 | Nuevos: PROC-02 (Infrastructure Health), PROC-43 (Secrets Scanning) | Claude |
| 2025-01-07 | PROC-12 renombrado a Database Backup Verification | Claude |
| 2025-01-07 | **v3.0**: Expansi├│n masiva a 51 procedimientos | Claude |
| 2025-01-07 | Nuevos DB: PROC-13, 14, 15, 16, 17 (Index, Maintenance, Growth, Pool, Locks) | Claude |
| 2025-01-07 | Nuevos Docs: PROC-03, 05, 06, 07, 08 (README, API, Changelog, ADR, Links) | Claude |
| 2025-01-07 | Nuevos CI/CD: PROC-23, 24, 25, 26, 27 (Pipeline, Flags, Drift, Images, Build) | Claude |
| 2025-01-07 | Nuevos Testing: PROC-33, 34, 35, 36, 37, 38 (Duplication, Complexity, Dead, Flaky, E2E, Perf) | Claude |
| 2025-01-07 | Nuevos Security: PROC-44, 45 (IAM, OWASP) | Claude |
| 2025-01-07 | Nuevos Deps: PROC-72, 73, 74 (NPM Audit, License, EOL) | Claude |
| 2025-01-07 | Nuevo Logs: PROC-81 (Log Anomaly Detection) | Claude |
| 2025-01-07 | Nuevo Docs: PROC-09 (Diagram Sync Check) | Claude |