Communitygithub.com

council

Reúne un consejo de cuatro voces para decisiones ambiguas, compensaciones y llamadas de sí/no. Úsalo cuando existan múltiples caminos viables y necesites desacuerdo estructurado antes de elegir.

¿Qué es council?

Esta skill, llamada 'Council', convoca un consejo de cuatro voces (Arquitecto, Escéptico, Pragmatista y Crítico) para ayudar a Claude a tomar decisiones bajo ambigüedad. Es útil cuando hay múltiples caminos viables y se necesita un desacuerdo estructurado y explícito antes de elegir, evitando el anclaje conversacional. Funciona en agentes como Claude Code, lanzando tres subagentes independientes (con solo la pregunta y contexto relevante) además de la posición inicial de Claude. El flujo incluye: extraer la pregunta real, formar primero la posición del Arquitecto, lanzar los tres subagentes en paralelo, sintetizar con barreras contra sesgos y presentar un veredicto compacto. No debe usarse para revisión de código, planificación de implementación o diseño de arquitectura. Al finalizar, solo persiste la decisión si cambia algo real, usando herramientas como knowledge-ops o guardando en el issue correspondiente.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/council

Preguntar en tu IA favorita

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

Documentación

¿Qué hace council?

Reúne cuatro asesores para decisiones ambiguas:

  • la voz de Claude en contexto
  • un subagente Escéptico
  • un subagente Pragmatista
  • un subagente Crítico

Esto es para toma de decisiones bajo ambigüedad, no para revisión de código, planificación de implementación o diseño de arquitectura.

Cuándo usarlo

Usa council cuando:

  • una decisión tiene múltiples caminos creíbles y ningún ganador obvio
  • necesitas hacer explícitas las compensaciones
  • el usuario pide segundas opiniones, disenso o perspectivas múltiples
  • el anclaje conversacional es un riesgo real
  • una llamada de sí/no se beneficiaría de un desafío adversarial

Ejemplos:

  • monorepo vs polirepo
  • enviar ahora vs esperar para pulir
  • feature flag vs despliegue completo
  • simplificar alcance vs mantener amplitud estratégica

Cuándo NO usarlo

En lugar de councilUsa
Verificar si la salida es correctasanta-method
Dividir una funcionalidad en pasos de implementaciónplanner
Diseñar arquitectura de sistemaarchitect
Revisar código en busca de errores o seguridadcode-reviewer o santa-method
Preguntas factuales directassimplemente responde directamente
Tareas de ejecución obviassimplemente haz la tarea

Roles

VozEnfoque
Arquitectocorrección, mantenibilidad, implicaciones a largo plazo
Escépticodesafío de premisas, simplificación, ruptura de supuestos
Pragmatistavelocidad de entrega, impacto en el usuario, realidad operativa
Críticocasos límite, riesgo de desventajas, modos de fallo

Las tres voces externas deben lanzarse como subagentes nuevos con solo la pregunta y el contexto relevante, no la conversación completa en curso. Ese es el mecanismo antianclaje.

Flujo de trabajo

1. Extraer la pregunta real

Reduce la decisión a una instrucción explícita:

  • ¿qué estamos decidiendo?
  • ¿qué restricciones importan?
  • ¿qué cuenta como éxito?

Si la pregunta es vaga, haz una pregunta aclaratoria antes de convocar al consejo.

2. Recopilar solo el contexto necesario

Si la decisión es específica del repositorio:

  • recopila los archivos, fragmentos, texto del issue o métricas relevantes
  • mantenlo compacto
  • incluye solo el contexto necesario para tomar la decisión

Si la decisión es estratégica/general:

  • omite fragmentos del repositorio a menos que cambien materialmente la respuesta

3. Formar primero la posición del Arquitecto

Antes de leer otras voces, escribe:

  • tu posición inicial
  • las tres razones más fuertes para ella
  • el riesgo principal en tu camino preferido

Haz esto primero para que la síntesis no simplemente refleje las voces externas.

4. Lanzar tres voces independientes en paralelo

Cada subagente recibe:

  • la pregunta de decisión
  • contexto compacto si es necesario
  • un rol estricto
  • sin historial de conversación innecesario

