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. La decena del número indica, por convención, la categoría a la que pertenece:

PROC-21
     └── Número: 21 → Categoría "deployment" (rango 20-29)

Convención, no regla estricta

La categoría real es la que se asigna en el campo Categoría del procedimiento. Hay excepciones al rango, como PROC-90 (documentación) o PROC-99 (testing).

Categorías disponibles¶

Catálogo sincronizado con la plataforma el 18/09/2026 (54 procedimientos activos).

00-09: Documentación (`documentation`)¶

Procedimientos de documentación, gestión del conocimiento y orquestación.

ID	Procedimiento
PROC-00	Procedimiento maestro: orquestación de procedimientos
PROC-01	Actualización y mantenimiento de la documentación
PROC-02	Verificación de salud de infraestructura
PROC-03	README Health Check
PROC-05	Sincronización de documentación API
PROC-06	Generación de changelog
PROC-07	ADR Compliance Check
PROC-08	Validación de enlaces en documentación
PROC-09	Diagram Sync Check
PROC-90	Actualización de documentación wiki

Agentes típicos: documentation-engineer, documentation-architect, wiki-documentation-agent

10-19: Base de datos (`database`)¶

Procedimientos para gestión, mantenimiento y optimización de bases de datos.

ID	Procedimiento
PROC-10	Revisión de rendimiento de base de datos
PROC-11	Migración de schema de base de datos
PROC-12	Verificación de backups de base de datos
PROC-13	Análisis de índices de base de datos
PROC-14	Tareas de mantenimiento de base de datos
PROC-15	Análisis de crecimiento de base de datos
PROC-16	Monitor de pool de conexiones
PROC-17	Análisis de bloqueos y deadlocks

Agentes típicos: database-optimizer, database-admin

20-29: Despliegue (`deployment`)¶

Procedimientos para releases, pipelines y entornos.

ID	Procedimiento
PROC-20	Planificación de release
PROC-21	Deploy a producción
PROC-23	Pipeline Health Monitor
PROC-24	Feature Flags Cleanup
PROC-25	Detección de drift entre entornos
PROC-26	Container Images Cleanup
PROC-27	Build Performance Analysis

Agentes típicos: deployment-engineer, devops-troubleshooter

30-39: Calidad de código (`code-quality`)¶

Procedimientos de testing, revisión y calidad del código.

ID	Procedimiento
PROC-30	Revisión de tests unitarios
PROC-31	Análisis de gaps de tests y creación
PROC-32	Code Review Checklist
PROC-33	Code Duplication Analysis
PROC-34	Code Complexity Analysis
PROC-35	Dead Code Detection
PROC-36	Flaky Tests Detection
PROC-37	E2E Tests Health Check
PROC-38	Performance Regression Check

Agentes típicos: code-reviewer, test-automator, performance-engineer

40-49: Seguridad (`security`)¶

Procedimientos de seguridad y auditoría.

ID	Procedimiento
PROC-40	Revisión de seguridad con Semgrep
PROC-41	Auditoría de scopes y permisos
PROC-43	Escaneo de secrets y rotación
PROC-44	IAM Permissions Audit
PROC-45	OWASP Top 10 Checklist

Agentes típicos: security-auditor, security-specialist

50-59: Informes e incidentes (`reporting`)¶

Procedimientos de generación de informes y gestión de incidentes.

ID	Procedimiento
PROC-50	Generación de informes PM
PROC-51	Investigación de incidentes
PROC-52	Postmortem de incidentes

Agentes típicos: incident-responder, business-analyst

60-69: Mantenimiento MCP (`maintenance`)¶

Procedimientos específicos del servidor MCP y del sistema de instrucciones.

ID	Procedimiento
PROC-60	Añadir nueva herramienta MCP
PROC-61	MCP Context Optimization Analysis
PROC-62	Depuración de MCP y sistema de instrucciones

Agentes típicos: mcp-protocol-specialist

70-79: Dependencias y deuda técnica (`dependencies`)¶

Procedimientos de análisis de dependencias, licencias y deuda técnica.

ID	Procedimiento
PROC-70	Análisis de deuda técnica
PROC-72	NPM Security Audit
PROC-73	License Compliance Check
PROC-74	Framework EOL Monitor

Agentes típicos: architect-review, legacy-modernizer

80-89: Monitorización (`monitoring`)¶

Procedimientos de observabilidad, errores y alertas.

ID	Procedimiento
PROC-80	Revisión y resolución de errores en Sentry
PROC-81	Log Anomaly Detection
PROC-85	Scraper Health Monitor

Agentes típicos: sentry-integration, observability-engineer, error-detective

Testing (`testing`)¶

Procedimientos internos de prueba de la plataforma.

ID	Procedimiento
PROC-99	Test Traceability (Dummy)

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 la distribución por categoría. Datos a 18/09/2026:

┌─────────────────────────────────────────────────────────────────┐
│ Procedimientos por Categoría                                    │
├───────────────────────────────────┬─────────────────────────────┤
│ Documentación (documentation)     │ ██████████ 10              │
│ Calidad de código (code-quality)  │ █████████ 9                │
│ Base de datos (database)          │ ████████ 8                 │
│ Despliegue (deployment)           │ ███████ 7                  │
│ Seguridad (security)              │ █████ 5                    │
│ Mantenimiento MCP (maintenance)   │ ████ 4                     │
│ Dependencias (dependencies)       │ ████ 4                     │
│ Informes (reporting)              │ ███ 3                      │
│ Monitorización (monitoring)       │ ███ 3                      │
│ Testing (testing)                 │ █ 1                        │
└───────────────────────────────────┴─────────────────────────────┘

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.