AjaneeI/agent-skills

Traduce una solicitud en un plan de ejecución autorizado de mínima complejidad, con requisitos explícitos, exclusiones, reglas de parada y criterios de aceptación. Úsalo antes de implementar una tarea de múltiples pasos o proponer nueva infraestructura de agente.

¿Qué es agent-skills?

Esta habilidad, denominada 'Constraints-First Execution' (Ejecución basada en restricciones), guía a los agentes de IA para que transformen solicitudes ambiguas o abiertas en planes de acción autorizados, explícitos y de complejidad mínima. Su propósito principal es evitar que los agentes sobreconstruyan, asuman permisos no otorgados o generen trabajo innecesario. Es útil para tareas de varios pasos, automatización o investigación, especialmente cuando se desea controlar costos, riesgos y alcance. La habilidad es independiente de la plataforma (funciona con Claude Code, Cursor, Codex, etc.) y se basa en un procedimiento de siete pasos que comienza con la redacción de un 'contrato', seguido de un cuestionamiento crítico de cada requisito, la eliminación de trabajo opcional, la simplificación de la arquitectura y la ordenación de tareas por dependencias. Finalmente, exige detenerse antes de escalar accesos, hacer compromisos de pago fuera del presupuesto, realizar cambios irreversibles o actuar sin permiso explícito. Su resultado es una tabla de requisitos a acciones con elementos obligatorios, opcionales y prohibidos, propietarios, dependencias y evidencias de finalización.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/AjaneeI/agent-skills/tree/HEAD/skills/constraints-first-execution

Documentación

Ejecución basada en restricciones

Cuándo usarlo

Úsalo al inicio de un nuevo flujo de implementación, automatización o investigación, especialmente cuando un agente podría sobreconstruir o asumir permisos no declarados.

Entradas requeridas

Objetivo, acciones autorizadas por el propietario, acciones prohibidas, capacidades existentes del sistema, evidencia de éxito, presupuesto de recursos y cualquier límite de aprobación externo. La autoridad desconocida no es permiso implícito.

Procedimiento

Redacta un breve contrato: objetivo, entregable dentro del alcance, no objetivos, acciones reversibles, restricciones inmutables y evidencia de finalización verificada.
Cuestiona si cada requisito es realmente necesario para el objetivo del usuario. No elimines en silencio requisitos explícitos del usuario.
Elimina el trabajo opcional que no mejore los criterios de aceptación nombrados. Mantén los controles de seguridad y calidad necesarios.
Simplifica la arquitectura propuesta antes de optimizarla. Prefiere herramientas existentes y flujos de trabajo directos en lugar de nuevos marcos.
Ordena las tareas restantes por dependencias y puertas de evidencia. Identifica la unidad reversible más pequeña que demuestre progreso.
Solo después de esta secuencia considera la aceleración, paralelización o automatización. Estima el costo y la complejidad de cada adición.
Haz que las preguntas de aprobación sean explícitas y acotadas. Si la autorización no está clara para un cambio material, conserva una propuesta en lugar de ejecutarla.

Detenerse o escalar

Detente antes de escalar accesos, compromisos de pago fuera del presupuesto, efectos irreversibles, cambios de metodología congelados o acciones fuera del permiso explícito. Nunca trates los objetivos de velocidad como anulación de las salvaguardas.

Entregable

Una tabla breve de requisitos a acciones con debe, puede, no debe, propietarios, dependencias y evidencia necesaria para considerar cada unidad completa. Usa la plantilla de contrato cuando la trazabilidad sea importante.

Aceptación

Cada tarea propuesta tiene una razón nombrada y una condición de evidencia; ninguna nueva dependencia o abstracción se justifica únicamente por posibles necesidades futuras.