jerlandson-supernova/hoq

Construye y lee una Casa de la Calidad (QFD) a través del servidor MCP hoq, en colaboración con una persona. Se usa cuando te piden ejecutar un QFD, una Casa de la Calidad, una matriz de necesidades frente a características, priorizar características frente a necesidades de los interesados, o verificar qué debe cumplir un producto. Las necesidades provienen de los interesados con sus propias palabras y con una fuente, la importancia la dan ellos, cada característica tiene una unidad, las celdas de la sala y los pares del techo son propuestas que la persona confirma, las puertas nunca se priorizan y el TSV con fecha es la versión oficial.

¿Qué es hoq?

Esta habilidad implementa un servidor MCP para construir y mantener una Casa de la Calidad (QFD, por sus siglas en inglés), una herramienta de planificación de la calidad que traduce las necesidades de los interesados en características de diseño medibles. Está diseñada para entornos de ingeniería de software donde un agente de IA (como Claude Code, Cursor o Codex) colabora con un humano para priorizar características, identificar compensaciones y gestionar la trazabilidad de requisitos. El servidor almacena una única casa en un archivo JSON y guarda los cambios inmediatamente, permitiendo que la persona pueda abrir el mismo archivo en una página web y seguir editando mientras el agente propone valores que quedan pendientes de confirmación. El proceso sigue ocho pasos ordenados: desde identificar interesados y sus necesidades, asignar importancia, definir características medibles (con unidades, dirección, objetivo y valor actual), rellenar la matriz de relaciones (con propuestas que el humano debe confirmar), establecer el techo de correlaciones entre características, evaluar el progreso por necesidad, generar informes y exportar la versión definitiva. La habilidad es especialmente útil para equipos de producto que necesitan un registro formal de decisiones de diseño, con reglas claras contra la invención de datos: las necesidades inventadas son peores que las faltantes, los números adivinados peores que los espacios en blanco, y toda importancia o valoración debe ir acompañada de quién la proporcionó (by) para mantener la trazabilidad. Además, soporta la importación de elementos desde herramientas de seguimiento (como tickets) y la generación de diagramas SVG, informes Markdown y hojas de cálculo Excel con fórmulas vivas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jerlandson-supernova/house-of-quality/tree/HEAD/skills/hoq

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Casa de la Calidad con el servidor MCP hoq

El servidor (node mcp/server.js --file house.json, de github.com/jerlandson-supernova/house-of-quality) contiene una única casa y la guarda tras cada cambio. La persona puede abrir el mismo archivo en la página web y seguir editando; las propuestas que tú hagas quedan allí esperando su confirmación.

La sesión, en orden

  1. ¿Quiénes son los interesados? Pregunta. Luego, por cada uno, qué necesitan, con sus propias palabras. need_set con need, source, short. Mantenlo en unas dieciséis necesidades como máximo. No inventes necesidades a partir de una descripción del producto.
  2. La importancia es de 1 a 5 y pertenece al interesado. Pregunta, luego need_set con importance y by (quién la dio). Nunca la adivines.
  3. Características: por cada necesidad, ¿qué se puede medir en el diseño que mostraría que se cumple? characteristic_set con una unit, una direction (↑ ↓ ◎), un target que un desconocido pudiera probar, y today según se mide. Sin unidad es un deseo, no una característica. Cualquier cosa que deba pasar antes del lanzamiento (seguridad, legal) lleva gate: true.
  4. La sala: por cada par, 9 si la característica decide si la necesidad se cumple, 3 para una influencia clara, 1 para alguna, en blanco en caso contrario. La mayoría de las celdas quedan en blanco. Propón con relationships_set_many, cada celda con una note de una línea y, donde la tengas, evidence. No cuentan hasta que la persona las confirma (proposal_confirm con su nombre, solo cuando ella lo haya dicho, o en la página). house_next clasifica las celdas vacías que merecen atención: necesidades que nada sirve, necesidades sin un conductor fuerte, características que no impulsan nada.
  5. El techo: pares de características que se ayudan (++, +) o se oponen (−, −−). roof_set propone. Cada compromiso es una decisión de alguien; di de quién.
  6. Hoy y objetivo por necesidad, de 1 a 5, mediante need_set con by.
  7. Léelo: house_validate (lee las filas y columnas vacías a la persona), house_priorities (las cinco principales, las puertas), house_diagonal (los bloques son los módulos; el veredicto de acoplamiento dice si existe un orden de construcción; los enlaces a cortar indican qué rediseñar), y con tickets items_import desde una exportación del rastreador (o item_set por ticket) luego house_items: qué puertas están claras, el siguiente paso abierto en la ruta crítica, dónde discrepan el tablero y las pruebas, qué está vencido, y la participación de cada elemento en la casa.
  8. Entrégalo: house_markdown es el informe para una persona; house_export como tsv con la fecha de hoy es la versión oficial; house_export como svg es una imagen; xlsx es el libro de trabajo con fórmulas vivas.

Reglas

  • Una necesidad que inventaste es peor que una necesidad faltante. Un número que adivinaste es peor que uno en blanco.
  • Di el razonamiento de una celda antes de proponerla; ponlo en note.
  • Importancia, hoy y objetivo: siempre con by. La procedencia es la pista de auditoría.
  • Una puerta mantiene su peso pero nunca se prioriza frente a una funcionalidad.
  • Un estado del tablero es una afirmación. Los estados provienen del rastreador (items_import); tested es uno de verified, partial, fails, not built, establecido solo a partir de evidencia que hayas visto, con retested como la fecha de esa prueba. Una importación nunca cambia un veredicto.
  • La página es para trabajar; el TSV con fecha es lo que la gente cita. Las ediciones en la página no llegan a nadie.

Si el servidor se ejecuta con --assist

assist_suggest pide a un modelo valores para las celdas en los huecos estructurales, assist_members extrae necesidades o características de un texto que la persona te da. Ambos devuelven solo propuestas, por el actor assist:<modelo>. Lee las razones del modelo a la persona antes de que confirmen; nunca confirmes una sugerencia del modelo tú mismo.

Herramientas de un vistazo

house_new · house_open · house_save · house_summary · house_get · house_validate · house_log · need_set · need_remove · characteristic_set · characteristic_remove · relationship_set · relationships_set_many · roof_set · propose · proposals_list · proposal_confirm · proposal_reject · house_next · item_set · items_import · item_remove · status_scale_set · house_report · house_markdown · house_priorities · house_diagonal · house_items · house_draw · house_export

Recursos: hoq://house, hoq://report, hoq://report.md, hoq://drawing.svg. Prompt: qfd_session.

Skills relacionados