Forma de la instrucción:

Eres el [ROL] en un consejo de decisión de cuatro voces.

Pregunta:
[pregunta de decisión]

Contexto:
[solo los fragmentos o restricciones relevantes]

Responde con:
1. Posición — 1-2 oraciones
2. Razonamiento — 3 viñetas concisas
3. Riesgo — mayor riesgo en tu recomendación
4. Sorpresa — algo que las otras voces podrían pasar por alto

Sé directo. Sin rodeos. Mantenlo por debajo de 300 palabras.

Énfasis del rol:

  • Escéptico: desafía el encuadre, cuestiona supuestos, propón la alternativa creíble más simple
  • Pragmatista: optimiza por velocidad, simplicidad y ejecución en el mundo real
  • Crítico: saca a la luz el riesgo de desventajas, casos límite y razones por las que el plan podría fallar

5. Sintetizar con barreras contra sesgos

Eres tanto participante como sintetizador, así que usa estas reglas:

  • no descartes una visión externa sin explicar por qué
  • si una voz externa cambió tu recomendación, dilo explícitamente
  • incluye siempre el disenso más fuerte, incluso si lo rechazas
  • si dos voces se alinean contra tu posición inicial, trátalo como una señal real
  • mantén las posiciones originales visibles antes del veredicto

6. Presentar un veredicto compacto

Usa esta forma de salida:

## Council: [título corto de la decisión]

**Arquitecto:** [posición de 1-2 oraciones]
[1 línea sobre por qué]

**Escéptico:** [posición de 1-2 oraciones]
[1 línea sobre por qué]

**Pragmatista:** [posición de 1-2 oraciones]
[1 línea sobre por qué]

**Crítico:** [posición de 1-2 oraciones]
[1 línea sobre por qué]

### Veredicto
- **Consenso:** [dónde coinciden]
- **Disenso más fuerte:** [desacuerdo más importante]
- **Verificación de premisa:** [¿el Escéptico desafió la pregunta en sí?]
- **Recomendación:** [el camino sintetizado]

Mantenlo escaneable en una pantalla de teléfono.

Regla de persistencia

No escribas notas ad hoc en ~/.claude/notes u otras rutas sombra desde esta skill.

Si el consejo cambia materialmente la recomendación:

  • usa knowledge-ops para almacenar la lección en la ubicación duradera correcta
  • o usa /save-session si el resultado pertenece a la memoria de sesión
  • o actualiza el issue de GitHub / Linear directamente si la decisión cambia la verdad de ejecución activa

Solo persiste una decisión cuando cambia algo real.

Seguimiento de múltiples rondas

Por defecto es una ronda.

Si el usuario quiere otra ronda:

  • mantén la nueva pregunta enfocada
  • incluye el veredicto anterior solo si es necesario
  • mantén al Escéptico lo más limpio posible para preservar el valor antianclaje

Antipatrones

  • usar council para revisión de código
  • usar council cuando la tarea es solo trabajo de implementación
  • alimentar a los subagentes con la transcripción completa de la conversación
  • ocultar el desacuerdo en el veredicto final
  • persistir cada decisión como una nota independientemente de su importancia

Skills relacionadas

  • santa-method — verificación adversarial
  • knowledge-ops — persistir correctamente los deltas de decisión duraderos
  • search-first — recopilar material de referencia externo antes del consejo si es necesario
  • architecture-decision-records — formalizar el resultado cuando la decisión se convierte en política de sistema de larga duración

Ejemplo

Pregunta:

¿Deberíamos enviar ECC 2.0 como alpha ahora, o esperar hasta que la UI del plano de control esté más completa?

Forma probable del consejo:

  • Arquitecto presiona por integridad estructural y evitar una superficie confusa
  • Escéptico cuestiona si la UI es realmente el factor limitante
  • Pragmatista pregunta qué se puede enviar ahora sin dañar la confianza
  • Crítico se enfoca en la carga de soporte, deuda de expectativas y confusión del despliegue

El valor no es la unanimidad. El valor es hacer legible el desacuerdo antes de elegir.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

Skills relacionados