Communitygithub.com

andresnator/agents-orchestrator

Creador de Registros de Decisiones de Arquitectura (ADR) concisos que explican una decisión, el contexto que la motivó, las opciones consideradas y las consecuencias aceptadas.

¿Qué es agents-orchestrator?

Este skill permite a un agente de IA (como Claude Code, Cursor o Codex) crear Registros de Decisión de Arquitectura (ADR) formales y estructurados. Es especialmente útil para equipos de desarrollo que necesitan documentar decisiones técnicas o arquitectónicas de manera rigurosa, asegurando que quede registro del contexto, las opciones evaluadas y las consecuencias aceptadas. El skill funciona en modo entrevista: hace una pregunta a la vez (en el idioma del usuario) para recopilar la información necesaria de forma dependiente (título, contexto, opción elegida, alternativas con pros/contras, consecuencias). Una vez completada la recolección, genera el ADR siguiendo una plantilla Markdown predefinida. Soporta dos estados: 'Accepted' (decisión ya tomada) y 'Proposed' (propuesta en evaluación). Por defecto, entrega el ADR como un bloque de código Markdown sin crear archivos, a menos que el usuario solicite explícitamente una ruta de archivo. También mantiene un contador dinámico de preguntas restantes, sugiere respuestas de ejemplo y desafía constructivamente respuestas vagas o contradictorias antes de redactar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add andresnator/agents-orchestrator

Preguntar en tu IA favorita

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

Documentación

Creador de ADR

Crea Registros de Decisión de Arquitectura (ADR) concisos que explican una decisión, el contexto que la motivó, las opciones consideradas y las consecuencias aceptadas.

Contrato de Activación

Usa este skill cuando el usuario solicite un ADR, registro de decisión de arquitectura, registro de decisión técnica, o cualquier registro formal de por qué se tomó una elección técnica o arquitectónica.

Por defecto, usa el modo entrevista a menos que el usuario ya haya proporcionado suficiente información para redactar un ADR completo. Haz las preguntas de la entrevista en el idioma del usuario. El artefacto del ADR debe estar en inglés, a menos que el usuario solicite explícitamente otro idioma.

Reglas Estrictas

  • Haz una sola pregunta a la vez en modo entrevista.
  • Indica una vez al inicio de la entrevista que el usuario puede omitir preguntas o detener la entrevista en cualquier momento.
  • Mantén un contador dinámico de preguntas restantes estimadas; actualízalo cuando aparezcan o desaparezcan dependencias.
  • Recomienda respuestas de ejemplo breves cuando ayuden al usuario a responder.
  • Formatea las preguntas de la entrevista como Markdown legible, no como texto plano.
  • Desafía constructivamente respuestas vagas, contradictorias o sin fundamento antes de redactar; continúa si el usuario dice explícitamente que sigas de todos modos.
  • No inventes alternativas, pros, contras o fundamentos. Pregunta cuando falten alternativas.
  • Usa Accepted cuando la decisión ya esté tomada; usa Proposed para propuestas, evaluaciones o estado incierto.
  • Escribe o modifica archivos solo cuando el usuario lo solicite explícitamente (archivo/ruta).

Flujo de Entrevista

Recopila solo lo necesario, primero las dependencias:

  1. Título y estado de la decisión.
  2. Contexto: problema, restricciones, fuerzas y por qué la decisión es importante ahora.
  3. Opción elegida o propuesta.
  4. Opciones consideradas, con pros y contras de cada una.
  5. Consecuencias: beneficios, desventajas, riesgos y compensaciones.
  6. Seguimiento solo cuando haya acciones abiertas útiles o preguntas sin resolver.

Formato de pregunta:

### Pregunta N — [pregunta enfocada]

**Respuesta recomendada:** [ejemplo breve cuando sea útil]

**Por qué es importante:** [razón breve]

**Preguntas restantes estimadas:** ~M

Mini ejemplo:

### Pregunta 1 — ¿Esta decisión ya está tomada o todavía está en propuesta?

**Respuesta recomendada:** "Aceptada — ya elegimos PostgreSQL para los datos de facturación."

**Por qué es importante:** El estado cambia si el ADR registra una decisión final o una propuesta bajo revisión.

**Preguntas restantes estimadas:** ~5

Contrato de Salida

Lee assets/template-markdown.md antes de redactar y completa esa estructura.

Por defecto, devuelve el ADR final como exactamente un bloque de código Markdown y no crees archivos. Si el usuario solicitó explícitamente un archivo/ruta, guarda el ADR allí y resume la ruta guardada en el chat.

Nunca dejes instrucciones de marcador de posición en el ADR final. Si el usuario omite intencionalmente un detalle requerido, usa TBD con moderación y solo para ese detalle omitido.

Referencia

  • Plantilla: assets/template-markdown.md

Skills relacionados