OFOps / Arquitectura
De un problema claro a un sistema que puedes operar.
Decisiones prácticas, guías de proyecto y comprobación de evidencias — para personas y sus agentes.
Elige una guía y completa el primer control con evidencias.
↗02Tomar una decisión técnicaCompara compromisos, restricciones y señales de cambio.
↗03Conectar tu agenteUsa la biblioteca mediante un plugin nativo de Sites o una copia local.
↗Biblioteca creada y mantenida con agentes de IA. Las personas son responsables de la revisión y publicación.
Propuesta · requiere revisión humana · r3
Elegir → construir → verificar → operar → revisar
Una biblioteca de trabajo para toda la vida del software: desde la primera definición del problema hasta la operación fiable, la migración y la retirada. Las personas son responsables de la intención y el riesgo. Los agentes convierten decisiones acotadas en cambios probados. El inglés es la versión canónica; checo, alemán y español mantienen los mismos identificadores y revisiones de las guías.
Esta biblioteca es, en sí misma, un sistema de decisiones mantenido por agentes: los agentes de IA investigan, redactan, traducen y verifican; las personas son responsables de la aplicabilidad, la revisión de derechos, la fusión de cambios y la publicación. Las recomendaciones son propuestas contextualizadas, no reglas certificadas universalmente. Las explicaciones de ingeniería son una síntesis original; los documentos citados conservan sus propias licencias y no se reproducen como contenido nuestro.
Tengo un proyecto: ¿por dónde empiezo?
Usa esta biblioteca para dar al agente una tarea clara, elegir un enfoque adecuado y revisar el resultado. Proporciona recomendaciones, un plan y comprobaciones de evidencias. Tu agente construye el producto real en tu entorno de desarrollo.
- Lee cómo adoptar la biblioteca: elige el perfil de entrega JSON para las herramientas y, si lo necesitas, un documento YAML para decisiones más detalladas.
- Sigue tu primer punto de control con evidencias: crea un resultado real, solicita su revisión y comprueba qué sigue bloqueado. No se necesita una API de modelos.
- Elige tu proyecto a continuación y sigue el flujo de entrega.
| ¿Qué estás construyendo? | Empieza aquí |
|---|---|
| Sitio web público | Sitio web público |
| SaaS | SaaS |
| Herramienta interna de operaciones | Herramienta interna |
| Aplicación de IA | Aplicación de IA |
| Automatización de agentes | Automatización de agentes |
| Backend y clientes móviles | Backend móvil |
Asigna al agente su primera tarea
Sustituye los valores entre corchetes y entrega este texto a un agente que pueda leer tu proyecto y una copia local confiable de esta biblioteca. No es necesario instalar un plugin ni MCP.
Trabaja en [proyecto de destino]. Usa [copia local de BestPractices] como referencia.
Lee las instrucciones del proyecto de destino y después, en la biblioteca,
plugins/bestpractices/skills/project-delivery/SKILL.md y la guía del tipo de proyecto correspondiente.
Resultado: [resultado observable]. Restricciones: [datos, presupuesto, efectos permitidos].
Registra la revisión de la biblioteca. Crea un perfil de entrega JSON con los
requisitos reales y la revisión Git de destino; deja explícitos los datos desconocidos.
Ejecuta el planificador y aborda el primer punto de control sin completar. Produce
su artefacto real, realiza una comprobación pertinente y obtén una revisión independiente
cuando esté disponible.
No inventes resultados ni revisores. Informa de las evidencias y los bloqueos pendientes.
Trabaja en local; no despliegues ni modifiques la biblioteca de referencia.
Un punto de control exige determinados resultados. Un artefacto es un documento, un cambio de código o un informe. Las evidencias describen una inspección o prueba real de ese resultado. Crear un plan no implementa el proyecto ni autoriza una publicación. Para conocer lo que se demuestra en local y lo que aún necesita pruebas específicas del proyecto, consulta cobertura y límites.
Leer según la necesidad
Las guías de arquitectura y alojamiento ayudan a elegir una forma del sistema. Durabilidad, datos, seguridad y frontend explican los contratos dentro de esa forma. GitHub, calidad y agentes rigen la entrega. Operación y mantenimiento conservan la salud tanto de los productos como de esta biblioteca.
Para verificar, empieza por la selección de pruebas. Distingue el propósito, el nivel y el conocimiento disponible para quien prueba; caja negra no significa únicamente pruebas de penetración. Usa las pruebas de rendimiento para experimentos de carga, estrés, picos, duración prolongada y capacidad, y las pruebas de seguridad para controles basados en riesgo y evaluaciones acotadas. Cada guía ofrece a los agentes criterios de selección, requisitos de evidencia y condiciones de parada.
Cada guía identifica el contexto aplicable, una decisión, sus compensaciones, las comprobaciones y las señales de cambio. Obtener una fuente demuestra que está disponible, no que una recomendación sea correcta. Esta edición inicial contiene propuestas pendientes de revisión humana; las traducciones también necesitan revisión editorial. Las integraciones experimentales del navegador siguen identificadas explícitamente como experimentales.
Usa el menú de idiomas para cambiar de lengua, la búsqueda para encontrar un concepto y las guías relacionadas para seguir sus consecuencias. Clona el repositorio para leer sin conexión; el sitio web y el adaptador MCP de solo lectura usan el mismo contenido. No se necesita una API de modelos de pago para leer, compilar o validar la biblioteca.
Decisiones relacionadas
Principios de decisión · El ciclo de vida completo · Elegir y conectar arquitecturas · Adoptar la biblioteca en un proyecto