Cuervo Engineering Operating System¶

Documentación de ingeniería de Cuervo. Estándares, decisiones, runbooks, seguridad, observabilidad y arquitectura.

Por dónde empezar¶

Tu primer día

Bootstrap local, primer PR, los 12 invariantes que enmarcan toda decisión.

Day 0 · Bootstrap Day 1 · Primer PR Tao de Cuervo
Responsable de servicio

Criterios de promoción, plantillas de runbook y threat model, política de ciclo de vida.

Lista de promoción Plantilla de runbook Política de ciclo de vida
Arquitecto · ARB

Decisiones, RFCs, Tech Radar, documentos de referencia, auditoría del stack.

ADRs RFCs Referencia
SRE · on-call

Respuesta a incidentes, rollback, postmortems, métricas DORA.

Respuesta a incidentes Rollback del wiki Plantilla de postmortem
Security champion

Línea base, threat models, supply chain, cumplimiento, gestión de secretos.

Línea base de seguridad Threat models Supply chain
Platform engineer

Plan de adopción, gobernanza, plataforma de conocimiento, panel de salud.

Operación del wiki Plan de adopción Plataforma de conocimiento

Arquitectura por capas¶

flowchart TB
  L7["L7 · Experience
Backstage Portal · TechDocs · Search"]
  L6["L6 · Knowledge
ADRs · RFCs · Runbooks · Postmortems · Tech Radar"]
  L5["L5 · Catalog
Components · APIs · Resources · Domains · Owners"]
  L4["L4 · Governance
OPA Policies · Decision Rights · Lifecycle Contract"]
  L3["L3 · Standards
Templates · Reusable Workflows · Linters · cv CLI"]
  L2["L2 · Automation
Repo Sync · Catalog Validator · Doc Bots · Release Bots"]
  L1["L1 · Telemetry
OpenTelemetry · DORA · DevEx · Compliance Evidence"]
  L0["L0 · Substrate
GitHub · Azure · AWS · ACR · OIDC Identity"]

  L7 --> L6 --> L5 --> L4 --> L3 --> L2 --> L1 --> L0

  classDef knowledge fill:#1e40af,stroke:#1e3a8a,color:#fff;
  classDef governance fill:#7c3aed,stroke:#5b21b6,color:#fff;
  classDef automation fill:#0891b2,stroke:#0e7490,color:#fff;
  classDef substrate fill:#374151,stroke:#1f2937,color:#fff;
  class L7,L6 knowledge;
  class L5,L4 governance;
  class L3,L2,L1 automation;
  class L0 substrate;

Detalle por capa en architecture/reference/.

Dónde vive este repositorio¶

Este repositorio es gobernanza y plan. La fuente operacional vive en cuervo-ai/cuervo-architecture y documenta lo que efectivamente corre hoy.

Mientras el equipo técnico tenga menos de cuatro personas o no haya un primer cliente con requisitos de auditoría externa, cuervo-architecture es canon. CEOS es el marco que adoptamos cuando no adoptarlo empieza a doler.

Contrato de frontera: ADR-0011 · relation-to-cuervo-architecture.md.

Estado medido¶

make doctor reporta el estado del meta-repositorio. Última lectura: 16 / 100, dominado por la ausencia de catalog-info.yaml en sub-repositorios. Cierre de brechas en _meta/gap-closure.md.

Búsqueda de texto completo con ⌘+K o Ctrl+K.

Convenciones editoriales¶

Esta documentación sigue un style guide explícito: español como idioma primario, anglicismos técnicos canónicos preservados, tono directo, ortografía verificada.