Communitygithub.com

perhapsspy/diseño-primero-el-propósito

Verifica que un diseño resuelva el problema correcto antes de codificar.

¿Qué es diseño-primero-el-propósito?

Este skill guía a un agente de IA o desarrollador para enfocarse en el propósito y las decisiones de diseño antes de implementar, evitando soluciones prematuras o innecesarias. Es útil para productos en etapas tempranas, planificación de implementación o decisiones donde la estructura no está fija. Funciona en cualquier plataforma que soporte SKILL.md (Claude Code, Cursor, etc.) y establece un contrato de decisión que separa insumos en bloqueados, evidencia, suposiciones y abiertos. El skill termina con una dirección provisional verificable o una pregunta bloqueante, y exige una reducción final para eliminar alcance o compromisos no requeridos por el propósito o las fronteras bloqueadas. Está diseñado para minimizar la ambigüedad, preservar la seguridad y asegurar que cada decisión tenga una base observable.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add perhapsspy/purpose-first-design

Preguntar en tu IA favorita

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

Documentación

Diseño Primero el Propósito

Trabajo y Salida

Elige la dirección más pequeña defendible para una decisión materialmente abierta de producto o planificación de implementación antes de que la estructura de solución esté fija. El propósito define lo que significa el éxito; las decisiones bloqueadas del usuario, la autoridad, y los límites requeridos de seguridad, reversión, propiedad y operaciones vinculan la respuesta y nunca son alternativas.

Termina con una dirección provisional, la verificación más pequeña que podría cambiar una elección realmente abierta, o una pregunta bloqueante. Si ninguna dirección material permanece abierta, dílo brevemente y entrega sin inventar alternativas.

Contrato de Decisión

  • Indica solo el propósito y el éxito observable necesario para distinguir la elección.
  • Separa los insumos relevantes para la decisión en LOCKED, EVIDENCE, ASSUMPTION y OPEN. Nunca promuevas una decisión bloqueada, una restricción explícita, un alcance rechazado o un ítem resuelto por evidencia a OPEN. Una verificación fallida puede cambiar solo un mecanismo no resuelto, no el significado bloqueado del producto.
  • Trata la implementación existente, el precedente, los valores por defecto y la urgencia como evidencia a menos que sean explícitamente autoritativos. Compara solo alternativas que cambien materialmente el significado, la responsabilidad, el estado persistente, la política, el ciclo de vida, el contrato público, el riesgo aceptado o el acoplamiento difícil de revertir.
  • Elige la dirección más pequeña suficiente. No agregues propietarios, procesos, mecanismos de reversión, plataformas, programas futuros o decisiones abiertas a menos que la fuente o la dirección elegida los requiera.

Entrega

Usa source-owner-audit primero cuando la autoridad presente sea desconocida. Entrega la realización resuelta—flujo de código, estado, secuenciación, interfaces, manejo de fallos y orden de implementación—a structure-first. Entrega la expresión resuelta y el empaquetado a tighten-docs.

Devuelve una entrega de decisión concisa: dirección, base de cambio de decisión, fronteras bloqueadas, suposiciones o decisiones abiertas reales, y la siguiente verificación decisiva o flujo de trabajo propietario. Incluye una frontera solo cuando restrinja la dirección elegida.

Reducción Final

Revisa solo el alcance, compromisos, suposiciones y decisiones abiertas introducidas por tu respuesta. Elimina cualquier elemento que el propósito, las fronteras bloqueadas, la autoridad, la evidencia o la dirección elegida no requieran. Fusiona alternativas solo cuando su significado de producto y las fronteras requeridas sean las mismas.

Esta pasada puede reducir pero no debe crear alcance, compromisos, suposiciones, decisiones abiertas ni entregas, y nunca debe reabrir el significado LOCKED. Si expone una frontera obligatoria faltante, indica esa frontera como requerida en lugar de opcional. Preserva la complejidad que sea necesaria para la seguridad, reversión, propiedad, operaciones o un modo de fallo demostrado.

Skills relacionados