@event4u/agent-config

Agent Config — cada afirmación verificada por máquina, incluidos los recuentos en estas insignias

_{Cómo se cuentan — un contador canónico, agent-config → update_counts --check, re-deriva los seis a partir del árbol y falla en CI ante una desviación de uno. Dos bases no son lo que muestra el directorio enlazado, por lo que se indican aquí en lugar de dejarlas a la inferencia: Comandos 202 cuenta cada archivo de comando de forma recursiva (el directorio enlazado contiene 61 en su nivel superior), y Reglas 121 cuenta las reglas fuente mientras que la proyección enlazada contiene 120 — una regla está inactiva y no se proyecta. Personas 29 excluye el README del directorio. Los recuentos son de archivos y directorios: ninguno mide calidad, activación o adopción.}

Pruébalo en 30 segundos — coloca un subagente de solo lectura en cualquier repositorio y observa cómo controla el "hecho": @production-validator check this branch is actually done. Sin asistentes, sin bloqueo, sin instalar nada más — la cuña de 30 segundos ↓ es todo el primer paso. Comienza por la prueba, no por el catálogo: event4u-app.github.io/agent-config/proof/.

Cada afirmación pública en este README está verificada por máquina — verifícalo tú mismo. En un mercado que se basa en cifras destacadas sin respaldo, este vincula cada afirmación a evidencia resoluble o falla en su propia compilación.

Elige tu experiencia — desarrollador · fundador · contenido · agencia · finanzas · operaciones. Añade paquetes. Obtén un conjunto de comandos enfocado, no un volcado de 500 artefactos. Trae tu propio proveedor de IA.

Una biblioteca profunda de habilidades, comandos y reglas gobernadas — además de un enrutador de capacidades que carga la habilidad correcta según la intención y orquestación multi-agente con revisión por consenso. Toda la capa se compila en 20 agentes anfitriones — de 23 detectados, 3 son solo exportación (Claude Code, Cursor, Augment, Cline, Windsurf, Copilot, Gemini CLI, Codex, Continue, Zed, JetBrains, Aider y más). Los procesos residentes solo se permiten bajo el contrato de supervisión que establece ADR-249 — una política que este repositorio adoptó el 2026-08-27, no una descripción de nada que se ejecute hoy. Seis rutas de entrada con forma de rol se sitúan encima, de modo que cualquier anfitrión se convierte en un miembro confiable del equipo — sin bloquearte a un solo modelo o proveedor.

Pruébalo en 30 segundos

Prueba una cosa en 30 segundos — antes de la suite completa, coloca un único subagente autocontenido y observa la disciplina en tu propio repositorio:

mkdir -p .claude/agents
curl -fsSL https://raw.githubusercontent.com/event4u-app/agent-config/main/docs/wedge/production-validator/production-validator.md \
  -o .claude/agents/production-validator.md
# then in Claude Code:  @production-validator check this branch is actually done

production-validator es de solo lectura y no instala nada más — controla el "hecho" buscando mocks/stubs en la ruta enviada y exigiendo evidencia del sistema real (qué hace). ¿Te gusta? La suite completa se instala con un comando — Inicio rápido ↓.

---

Qué lo hace diferente

Profundo y disciplinado, y honesto sobre lo que deliberadamente no es:

• Profundidad que se enruta sola — un enrutador de capacidades carga la habilidad correcta según la intención, no un volcado de contexto de 500 artefactos.
• Gobernanza en cada anfitrión — reglas compiladas en el formato nativo de cada herramienta en el momento de la proyección; ganchos de ejecución deterministas añadidos en anfitriones con capacidad de ganchos. Esta gobernanza agnóstica del espacio de configuración es la ventaja clave (la ventaja de gobernanza · aplicación por anfitrión).
• Desinstalación quirúrgica — elimina solo sus propias claves de una configuración de anfitrión compartida (coincidencia por JSON-pointer + SHA-256), nunca las entradas de una herramienta vecina.
• Instalación por paquete — escribe solo el paquete activo, no un volcado de 500 artefactos.

Lo que deliberadamente no es — el núcleo es una capa de gobernanza con motores integrados opcionales y de aceptación individual (inteligencia de código, alcance restringido, la GUI de configuración, el laboratorio de pruebas — ADR-124): sin demonio obligatorio o siempre activo, sin base de datos de estado separada, sin memoria que se reescribe sola, sin pipeline de compilación automática. Los motores nunca son obligatorios, nunca activados por defecto sin mejora medida, y terminan con el comando que los invocó. El agente anfitrión ejecuta el bucle; cada cambio aprendido es revisado por humanos; la misma capa permanece portable entre herramientas. Capacidad sin un proceso que cuidar.

