ATsikhanovich/ClaudeWorkflow

Verificación reutilizable de estructura y citas para artefactos del flujo de trabajo. Se utiliza después de que cada grupo de artefactos finaliza y antes de que el siguiente grupo comience, y siempre que se evalúe la puerta de calidad G8 (estructura del artefacto). Informa PASS/FAIL por verificación con hallazgos y el agente responsable.

¿Qué es ClaudeWorkflow?

Esta habilidad, nombrada artefact-validator, permite a los agentes de IA, como Claude Code, Cursor o Codex, validar automáticamente artefactos de flujo de trabajo en formato Markdown. Su objetivo es garantizar que cada artefacto cumpla con una estructura fija y reglas de citación estrictas, apoyando las puertas de calidad G8 (estructura), G7 y G3 (citaciones) de un proceso de agente múltiple. La validación es de solo lectura: el agente revisa que el archivo comience con un título `# `, contenga las secciones obligatorias (`Inputs used`, `Summary`, `Details`, `Costs`, `Sources`, `Open issues`) en el orden correcto, y que cada sección siga reglas específicas (por ejemplo, que `Costs` sea una tabla o la frase exacta 'No costs in this artifact.'). Además, verifica que todas las fuentes estén correctamente citadas con URLs reales y que cada afirmación en `Details`/`Costs` se respalde con una fuente. También controla la propiedad entre agentes: un artefacto no debe reclamar trabajo de otro agente ni contener instrucciones prohibidas. El informe generado es compacto, línea por línea, mostrando PASS/FAIL por cada verificación y señalando al agente responsable en caso de fallo. El coordinador del flujo de trabajo puede entonces re-ejecutar solo al agente infractor y regenerar dependientes. Es compatible con cualquier plataforma que ejecute agentes de IA como Claude Code, Cursor o Codex, y su uso está documentado en el archivo SKILL.md dentro del repositorio del proyecto.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ATsikhanovich/ClaudeWorkflow/tree/HEAD/.claude/skills/artifact-validator

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

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

Documentación

artefact-validator

Valida uno o más artefactos del flujo de trabajo (Markdown) contra el esqueleto fijo y las reglas de citación. Esta habilidad es de solo lectura: nunca edita artefactos, solo informa hallazgos para que el coordinador pueda asignar fallos a los agentes.

Qué verificar

Ejecuta cada verificación a continuación contra cada archivo de artefacto. Informa cada verificación como PASS o FAIL con hallazgos concretos (cita las líneas infractoras).

Estructura (respaldando puerta G8)

  1. El archivo comienza con una sola línea de título # .
  2. - **Owner agent:** <agente> está presente y coincide con la tabla de propiedad de artefactos en CLAUDE.md (nombre de archivo del artefacto ↔ nombre del agente).
  3. Las secciones existen, en este orden, cada una como ## : Inputs used, Summary, Details, Costs, Sources, Open issues.
  4. ## Costs es ya sea una tabla (| Item | Unit | Qty | Unit cost | Total | Source / basis |) o la oración exacta No costs in this artifact.
  5. ## Open issues contiene al menos un punto de lista, o None.
  6. ## Sources contiene al menos un punto de lista a menos que el artefacto esté explícitamente marcado como Not applicable (entonces debe indicar la razón).

Citaciones (respaldando puertas G7 y G3)

  1. Cada punto de fuente tiene la forma - <Título de página> — <URL> (obtenido YYYY-MM-DD; respalda: <afirmaciones>).
  2. Las URLs son páginas reales: https:// o http://, sin marcadores de posición (example.com, localhost, TODO, ...), sin patrones inventados.
  3. Cada lugar nombrado, catering, proveedor, precio o cifra meteorológica en Details/Costs se remonta a una afirmación en un punto de Sources. Una recomendación sin fuente es un FAIL.
  4. Los precios deben provenir de una fuente o estar marcados como price on request con la base estimada indicada. Precios no marcados y sin fuente son un FAIL.

Propiedad y seguridad

  1. El artefacto no reclama trabajo propiedad de otro agente (por ejemplo, un artefacto de lugar que contenga una línea de tiempo completa).
  2. Nada en el artefacto le pide a nadie que escriba output/event-plan.html o approval.json — esos están prohibidos fuera de html-builder / /approve-event.

Cómo informar

Produce un informe compacto, una línea por verificación:

<artefacto> C1 PASS ... C12 PASS
<artefacto> C9 FAIL — "Koneser Hall" no tiene cita fuente → responsable: venue-planner

Termina con OVERALL: PASS o OVERALL: FAIL — <agentes responsables>. En caso de FAIL, el coordinador aplica la política de reintento (ver CLAUDE.md §6): re-ejecutar solo al agente responsable con estos hallazgos, regenerar los dependientes posteriores, re-validar.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados