Tu agente, con contexto.Cada cambio, con evidencia.
Gobernanza de ingeniería para tus agentes de IA. Elimina el code slop, protege tu arquitectura y garantiza que ningún modelo modifique código sin contratos formales ni evidencia ejecutable.
Construye con claridad. Comprueba con evidencia.Build with clarity. Verify with evidence.
PREPARAR PROYECTO 1 / 3─────────────────────────────────────────────────────────────────¿Dónde usarás OmniSpec?
Destino: C:\dev\LaboratorioSpringBootBancov2
No se detectaron archivos de aplicación. Definirás el producto y las tecnologías con tu agente.
> [x] Antigravity
[ ] Claude Code
[ ] Codex
[ ] Cursor
[ ] VS Code / GitHub Copilot
[ ] Kilo
[ ] OpenCode
[ ] Gemini CLI
[ ] Otra herramienta / aún sin elegir
Arriba/Abajo: mover | Espacio: marcar | Enter: seguir
PREPARE PROJECT 1 / 3─────────────────────────────────────────────────────────────────Where will you use OmniSpec?
Target: C:\dev\LaboratorioSpringBootBancov2
No application files detected. You will define product and technologies with your agent.
> [x] Antigravity
[ ] Claude Code
[ ] Codex
[ ] Cursor
[ ] VS Code / GitHub Copilot
[ ] Kilo
[ ] OpenCode
[ ] Gemini CLI
[ ] Another tool / not chosen yet
Up/Down: move | Space: toggle | Enter: continue
Construye con claridad. Comprueba con evidencia.Build with clarity. Verify with evidence.
PREPARAR PROYECTO 2 / 3─────────────────────────────────────────────────────────────────Detectado plugin global de Antigravity. ¿Cómo deseas configurarlo?
El plugin global ya está instalado en tu máquina.
> Modo Proyecto: Instalar skills locales en .agents/skills (Recomendado para equipos)
Modo Plugin: Usar plugin instalado (sin generar nuevas skills locales)
Arriba/Abajo: mover | Enter: elegir | Esc: cancelar
PREPARE PROJECT 2 / 3─────────────────────────────────────────────────────────────────Global Antigravity plugin detected. How do you wish to configure it?
Global plugin is already installed on your machine.
> Project Mode: Install local skills in .agents/skills (Recommended for teams)
Plugin Mode: Use installed plugin (without generating new local skills)
Up/Down: move | Enter: select | Esc: cancel
Construye con claridad. Comprueba con evidencia.Build with clarity. Verify with evidence.
PREPARAR PROYECTO 3 / 3─────────────────────────────────────────────────────────────────¿Preparar OmniSpec en esta carpeta?
Destino: C:\dev\LaboratorioSpringBootBancov2
No se detectaron archivos de aplicación. Definirás el producto y las tecnologías con tu agente.
Integraciones seleccionadas: antigravity> Preparar proyecto
Cancelar
Arriba/Abajo: mover | Enter: elegir | Esc: cancelar
PREPARE PROJECT 3 / 3─────────────────────────────────────────────────────────────────Prepare OmniSpec in this directory?
Target: C:\dev\LaboratorioSpringBootBancov2
No application files detected. You will define product and technologies with your agent.
Selected integrations: antigravity> Prepare project
Cancel
Up/Down: move | Enter: select | Esc: cancel
Construye con claridad. Comprueba con evidencia.Build with clarity. Verify with evidence.
Instalando archivos...[OK] Archivos preparados. Comprobando integridad...
[OK] Integridad comprobada.
[OK] Los archivos de OmniSpec están preparados - 0.8.0
INSTALACIÓN─────────────────────────────────────────────────────────────────
Destino: C:\dev\LaboratorioSpringBootBancov2[OK] Integridad de archivos administrados y versión del runtime local comprobadas.
[OK] omni-auditor: .agents/agents/omni-auditor.mdSIGUIENTE PASO─────────────────────────────────────────────────────────────────
Siguiente paso: abre esta misma carpeta en tu herramienta de IA e inicia su chat.
antigravity: /omni-init
Después explica qué quieres construir. El agente aclarará el objetivo, las decisiones pendientes
y un primer resultado verificable.
Local CLI: node specs/.omni/runtime/bin/omni-spec.mjs status
Installing files...[OK] Files prepared. Checking integrity...
[OK] Integrity verified.
[OK] OmniSpec files are ready - 0.8.0
INSTALLATION─────────────────────────────────────────────────────────────────
Target: C:\dev\LaboratorioSpringBootBancov2[OK] Managed files and local runtime version verified.
[OK] omni-auditor: .agents/agents/omni-auditor.mdNEXT STEP─────────────────────────────────────────────────────────────────
Next step: open this folder in your AI coding tool and start its chat.
antigravity: /omni-init
Then describe what you want to build. The agent will clarify the goal, pending decisions
and a first verifiable outcome.
Local CLI: node specs/.omni/runtime/bin/omni-spec.mjs status
EXPLORER: LABORATORIOSPRINGBOOTBANCOV2
▾LaboratorioSpringBootBancov2ListoReady
▾📁.agents
▾📁agents
📄omni-auditor.mdsubagente auditorauditor subagent
▾📁skills
📁omni-init/
📁omni-discuss/
📁omni-specify/
📁omni-plan/
📁omni-tasks/
📁omni-impl/
📁omni-verify/
▾📁specs
📁_templates/
📁.omni/runtime
📁commands/
📄manifest.lock
📄.gitignore
📄manifest.jsonversiónversion
📄project-context.mdmemoriamemory
📄README.md
📄AGENTS.mddirectivasdirectives
📄CONSTITUTION.mdleyes de ingenieríaengineering laws
# CONSTITUTION — LaboratorioSpringBootBancov2> Directivas de ingeniería inviolables para agentes de IA.1. Cirugía de Código (Minimal Touch):
Modificar exclusivamente los archivos asignados a la tarea.
Prohibido reescribir o reformatear módulos adyacentes.
2. Fail-Fast Estricto:
Prohibido envolver lógica en bloques defensivos try/catch
que traguen excepciones o retornen null silenciosamente.
3. Cero Comentarios Loro:
Prohibido agregar comentarios que solo parafraseen sintaxis.
El código debe ser autoexplicativo y limpio.
# CONSTITUTION — LaboratorioSpringBootBancov2> Non-negotiable engineering directives for AI coding agents.1. Minimal Touch Surgery:
Modify exclusively the files assigned to the task.
Never rewrite or reformat adjacent working modules.
2. Strict Fail-Fast:
Never wrap logic in defensive try/catch blocks
that swallow exceptions or silently return dummy nulls.
3. Zero Parrot Comments:
Never add comments that merely narrate code syntax.
Code must be self-explanatory with clean naming.
# Project Context — LaboratorioSpringBootBancov2> Memoria arquitectónica destilada del repositorio (MDD).## Stack Detectado
- Lenguaje / Framework: Spring Boot 3.x (Java 21)
- Arquitectura: Hexagonal / Domain-Driven Design (DDD)
- Base de Datos: PostgreSQL + JPA / Flyway
- Quality Gates: ./mvnw clean test (JUnit 5 + AssertJ)
## Directivas del Repositorio
- Convención de Commits: Conventional Commits 1.0.0
- Documentación: Javadoc obligatorio en contratos de dominio.
# Project Context — LaboratorioSpringBootBancov2> Distilled architectural memory of the repository (MDD).## Detected Stack
- Language / Framework: Spring Boot 3.x (Java 21)
- Architecture: Hexagonal / Domain-Driven Design (DDD)
- Database: PostgreSQL + JPA / Flyway
- Quality Gates: ./mvnw clean test (JUnit 5 + AssertJ)
## Repository Invariants
- Commit Convention: Conventional Commits 1.0.0 (in English)
- Documentation Standard: Javadoc mandatory on domain interfaces.
El Bucle Completo
¿Qué le ordena cada Skill a la IA?
Las 9 skills forman una cadena de montaje determinista dividida en 3 etapas. Cada comando impone restricciones y prohibiciones estrictas para que el agente nunca alucine ni modifique código no autorizado.
Formalizar una solicitud en un tipo de trabajo (feature, bugfix, debt o rfc).
Instrucción clave / Prohibición
"Evalúa el triaje ceremonial (omni-spec fit). Redacta criterios de aceptación obligatorios bajo sintaxis formal EARS (AC-01 [functional]). Define explícitamente lo que está FUERA de alcance (Non-Goals) para evitar desviaciones."
Un pago, una historia clínica o un permiso requieren revisiones distintas. Elige un perfil y úsalo para acordar qué controles aplican a tu proyecto.
Fintech & PagosFintech & Payments
Idempotencia · Datos · TrazabilidadIdempotency · Data · Traceability
Controles de Fintech & Pagos para revisar y adaptar con el agente. El perfil no impone un stack ni certifica cumplimiento.Controls for Fintech & Payments to review and adapt with the agent. A profile does not impose a stack or certify compliance.
Comando de inicialización:npx omni-spec init --profile fintech
Controles e invariantes del proyectoProject invariants & controls
Revisar riesgos de cobros y operaciones repetidas
Determinar alcance de datos financieros y acceso
Elegir controles y pruebas relevantes al producto
Review payment risks and repeated operations
Determine financial data and access boundaries
Choose controls and tests relevant to the product
Healthtech & SaludHealthtech & Health
Privacidad · Datos de salud · AlcancePrivacy · Health data · Scope
Controles de Healthtech & Salud para revisar y adaptar con el agente. El perfil no impone un stack ni certifica cumplimiento.Controls for Healthtech & Health to review and adapt with the agent. A profile does not impose a stack or certify compliance.
Comando de inicialización:npx omni-spec init --profile healthtech
Controles e invariantes del proyectoProject invariants & controls
Identificar datos sensibles y actores con acceso
Revisar obligaciones aplicables y trazabilidad
Separar controles declarados de cumplimiento comprobado
Identify sensitive data and actors with access
Review applicable obligations and traceability
Separate declared controls from demonstrated compliance
Controles de E-Commerce para revisar y adaptar con el agente. El perfil no impone un stack ni certifica cumplimiento.Controls for E-Commerce to review and adapt with the agent. A profile does not impose a stack or certify compliance.
Comando de inicialización:npx omni-spec init --profile ecommerce
Controles e invariantes del proyectoProject invariants & controls
Controles de BPO & Workplace para revisar y adaptar con el agente. El perfil no impone un stack ni certifica cumplimiento.Controls for BPO & Workplace to review and adapt with the agent. A profile does not impose a stack or certify compliance.
Comando de inicialización:npx omni-spec init --profile bpo
Controles e invariantes del proyectoProject invariants & controls
Revisar qué datos personales necesita el producto
Acordar acceso y finalidad de métricas agregadas
Evaluar reidentificación y privacidad según contexto
Controles de General Software para revisar y adaptar con el agente. El perfil no impone un stack ni certifica cumplimiento.Controls for General Software to review and adapt with the agent. A profile does not impose a stack or certify compliance.
Comando de inicialización:npx omni-spec init --profile general
Controles e invariantes del proyectoProject invariants & controls
Conservar decisiones y convenciones del proyecto
Acordar cambios acotados antes de implementar
Configurar comprobaciones pertinentes y registrar resultados
Preserve project decisions and conventions
Agree on bounded changes before implementation
Configure relevant checks and record results
Son controles para revisar con el agente, no certificaciones ni arquitecturas obligatorias.
La instalación prepara archivos; no ejecuta los scripts de tu aplicación. El descubrimiento de skills depende de la versión de tu herramienta.
Antes de empezar
Lo que conviene tener claro.
¿OmniSpec sustituye a mi agente de IA?+
Tu agente sigue conversando contigo y modificando el código. OmniSpec añade instrucciones, contexto y especificaciones al repositorio, y un CLI para gestionar el trabajo y su evidencia.
¿Tengo que usar los nueve flujos en cada cambio?+
El trabajo se adapta al alcance, riesgo e incertidumbre. Hay rutas ligera, estándar y completa; un cambio pequeño puede necesitar menos artefactos. El agente revisa qué corresponde al caso.
¿Sirve para un proyecto que ya existe?+
Sí. Instala en la raíz y abre omni-init con tu agente. El onboarding reconoce los archivos, tecnologías y decisiones existentes. Revisa los cambios de instalación en Git como cualquier otro cambio.
¿Qué significa que el CLI sea local?+
El CLI trabaja en el sistema de archivos y no incorpora telemetría ni servidores propios. npm descarga el paquete. Tu proveedor de IA y los checks que autorices pueden utilizar red según su configuración.
¿Un trabajo completado garantiza que todo funciona?+
El cierre exige criterios cubiertos y verificación vigente. La relevancia de las pruebas, el contenido de la evidencia y el resultado real siguen necesitando revisión. No equivale a una certificación ni a ausencia de errores.
¿Cuál es la versión oficial actual?+
La versión oficial estable es 0.8.1 y se instala directamente con `npx omni-spec init` desde el canal latest. El canal @preview se reserva para candidatas y pruebas antes de cada lanzamiento.
¿Puedo usar mis propias skills o herramientas (MCP) junto con OmniSpec?+
Sí, con total normalidad. OmniSpec no monopoliza ni bloquea el entorno de tu agente; convive en paralelo. Las skills de OmniSpec (/omni-*) se encargan de la gobernanza, especificación y trazabilidad en el repositorio (specs/), mientras que tus otras skills o servidores MCP (para diseño, testing, base de datos, accesibilidad o terminal) siguen operando en la misma sesión para enriquecer el trabajo.