De dónde viene esto (procedencia honesta). Las habilidades, reglas y personas se destilan de trabajo de producción real en bases de código TypeScript y PHP. La mecánica de gobernanza es agnóstica de la pila, pero las heurísticas de dominio son más ricas donde se forjaron — trata la cobertura en otras pilas como prometedora, no probada, y dinos dónde se queda corta.

Consulta exactamente qué funciona en qué anfitrión o salta a cosas que puedes hacer en un minuto.

Elige tu perfil — seis rutas de entrada

agent-config setup escribe profile.id en .agent-settings.yml y te envía a la primera pantalla de ese perfil. Cada página de experiencia incluye el detalle completo — para quién es, primeros comandos y habilidades, paquetes y flujos, y qué está deliberadamente no cargado.

Perfil	Audiencia	Página de experiencia
👩‍💻 developer	Ingeniero IC	página
✍️ content_creator	Escritores, redactores fantasma, especialistas en marketing	página
🚀 founder	Fundador en solitario / etapa temprana	página
🏛 agency	Agencia de entrega multi-cliente	página
💼 finance	CFO / finanzas fraccionadas / FP&A	página
🛡 ops	RevOps, soporte, afín a SRE	página

¿No estás seguro de cuál? El asistente hace una única pregunta de rol con 8 opciones y mapea al perfil más cercano. Fuente de verdad src/agent-src/profiles/ · esquema docs/contracts/profile-system.md · más allá del software user-types/ (galabau · metalistería · camiones — consulta Más allá del software).

Flujos de trabajo, no comandos crudos

No memorizas comandos — ejecutas un viaje de trabajo. Cuatro flujos abarcan la historia del desarrollador de principio a fin:

Flujo	Comienza con	El viaje
🔍 Descubrimiento	/feature:plan · /research	explorar → planificar → estimar → refinar, antes de construir
🔨 Implementación	/work · /implement-ticket	planificar → implementar → verificar → confirmar
🔎 Revisión	/review-changes · /judge	auto-revisión → juzgar → corregir calidad → modelar amenazas
🚢 Entrega	/commit · /pr:create	confirmar en fragmentos → abrir PR → responder revisión

Habilidades compuestas y la ruta canónica por flujo: docs/flows.md.

CHANGELOG · Actualizar a 14.x · Cambios disruptivos · Última versión · Discusiones

