Modos de ingeniería

RAPID OS clasifica el trabajo de ingeniería en modos declarativos. Cada modo define la intención del ciclo de trabajo y ajusta:

Context Compiler: Qué estándares, reglas de arquitectura y restricciones se incluyen o priorizan en el bundle de contexto generado (rapid context --mode <mode>).
Spec Registry: La naturaleza de los requerimientos y criterios de aceptación definidos en la especificación (rapid spec create --mode <mode>).
Execution Policy: La evaluación de riesgos (RiskLevel), clases de ejecución (ExecutionClass) y las compuertas de calidad (GateKind) requeridas antes de completar un run.

flowchart TD
    Mode["Modo de ingeniería seleccionado"] --> CC["Context Compiler\n(Filtra fuentes y presupuesto)"]
    Mode --> SR["Spec Registry\n(Define alcance y aceptación)"]
    Mode --> EP["Execution Policy\n(Asigna riesgo y gates requeridos)"]
    
    CC --> Run["Execution Contract & Run"]
    SR --> Run
    EP --> Run

Cada modo tiene su shortcut

El flujo principal es el shortcut del modo: lo instalas una vez (rapid init --shortcuts o rapid shortcuts install) y el agente conduce el run. Los comandos v3 de las secciones siguientes son el Modo avanzado, útil para CI, depuración y auditoría.

Modo	Shortcut (Codex: `$` en lugar de `/`)	Qué hace su playbook
`feature`	`/rapid-feature <objetivo>`	Plantilla de spec, baseline verificada al iniciar y bucle `next` → `check` → `finish`.
`bugfix`	`/rapid-bugfix <bug>`	Baseline antes del test rojo; `rapid check --expect fail` sobre `T001` registra la reproducción.
`refactor`	`/rapid-refactor <alcance>`	Baseline obligatoria; se bloquea si bajan los tests que pasan respecto a ella.
`hardening`	`/rapid-hardening <área>`	Worktree aislado con `rapid start --worktree`; `gate.review` dispensable.
`research`	`/rapid-research <tema>`	Spike sin tests obligatorios; los hallazgos se adjuntan con `rapid attach`.

Además existen /rapid-next, /rapid-status y /rapid-approve (este último no aprueba: te da el comando para tu terminal). Todo está en la guía de shortcuts.

Modos disponibles

RAPID OS soporta los siguientes cinco modos operativos canónicos:

Modo	Intención principal	Enfoque de contexto	Riesgo típico	Gates sugeridos
`feature`	Nueva funcionalidad o capacidad	Requisitos funcionales, contratos de API, estándares de diseño	`medium` (50) a `high` (80)	Baseline, tests unitarios/integración, peer review
`bugfix`	Corrección de defectos o regresiones	Caso de reproducción, código afectado, pruebas existentes	`low` (10) a `medium` (50)	Baseline, test de regresión, review
`refactor`	Mejora de estructura sin alterar comportamiento	Arquitectura, contratos de interfaz, suite completa de tests	`medium` (50) a `high` (80)	Baseline estricto, suite de tests sin cambios de API, peer review
`hardening`	Seguridad, robustez, observabilidad, dependencias	Vulnerabilidades, políticas de seguridad, dependencias	`high` (80) a `critical` (100)	Security review, auditoría estática, verificación aislada
`research`	Spikes exploratorios y prototipos de viabilidad	Contexto abierto, documentación técnica, pruebas de concepto	`low` (10) (`ExecutionClass.SPIKE`)	Gates mínimos o waiveables, no altera código crítico

Cómo influye el modo en los comandos de RAPID OS

1. En la compilación de contexto (`rapid context`)

Al invocar rapid context --mode <mode>, el compilador de contexto selecciona las secciones de estándares más pertinentes:

# Compilar contexto enfocado en una nueva funcionalidad
rapid context --mode feature --objective "Agregar autenticación OAuth2" --manifest

# Compilar contexto enfocado en endurecimiento de seguridad
rapid context --mode hardening --objective "Rotación de secrets y sanitización de inputs" --manifest

2. En la creación de la especificación (`rapid spec create`)

La especificación formal registra el modo para asegurar trazabilidad entre el diseño y la ejecución:

rapid spec create \
  --title "Migrar endpoint de checkout a v2" \
  --mode refactor \
  --objective "Reestructurar handlers desacoplando la capa de persistencia" \
  --scope "Servicio de pagos y controladores HTTP" \
  --acceptance "100% tests verdes sin modificar contratos externos" \
  --status ready

3. En la creación del run (`rapid run create`)

Al generar un run a partir de una spec, la política de ejecución evalúa el modo junto con las etiquetas (tags) y rutas afectadas para calcular la clase de ejecución:

rapid run create --spec checkout-v2 --harness codex

Siguiente paso

Empieza por la guía de shortcuts y explora la guía detallada de cada modo para comprender el flujo paso a paso y los tipos de evidencia requeridos:

Cada modo tiene su shortcut​

Modos disponibles​

Cómo influye el modo en los comandos de RAPID OS​

1. En la compilación de contexto (rapid context)​

2. En la creación de la especificación (rapid spec create)​

3. En la creación del run (rapid run create)​

Siguiente paso​