Categorías de procedimientos¶
Los procedimientos se organizan en categorías temáticas para facilitar su gestión y búsqueda.
Sistema de numeración¶
Cada procedimiento tiene un ID con formato PROC-XX donde XX indica la categoría:
Categorías disponibles¶
01-09: Gestión y Documentación¶
Procedimientos relacionados con documentación y gestión del conocimiento.
| ID | Ejemplo |
|---|---|
| PROC-01 | Mantenimiento de documentación |
| PROC-02 | Actualización de knowledge base |
| PROC-03 | Sincronización de README |
| PROC-05 | Revisión de changelog |
Agentes típicos: documentation-engineer, documentation-architect
10-19: Base de Datos¶
Procedimientos para gestión y optimización de bases de datos.
| ID | Ejemplo |
|---|---|
| PROC-10 | Revisión de performance |
| PROC-11 | Verificación de backups |
| PROC-12 | Ejecución de migraciones |
| PROC-15 | Optimización de índices |
| PROC-18 | Limpieza de datos |
Agentes típicos: database-optimizer
20-29: Despliegue y Release¶
Procedimientos para despliegues y gestión de releases.
| ID | Ejemplo |
|---|---|
| PROC-20 | Checklist pre-deploy |
| PROC-21 | Deploy a producción |
| PROC-22 | Proceso de rollback |
| PROC-23 | Hotfix urgente |
| PROC-25 | Generación de release notes |
Agentes típicos: devops-troubleshooter, incident-responder
30-39: Testing y Calidad¶
Procedimientos de testing, QA y revisión de código.
| ID | Ejemplo |
|---|---|
| PROC-30 | Revisión de tests |
| PROC-32 | Code review checklist |
| PROC-35 | Testing de integración |
| PROC-38 | Validación de cobertura |
Agentes típicos: backend-architect, dotnet-architect
40-49: Seguridad¶
Procedimientos de seguridad y auditoría.
| ID | Ejemplo |
|---|---|
| PROC-40 | Semgrep security review |
| PROC-42 | Auditoría de permisos |
| PROC-45 | Rotación de secrets |
| PROC-48 | Revisión de dependencias |
Agentes típicos: security-specialist
50-59: Observabilidad¶
Procedimientos de monitoreo y alertas.
| ID | Ejemplo |
|---|---|
| PROC-50 | Revisión de errores Sentry |
| PROC-52 | Análisis de métricas |
| PROC-55 | Investigación de alertas |
Agentes típicos: sentry-integration, devops-troubleshooter
60-69: MCP¶
Procedimientos específicos del protocolo MCP.
| ID | Ejemplo |
|---|---|
| PROC-60 | Debug de servidor MCP |
| PROC-62 | Configuración de herramientas |
| PROC-65 | Optimización de prompts |
Agentes típicos: mcp-protocol-specialist
70-79: Arquitectura¶
Procedimientos de diseño y arquitectura.
| ID | Ejemplo |
|---|---|
| PROC-70 | Análisis de tech debt |
| PROC-72 | Revisión de arquitectura |
| PROC-75 | Planificación de refactoring |
Agentes típicos: backend-architect, dotnet-architect
80-99: Integraciones¶
Procedimientos para APIs e integraciones externas.
| ID | Ejemplo |
|---|---|
| PROC-80 | Configuración de API |
| PROC-82 | Testing de webhook |
| PROC-85 | Sincronización de datos |
| PROC-90 | Integración con terceros |
Agentes típicos: integration-engineer, holded-integration
Filtrar por categoría¶
En la lista de procedimientos¶
- Abre el dropdown Categoría
- Selecciona una categoría
- Solo se muestran los procedimientos de ese rango
En búsqueda¶
Puedes buscar por rango:
- "PROC-2" → Muestra todos los de despliegue (20-29)
- "database" → Filtra por texto en título
Asignar categoría¶
Al crear un procedimiento:
- Elige el ID según la categoría deseada
- Selecciona la categoría en el dropdown
- El sistema valida que coincidan
Coherencia
El ID y la categoría deben coincidir. Un PROC-25 debe estar en "Despliegue", no en "Base de datos".
Reorganizar categorías¶
Si necesitas cambiar la categoría de un procedimiento:
- Opción A: Crear nuevo procedimiento con ID correcto y eliminar el anterior
- Opción B: Contactar al administrador para migración
IDs inmutables
El ID del procedimiento no se puede cambiar una vez creado para mantener referencias.
Estadísticas por categoría¶
En la página de procedimientos puedes ver:
┌─────────────────────────────────────────────────────────────────┐
│ Procedimientos por Categoría │
├───────────────────────────────────┬─────────────────────────────┤
│ Gestión/Documentación (01-09) │ ████████ 8 │
│ Base de Datos (10-19) │ █████ 5 │
│ Despliegue/Release (20-29) │ ███████████ 11 │
│ Testing/Calidad (30-39) │ ██████ 6 │
│ Seguridad (40-49) │ ████ 4 │
│ Observabilidad (50-59) │ ███ 3 │
│ MCP (60-69) │ ██ 2 │
│ Arquitectura (70-79) │ █████ 5 │
│ Integraciones (80-99) │ ██████ 6 │
└───────────────────────────────────┴─────────────────────────────┘
Mejores prácticas¶
Elegir la categoría correcta¶
Pregúntate:
- ¿Cuál es el objetivo principal del procedimiento?
- ¿Qué tipo de agente lo ejecutará?
- ¿Dónde buscarían los usuarios este procedimiento?
Mantener balance¶
- Evita categorías con demasiados procedimientos
- Si una categoría crece mucho, considera subcategorías
- Documenta el propósito de cada categoría
Nombrar consistentemente¶
Usa patrones de nombres similares en cada categoría:
Gestión: "Mantenimiento de X", "Actualización de Y"
Deploy: "Deploy a X", "Rollback de X"
Testing: "Testing de X", "Validación de X"
Siguiente: Preview - Vista previa de procedimientos.