_{Distribución: npm install @event4u/agent-config. Los incrementos mayores siguen semver; cada uno incluye una entrada ### Breaking — todos los mayores indexados en BREAKING_CHANGES.md.}

---

Paquete Creativo — video AI cinematográfico. guion → imagen con personaje bloqueado → prompt de movimiento+audio → render del proveedor → clip cosido, con AIV_DRYRUN=true como el valor predeterminado de seguridad de costos. Una capacidad de primera clase dentro de la experiencia contenido / creador — ya no es el titular del paquete. Consulta /video:from-script.

Paquete Legal — no es asesoramiento legal. El paquete legal UE/DE (revisión de contrato/NDA/DPA, triaje) es solo una ayuda de investigación y redacción — no proporciona asesoramiento legal, no reemplaza a un abogado calificado y no debe usarse como base para ningún asunto concreto. Produce información general y plantillas generales, nunca examen de casos individuales. Lee LEGAL_NOTICE.md antes de usarlo.

Catálogo completo — cada habilidad, regla, comando, directriz: docs/catalog.md. El titular es la experiencia (perfil + paquetes) y la profundidad detrás de ella.

Úsalo en tu proyecto

Ejecuta desde un repositorio de consumo — arranca mediante npx, el agente detecta tu pila y entregas trabajo de principio a fin. ¿Instalación nueva? Comienza con el Inicio rápido. ¿Ya instalado? Herramientas compatibles muestra las IA conectadas; docs/featured-commands.md enumera los flujos de trabajo de extremo a extremo (/implement-ticket, /work, /commit, /pr:create). Recorrido más profundo: demo de 2 minutos.

Alcance de instalación. Elige un alcance por máquina — local al proyecto (predeterminado, recomendado para repositorios de aplicaciones) o global al usuario (recomendado para repositorios de herramientas / dotfiles). El instalador rechaza un segundo alcance conflictivo mediante la verificación previa scope_guard. Detalles: docs/contracts/install-scopes.md. Limpieza cuando sea necesario: bash src/scripts/cleanup_other_scope.sh --confirm.

Pruébalo

No tomes las afirmaciones por confianza — verifícalas. docs/proof.md se genera a partir de la fuente: una tabla de afirmación→evidencia (cada afirmación pública se vincula a un puntero resoluble o CI falla), benchmarks honestos de nulos incluyendo las ejecuciones donde el paquete no cambió nada, y un bloque "verifícalo tú mismo" que ejecutas en un checkout nuevo. Falla en CI si se desvía de sus fuentes — la reproducibilidad es la prueba. Léelo en event4u-app.github.io/agent-config/proof/, con el marco de comparación en docs/us-vs-the-category.md. Fila medida más reciente: en una sesión posterior a la corrección, la inyección de contexto de asesoría redujo las violaciones de espejo de lenguaje 555 → 19 mientras que los dos bloqueos de guardia pasaron de 8 → 0 y 1 → 0 — la asesoría se redujo masivamente, solo el bloqueo se eliminó. Una sesión y una lectura posterior, por lo que es un antecedente registrado, no una ley.

¿Mantienes tu propio catálogo de habilidades? La puerta anti-reskin que bloquea los PR de re-skin por buscar-y-reemplazar aquí también funciona en el tuyo — docs/anti-reskin-gate.md.

Disciplina de auditoría por construcción — cada consulta de memoria, clave de decisión y preocupación de gancho termina en agents/runtime/state/ para que puedas reproducirlo. Principios fundamentales nombra los cuatro invariantes.

Contribuye

¿Trabajas en el paquete en sí? Desarrollo cubre el pipeline task ci, Requisitos la cadena de herramientas, Telemetría de mantenedor el bucle de medición opcional. El árbol fuente de verdad es src/ (src/skills, src/rules, src/agent-src/); nunca edites a mano .augment/ o dist/agent-src/.

Seguridad. Política de divulgación: SECURITY.md. Modelo de amenazas: docs/threat-model.md.

---

Inicio rápido

Un comando. Impulsado por detección — tus herramientas de IA instaladas se encuentran y preseleccionan. Nada se escribe hasta que haces clic en Finalizar. Sin YAML a mano.

Esos cuatro son estructurales — propiedades de la ruta de código, no de tu máquina. Cuánto tiempo toma no lo es: eso está dominado por la latencia de red y registro. CI mide el tiempo de pared de instalación → doctor en cada ejecución general y lo publica con sus condiciones, como evidencia en lugar de una promesa.

# 1. Install — on a terminal with a display, the browser wizard launches
#    automatically; the same TypeScript installer runs the real install behind it.
npx -y @event4u/agent-config init

# 2. Pick your profile + tools in the wizard, click Finish.
#    (Writes ~/.event4u/agent-config/, ~/.claude/, ~/.cursor/, …)

# 3. First real task — agent refines, plans, verifies.
/work "your first real task"

Headless / CI: init omite la GUI en CI, en un entorno sin TTY, en un host sin interfaz gráfica, o con cualquier flag de modo CLI, y ejecuta el instalador no interactivo en su lugar. La GUI y la CLI comparten un único instalador (src/scripts/install.ts), por lo que ambos producen resultados idénticos. Flags, el conjunto completo de exclusión y --dry-run: docs/wizard.md · gui-wizard § Cuando se omite la GUI.

Elegir IAs específicas: --tools=claude-code,cursor,augment,… (cualquier subconjunto). --gui fuerza el selector vinculado a loopback y protegido por CSRF más allá de las comprobaciones de TTY y headless; no anula CI, AGENT_CONFIG_NO_UI ni un flag de modo CLI, y combinarlo con uno de estos termina con código de salida distinto de cero en lugar de ejecutar silenciosamente la instalación CLI.

Verificar cobertura de hooks: npx @event4u/agent-config hooks:status (--strict para CI, --format json para tooling).

Alcance (v2.5+): init escribe solo a nivel global — ~/.event4u/agent-config/, ~/.claude/, ~/.cursor/, …. El árbol del proyecto recibe únicamente agents/overrides/. --project es solo para mantenedores, detrás de AGENT_CONFIG_DEV_MODE=1 (ADR-020, modo dev).

¿Migrando desde v1.x? npx @event4u/agent-config migrate — docs/migration/v1-to-v2.md.

---

Qué es agent-config — y qué no es

Una capa de contenido — skills, reglas, comandos, directrices, personas — distribuida vía npm y proyectada en el formato de configuración nativo de cada herramienta de IA compatible. Sigue el estándar abierto Agent Skills.

No es un runtime de agente. El bucle del agente, el despachador de LLM y la orquestación de herramientas permanecen en la herramienta anfitriona (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI, Copilot). Piénsalo como un manual de juego y una guía de estilo para esas herramientas — no un reemplazo.

En alcance	Fuera de alcance
Skills, reglas, comandos, directrices, personas	Bucle del agente / despachador de LLM
Proyección multi-herramienta + pipeline de condensación	Motor de ejecución dentro del paquete
Ayudas de memoria (memory-add, memory-promote)	Panel de observabilidad entre herramientas
Linters, CI, validación de frontmatter contra JSON-Schema (contrato)	GUI de runtime / panel web
Orquestación de skills vía citas + helpers deterministas	Resolvedor de skills automático opinado (ranking ML / relevancia que decide por ti)
Filtrado en tiempo de proyección dirigido por el usuario mediante perfiles + packs (ADR-040)	Un resolvedor / daemon de runtime (cambio a mitad de sesión — condicional, post-6.0.0)

Qué se le pide a tu agente

Comportamiento predeterminado	Con agent-config
Adivinar y editar a ciegas	Analizar el código antes de cambiarlo
Desviarse de las convenciones del proyecto	Seguir las convenciones de stack detectadas
Omitir o inventar tests	Escribir tests en el framework del proyecto
Mensajes de commit genéricos	Conventional Commits con alcance + enlaces a tickets
Omitir comprobaciones de calidad	Ejecutar el pipeline de calidad del proyecto y corregir errores reportados
Abrir PRs sin contexto	Descripciones de PR estructuradas desde Jira / Linear / GitHub
Afirmar "hecho" sin pruebas	Verificar con ejecución real antes de afirmar que está hecho

---

Demo de 2 minutos — /implement-ticket

El comando insignia. Conduce un ticket de principio a fin a través de un flujo lineal fijo — y se detiene ante la ambigüedad en lugar de adivinar.

/implement-ticket PROJ-123

El agente ejecuta esta secuencia:

refine → memory → analyze → plan → implement → test → verify → report

• Refina el ticket si los criterios de aceptación son vagos.
• Consulta la memoria para decisiones pasadas, invariantes, incidentes.
• Planifica el cambio; tú confirmas antes de tocar cualquier archivo.
• Implementa bajo minimal-safe-diff + scope-control — sin ediciones al paso.
• Prueba (dirigido primero, suite completa si tiene éxito).
• Revisa el diff a través de cuatro jueces (bugs, seguridad, tests, calidad de código).
• Reporta cambios, veredictos, seguimientos — y luego se detiene. /commit y /pr:create son sugerencias, nunca se ejecutan automáticamente.

Cualquier ambigüedad detiene el flujo con opciones numeradas — nunca una suposición silenciosa. La persona proviene de .agent-settings.yml (roles.active_role): senior-engineer (predeterminado), qa o advisory (solo plan).

→ Referencia de comandos · Contrato de flujo

Comando hermano — /work (prompt de forma libre)

Mismo motor, sin necesidad de ticket:

/work add a CSV export endpoint to the audit-log controller

La primera pasada puntúa el prompt en cinco dimensiones y enruta según la banda:

Banda	Puntuación	Acción
alta	≥ 0.8	Proceder en silencio — AC + suposiciones en el informe
media	0.5–0.79	Se detiene con informe de suposiciones; confirmar o editar
baja	< 0.5	Se detiene con una pregunta aclaratoria sobre la dimensión más débil

Después de la compuerta de banda, el flujo es idéntico a /implement-ticket. Objetivo de forma libre → /work; payload de ticket → /implement-ticket.

→ Referencia de comandos · skill refine-prompt

Después de la ejecución: agent-config explain last reconstruye el rastro (ruta · memoria · consejo · detenciones · proveedor) — solo lectura, sin PII, sin conexión. Docs

Pista de UI de producto

El trabajo con forma de UI se enruta a uno de tres conjuntos de directivas — ui (auditoría completa→diseño→aplicar→revisar→pulir→reportar), ui-trivial (≤ 1 archivo, ≤ 5 líneas: aplicar→probar→reportar), mixed (backend + UI: contrato→ui→unir). La auditoría de UI existente es una compuerta dura (ui-audit-gate); el pulido tiene un límite de 2 rondas con prioridad de a11y. Detección de stack → blade-livewire-flux / react-shadcn / vue / plain.

→ Modelo mental (1 página) · Contrato de flujo

---

Personalizar

Perfiles — cuánta gobernanza se carga

El piso de seguridad (defaults no destructivos · preguntar antes de adivinar · reflejar el idioma del usuario) se incluye en todos los perfiles. Lo que cambia es cuánto coaching adicional se incorpora.

Perfil	Qué obtienes	Cuándo elegirlo
minimal	Solo el piso de seguridad no negociable. Más barato, más rápido.	Preguntas rápidas · scripts desechables · CI · presupuestos de tokens ajustados
balanced (predeterminado)	Piso de seguridad + coaching cotidiano (defaults sensatos, avisos de revisión, errores comunes).	Trabajo diario
full	Todo, incluidas reglas de cola larga que normalmente solo necesitan los mantenedores.	Trabajando en agent-config en sí · auditorías · demos de máxima fidelidad

Bajo el capó: solo kernel · kernel + tier-1 · kernel + tier-1 + tier-2. Detalles: rule-router · kernel-membership · Configurar →.

Estabilidad: STABILITY.md para la matriz completa. Work Engine (/work + /implement-ticket): beta. Runtime Dispatcher: estable. Tool Adapters: experimental (solo perfil full).

.agent-user.md y Ghostwriter — primitivas de voz

Primitiva	Voz	Divulgación
personas/*.md	Lente de revisión (crítica interna)	n/a
.agent-user.md (raíz del proyecto, gitignored)	La propia voz del mantenedor — /post-as:me	Ninguna (tú eres el autor)
agents/reference/ghostwriter/<slug>.md (gitignored)	Figura pública documentada — /post-as:ghostwriter	Pie de página obligatorio, no removible

Crea el archivo de usuario interactivamente: /agents user init (esquema). Clúster de Ghostwriter: /ghostwriter:fetch <url-or-name> ejecuta una compuerta de atestación; individuos privados rechazados; contenido de pago / filtrado / DM prohibido a nivel de esquema.

MCP autoalojado en Cloudflare — cero instalación local

Skills, comandos, reglas y directrices pueden servirse como endpoint MCP desde tu propio Cloudflare Worker, accesible por HTTP desde cualquier cliente MCP. Dos modos de autenticación: public (predeterminado) y bearer-auth (opt-in del operador, secreto MCP-Token de Wrangler).

task mcp:cloud:login         # one-time, opens browser
task mcp:cloud:setup         # check → r2-create → r2-verify → whoami
task mcp:cloud:secret-put    # opt in to bearer-auth (recommended for private deploys)

→ Guía del operador: mcp-cloud-setup · Config por cliente: mcp-client-config · Endpoints: mcp-cloud-endpoints.

Alcance — Lite, no Full. El Worker sirve gobernanza de solo lectura (skills · comandos · reglas · directrices · contextos) como prompts y recursos MCP, además de pequeñas herramientas de solo lectura (memory_lookup, chat_history_read, list_*). No ejecuta los scripts locales del repositorio (linters, auditorías, task ci, hooks del work-engine) — esos requieren instalación local según Quickstart.

El servidor local stdio integrado está listado en el Glama MCP Registry — requiere un checkout local, no una instalación llave en mano (ADR-067).

Postura de despliegue

Forma	Estado	Ruta
Espacio de trabajo de un solo usuario	✅ hoy	npx @event4u/agent-config init — una máquina, un usuario; sin sincronización remota
Equipo pequeño (3–10 personas)	✅ hoy	Repo Git compartido agents/overrides/ + NAS compartido para conocimiento — sin cambio de código, sin nuevo servidor. Receta: docs/deploy/small-team-recipe.md
Modo organización (SSO · política central · contexto de equipo · conectores internos)	⏸ no iniciado	Cada forma condicionada a un cliente reclutado + auditoría financiada + ADR del mantenedor. Racional de postura: docs/deploy/team-deployment-posture.md

Las características del modo organización (SSO, política central, conectores OAuth, contexto de equipo) permanecen canceladas por diseño hasta que un cliente reclutado y una auditoría de seguridad financiada las levanten; la receta de equipo pequeño es la ruta soportada mientras tanto. Cada una es una fila de cancelación estable en team-deployment-posture.

---

Expectativas del harness

Tres clases de comportamiento de instalación/runtime parecen bugs del paquete y son comportamiento del harness anfitrión que el paquete no puede controlar: namespaces de plugins hermanos, herramientas diferidas expuestas vía ToolSearch, y deriva de skills entre alcances. Diagnósticos y la respuesta del paquete: docs/contracts/harness-expectations.md. Cuando un skill aparece dos veces, comienza con task probe:skills.

Herramientas soportadas

Instaladas en el proyecto (npx)

Herramienta	Reglas	Skills	Comandos	Cómo funciona
Claude Code	✅	✅	✅	Lee .claude/
Cursor	✅	—	☑️	Lee .cursor/rules/ + comandos vía AGENTS.md
Cline	✅	—	☑️	Lee .clinerules/ + comandos vía AGENTS.md
Windsurf	✅	—	☑️	Lee .windsurfrules + comandos vía AGENTS.md
Gemini CLI	✅	—	☑️	Lee GEMINI.md
GitHub Copilot	✅	—	☑️	Lee .github/copilot-instructions.md
Roo Code	✅	—	☑️	Auto-descubre .roo/rules/*.md + AGENTS.md
Codex CLI	✅	—	☑️	Auto-descubre AGENTS.md
Continue.dev	✅	—	☑️	Auto-descubre .continue/rules/*.md + AGENTS.md
Aider	📌	—	—	read: manual en .aider.conf.yml
Augment (VSCode/IntelliJ)	📌	—	—	Solo global; el proyecto escribe marcador
Claude Desktop	📌	—	—	Solo global

✅ nativo   ☑️ referencia de texto (en AGENTS.md, no invocable como comando slash nativo)   📌 solo marcador   — no disponible

Reproducibilidad de equipo: cada herramienta que init se registra en agents/installed-tools.lock (commiteado, gestionado por máquina). Los nuevos miembros del equipo ejecutan npx @event4u/agent-config sync después de clonar; CI controla la deriva con agent-config validate. Esquema: installed-tools-manifest.

Instaladas como plugin (opcional, global)

Herramienta	Instalación
Augment CLI · Copilot CLI	Instalar → — reglas + skills + comandos, actualizado vía marketplace

Claude Code: el plugin de marketplace está deprecado (modelo de superficie única). La proyección de archivos npx/npm ahora lleva contenido y los hooks deterministas (registrados en un bloque gestionado ~/.claude/settings.json por agent-config global / upgrade), por lo que el plugin solo duplica los listados de skills/comandos mientras su snapshot de git-SHA se pudre silenciosamente. Instalaciones existentes: claude plugin uninstall agent-config@event4u-agent-config — agent-config doctor marca la superficie duplicada. Mantén la instalación global actualizada con agent-config upgrade (última versión) o agent-config refresh --global (reinstalación de la misma versión); agent-config doctor marca un binario ausente de PATH o un cableado de hooks roto. Consulta getting-started § Mantenerse actualizado · Solución de problemas.

La superficie de comandos de un vistazo

Comando	Qué hace
agent-config init	Instalación de una sola vez: abre el asistente del navegador (ruta recomendada o paso a paso)
agent-config init --project	Inicializa un proyecto: puente agents/ mínimo + bloque .gitignore gestionado
agent-config config	Abre la GUI de configuración: centro de ajustes global (niveles simple y avanzado, búsqueda, restablecer a valores predeterminados)
agent-config config --project	Abre la superficie de configuración del proyecto
agent-config setup	Vuelve a ejecutar el asistente de incorporación guiado (prellenado desde tu estado actual)
agent-config upgrade	Actualiza la instalación global a la última versión + sincroniza ajustes de forma aditiva
agent-config doctor	Informe de salud/deriva de solo lectura

Superficies de agentes en la nube / alojados

Para plataformas donde los scripts del paquete no pueden ejecutarse, los artefactos se generan para pegar o subir:

• Linear AI (Codegen, Charlie, …) — dist/linear/{workspace,team,personal}.md
• Claude.ai Web Skills — dist/cloud/<skill>.zip

→ Instalar →

---

Funciona con agent-switch

agent-switch es el CLI complementario para ejecutar varias cuentas de agente en una sola máquina: aísla cada cuenta en su propio perfil (CLAUDE_CONFIG_DIR por perfil), por lo que cambiar de cuenta nunca implica cerrar sesión y volver a iniciarla. Los dos se componen: agent-switch aísla las cuentas, agent-config gobierna lo que los agentes hacen dentro de ellas. Cuando agent-config se ejecuta bajo un perfil de agent-switch, lo indica en el centro de ajustes, advierte antes de escrituras que aterrizarían en un árbol compartido (entre perfiles), y acepta una raíz de configuración proporcionada por el host para que sus propios ajustes permanezcan limitados al perfil.

→ Cómo se componen los dos →

---

Para quién es esto

Un núcleo de gobernanza independiente de la pila (orquestación · modos de rol · clústeres de comandos · puertas de calidad · disciplina de auditoría), más conjuntos de habilidades específicos de la pila:

Pila	Cobertura
Laravel · PHP moderno (más profundo)	Pest · PHPStan · Rector · ECS · Eloquent · Livewire/Flux · Horizon · Pulse · Reverb · Pennant
Symfony	symfony-workflow (DI · Doctrine · Messenger · voters · Twig) + análisis de proyectos
Next.js App Router	nextjs-patterns (RSC · Server Actions · almacenamiento en caché · route handlers) + UI react-shadcn
Zend / Laminas	análisis de proyectos + habilidades compartidas de PHP coder/quality
React · Node / Express	análisis de proyectos + UI react-shadcn
Vue · HTML plano	conjunto de directivas de UI (vue / plain)
Multi-pila	diseño de API · pruebas · seguridad · base de datos · Docker · Git · CI · revisión · modelado de amenazas · observabilidad

Más allá del software

El mismo núcleo de orquestación impulsa oficios no relacionados con software a través de user-types/: galabau-field-crew · metalworking-shop · truck-driver. Contribuye con el tuyo: andamiaje de 5 minutos.

---

Gobernanza de datos y seguridad de dominio

Tres reglas de seguridad de dominio (domain-safety-pii, domain-safety-disclaimer, domain-safety-retention) actúan como pisos de salida por dominio en ~12 áreas: redacción de PII (soporte / finanzas / reclutamiento / marketing), avisos de asesoramiento (legal / financiero / médico / consultoría), orientación de retención (finanzas / soporte), pisos operativos (registro / exportación). Matriz completa de superficie → regla → piso: docs/safety.md. Contratos beta: memory-visibility-v1 · decision-trace-v1.

Procedencia de código y gobernanza de licencias

Cada diff se verifica contra una política de licencia derivada de la licencia detectada del propio repositorio objetivo (ordenada por precedencia; si las fuentes discrepan → escalar, nunca adivinar) y un linter estricto sobre nuestro libro de préstamos (provenance/borrows.jsonl → docs/THIRD-PARTY-NOTICES.md) que falla ante una clase denegada o licencia desconocida, una nota de transformación faltante, o una redactada solo como cambio de nombre — conectado a ci/ci-strict. license-compliance-audit ejecuta un escaneo de similitud bajo demanda, invocado por un humano y nunca por un pipeline. Esto es disciplina de préstamo gobernada por procedencia con un rastro auditado — no un detector de copias.

Alcance y límites

• La reproducción inconsciente de datos de entrenamiento no es detectable en esta capa. Ninguna herramienta aquí — ni en ningún lugar — puede ver qué contenía los datos de entrenamiento de un modelo; este sistema gobierna lo que se toma prestado conscientemente y se registra, nunca lo que un modelo recuerda silenciosamente.
• La detección, donde existe, cubre una base de conocimiento de OSS conocido solamente — un subconjunto de todo el código que ha existido, nunca el corpus de entrenamiento de un modelo.
• No existe una puerta de detección orientada a CI. Se construyó un escáner determinista (jscpd offline + SCANOSS en línea) y se midió contra un corpus sintético congelado, pero no alcanzó sus propios umbrales preregistrados (medido: recall 12/16, falsos positivos 2/12, recall de solo cambio de nombre de SCANOSS 0/8) — ver docs/CLAIMS.md. Se distribuye en ninguna forma en CI, ni siquiera como asesoramiento — solo como la habilidad bajo demanda anterior.
• El lavado de solo cambio de nombre no se detecta por nada de lo que distribuimos o evaluamos. La verificación de nota de transformación del libro rechaza una nota redactada solo como cambio de nombre, pero no puede atrapar una copia de solo cambio de nombre no divulgada que nunca se registró.

Reduce y documenta el riesgo — nunca lo elimina.

Telemetría de mantenedores (opt-in, desactivada por defecto)

Registro de interacción con artefactos solo local. Establece telemetry.artifact_engagement.enabled: true en .agent-settings.yml. Registra qué habilidades / reglas / comandos / directrices consulta el agente durante /implement-ticket / /work. JSONL bajo la raíz del proyecto, nada se sube. Informes: npx @event4u/agent-config telemetry:report.

Sugerencia de comandos consciente del contexto

Cuando un prompt coincide con el propósito de un comando ("setze ticket ABC-123 um" → /implement-ticket), el agente muestra coincidencias como opciones numeradas — nada se ejecuta automáticamente. Desactivación por conversación: /command-suggestion-off. Ajustes: commands.suggestion.{enabled,blocklist,confidence_floor} en .agent-settings.yml.

---

Principios fundamentales

• Analizar antes de implementar — sin adivinanzas, sin ediciones a ciegas
• Verificar con ejecución real — sin "debería funcionar"
• Desafiar para mejorar — los agentes son socios de pensamiento, no máquinas de decir sí
• Estricto por diseño — calidad sobre flexibilidad
• Runtime gobernado — los procesos residentes requieren supervisión, escrituras limitadas y un control de detención

---

Documentación

Documento	Contenido
Primeros pasos	Primera ejecución, experiencia de 3 pruebas, perfiles, siguientes pasos
Instalación	Todas las rutas de instalación, Composer/npm, detalles del orquestador
Arquitectura	Capas del sistema, pipeline de contenido, matriz de soporte de herramientas
Personalización	Anulaciones, AGENTS.md, ajustes de agente, perfiles de costo
Calidad y CI	Linting, pipeline de CI, sistema de condensación
Migración	Pasos de actualización por versión
Showcase	Más ejemplos y comportamiento esperado

Explora el contenido: todos los comandos · catálogo de habilidades · catálogo completo · llms.txt.

---

Solución de problemas

Primera parada para cualquier problema de instalación: agent-config doctor — marca un binario ausente de PATH, desviación de versión binario↔plugin, huérfanos obsoletos y problemas de manifiesto, cada uno con una pista de corrección de una línea.

Para preguntas de "¿por qué no se activó la regla/hook X?": agent-config routing:doctor — un diagnóstico en vivo de solo lectura que informa cada puerta de inicio de sesión como ACTIVA/INACTIVA con la razón propia de la preocupación (p. ej. session-canary: ACTIVE for "Alex" vs INACTIVA — sin nombre en ninguna capa de ajustes), la cadena de preocupaciones de la plataforma, el registro de hooks del host, y la frescura del router y la proyección. Internals más profundos de hooks (postura fail-open/closed, último comentario del despachador por preocupación): agent-config hooks:doctor.

Síntomas de actualización y obsolescencia — un comando o habilidad que falta después de una actualización, habilidades que aparecen dos veces, una actualización interrumpida, command not found, archivos de proyecto obsoletos: docs/troubleshooting.md § Actualización y obsolescencia.

---

Desarrollo

¿Trabajando en el paquete en sí? Edita src/ (la fuente de verdad — src/skills, src/rules, src/agent-src/), regenera los árboles:

task sync             # regenerate dist/agent-src/ and .augment/
task generate-tools   # regenerate .claude/, .cursor/, .clinerules/, .windsurfrules
task ci               # full pipeline — green before PR
task test             # unit + integration tests
task dev:setup        # boot the onboarding wizard against the working tree

Invocar el CLI desde un checkout de la fuente: ./agent-config <command> (el shim de mantenedor en la raíz del repositorio → scripts/agent-config → dist/cli/agent-config.js). npx @event4u/agent-config no se resuelve en el repositorio fuente sin un npm link previo, ya que no hay un enlace simbólico node_modules/.bin/agent-config — usa ./agent-config en su lugar. Compila el binario TS con npm run build:cli si dist/cli/agent-config.js falta.

→ Estructura completa del proyecto y comandos: docs/development.md · CONTRIBUTING.md. Pila: TypeScript en todo — CLI, UI y los scripts de compilación / lint. Los payloads del registro MCP se renderizan bajo dist/mcp/ (lista de verificación de envío).

---

Requisitos

• Node ≥ 20.11 — npx @event4u/agent-config init es la ruta de instalación canónica. Sin Python en ningún lugar de la ruta de instalación (el instalador de Python se retiró con la migración a TypeScript).
• Plataforma: macOS 12.3+, Linux, WSL2. Git Bash necesita Developer Mode para enlaces simbólicos. Los contribuyentes que reconstruyan .augment/ también necesitan Task.

Windows

PowerShell / cmd nativo no es compatible para la instalación de archivos — usa WSL2 para el árbol instalado completo. La superficie nativa de Windows compatible es el servidor MCP stdio: apunta cualquier cliente MCP a

npx -y @event4u/agent-config mcp-server

y el contenido de gobernanza (prompts, recursos, herramientas) está disponible sin la instalación de archivos. Portar el despachador bash a Windows nativo está condicionado a la demanda: un adoptante de Windows nombrado que no pueda usar WSL2 o la ruta MCP lo reabre (ver agents/roadmaps/ — road-to-credible-install Fase 3).

Financiación

El paquete es gratuito, MIT, y seguirá siéndolo — sin nivel de pago, sin doble licencia. Si te ahorra tiempo y quieres contribuir, el botón de GitHub Sponsor en la parte superior del repositorio es todo el mecanismo. Si prefieres no hacerlo, úsalo de todos modos; nada aquí está condicionado a ello.

Licencia

MIT.

mcp-name: io.github.event4u-app/agent-config