Desarrollo con IA

Guía interna hiberus

La IA ha acelerado y democratizado el desarrollo de software. Eso no garantiza por sí solo mejores productos: también puede acelerar ambigüedades, defectos, retrabajo y decisiones poco trazables.

Nuestra propuesta es usar la IA para aumentar la calidad del producto. Para conseguirlo construimos un arnés de trabajo: agentes, specs, skills, MCPs, instrucciones, contexto, memoria, guardarraíles y gates que hacen el proceso más predecible, revisable y orientado a evidencias.

SDD es la implementación actual de ese arnés. Puede evolucionar, pero el principio se mantiene: la calidad no se valida solo al final, se diseña desde la especificación y se protege durante todo el ciclo.

Calidad desde la specAgentes especialistasContexto y memoriaGuardarraílesRevisión IA + humanaGates antes de QA

IA calidad

Specs

Fuente de verdad para requisitos, criterios, riesgos y plan ejecutable.

Agentes

Spec Author, Implementer y Reviewer separan intención, construcción y revisión.

Contexto

Instrucciones, memoria y convenciones reducen interpretación y deriva.

Guardarraíles

Design System, accesibilidad, privacidad, analítica, traducciones y arquitectura.

Gates

Revisión IA, revisión humana, checks y evidencias antes de QA o merge.

Para quién es

La guía está pensada principalmente para perfiles técnicos que van a aplicar el arnés en proyectos reales. También debe ser legible para responsables técnicos, perfiles de gestión o perfiles mixtos que necesiten entender por qué la metodología mejora calidad, predictibilidad y eficiencia.

Por eso cada sección intenta responder a tres preguntas:

• Qué es esta pieza.
• Por qué importa dentro del flujo.
• Cómo se usa de forma práctica.

Recorrido recomendado

Si llegas por primera vez, sigue este camino. Está ordenado para pasar de la tesis de calidad a la operación diaria del arnés.

1

Necesidad

La petición se convierte en una especificación validable.

2

Spec

Criterios, riesgos, impacto y tareas reducen ambigüedad desde el inicio.

3

Agentes

Spec Author, Implementer y Reviewer trabajan con responsabilidades separadas.

4

Guardarraíles

Contexto, DS, arquitectura, accesibilidad, privacidad y checks guían el desarrollo.

5

Gate

Revisión IA, revisión humana y evidencias protegen la calidad antes de QA o merge.

Qué problema resuelve

Trabajar con IA sin arnés suele producir resultados irregulares: mucho impulso inicial, poca trazabilidad, decisiones implícitas, contexto contaminado y validación insuficiente.

La metodología propone:

• Reducir ambigüedad desde la especificación.
• Usar agentes especialistas para separar responsabilidades.
• Construir con contexto imprescindible y límites explícitos.
• Introducir guardarraíles de calidad durante el desarrollo.
• Revisar contra spec antes de que el defecto llegue a QA.
• Convertir velocidad en consecuencia de un proceso más controlado.

Cómo usar esta web

Usa el menú lateral como mapa principal. La navegación interna está pensada para aprender y aplicar la metodología en proyectos reales.

El modo documentación es el modo por defecto. Para sesiones con clientes, usa la ruta Presentación cliente, que resume el discurso comercial sin entrar en herramientas concretas.

Idea central: más IA no implica automáticamente más calidad. El arnés convierte la IA en un sistema de trabajo con criterios, evidencias y puntos de control.