ATsikhanovich/ClaudeWorkflow

Verificação reutilizável de estrutura e citações para artefatos do workflow. Use após cada grupo de artefatos ser concluído e antes do próximo grupo começar, e sempre que a gate de qualidade G8 (estrutura do artefato) for avaliada. Relata PASS/FAIL por verificação com descobertas e o agente responsável.

O que é ClaudeWorkflow?

Esta skill valida um ou mais artefatos do workflow (Markdown) contra um esqueleto fixo e regras de citação, sendo uma ferramenta de auditoria somente leitura que nunca edita os arquivos, apenas reporta descobertas para que o coordenador possa mapear falhas para agentes específicos. É útil para garantir consistência estrutural e integridade das citações em projetos multiagentes, especialmente em processos que exigem qualidade rigorosa (gates G3, G7 e G8). A skill suporta qualquer sistema de agentes que opere com artefatos Markdown (como Claude Code, Cursor, Codex) e é projetada para ser executada repetidamente entre grupos de artefatos. O processo cobre 12 verificações divididas em estrutura, citações e ownership, produzindo um relatório compacto com status PASS/FAIL por verificação, linhas ofensivas destacadas e uma conclusão geral, permitindo que o coordenador aplique políticas de retry apenas no agente responsável.

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

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

artifact-validator

Valida um ou mais artefatos do workflow (Markdown) contra o esqueleto fixo e as regras de citação. Esta skill é somente leitura: ela nunca edita artefatos, apenas relata descobertas para que o coordenador possa mapear falhas para agentes.

O que verificar

Execute cada verificação abaixo contra cada arquivo de artefato. Relate cada verificação como PASS ou FAIL com descobertas concretas (cite as linhas ofensivas).

Estrutura (respalda gate G8)

  1. O arquivo começa com uma única linha de título # .
  2. - **Owner agent:** <agent> está presente e corresponde à tabela de ownership de artefatos em CLAUDE.md (nome do artefato ↔ nome do agente).
  3. As seções existem, nesta ordem, cada uma como ## : Inputs used, Summary, Details, Costs, Sources, Open issues.
  4. ## Costs é ou uma tabela (| Item | Unit | Qty | Unit cost | Total | Source / basis |) ou a frase exata No costs in this artifact.
  5. ## Open issues contém pelo menos um bullet, ou None.
  6. ## Sources contém pelo menos um bullet a menos que o artefato esteja explicitamente marcado como Not applicable (neste caso, deve informar o motivo).

Citações (respalda gates G7 e G3)

  1. Cada bullet de fonte tem o formato - <Page title> — <URL> (fetched YYYY-MM-DD; supports: <claims>).
  2. URLs são páginas reais: https:// ou http://, sem placeholders (example.com, localhost, TODO, ...), sem padrões inventados.
  3. Todo local, fornecedor, prestador de serviço, preço ou figura climática nomeado em Details/Costs rastreia uma alegação em um bullet de Sources. Uma recomendação sem fonte é FAIL.
  4. Preços devem vir de uma fonte ou ser marcados como price on request com a base da estimativa informada. Preços não marcados e sem fonte são FAIL.

Ownership e segurança

  1. O artefato não reivindica trabalho de propriedade de outro agente (ex.: um artefato de local contendo uma linha do tempo completa).
  2. Nada no artefato pede a alguém para escrever output/event-plan.html ou approval.json — esses são proibidos fora de html-builder / /approve-event.

Como relatar

Produza um relatório compacto, uma linha por verificação:

<artifact> C1 PASS ... C12 PASS
<artifact> C9 FAIL — "Koneser Hall" não tem citação de fonte → responsável: venue-planner

Termine com OVERALL: PASS ou OVERALL: FAIL — <agentes responsáveis>. Em caso de FAIL, o coordenador aplica a política de retry (veja CLAUDE.md §6): re-executar apenas o agente responsável com estas descobertas, regenerar dependentes downstream, re-validar.

Individual skills in this repo

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

Habilidades Relacionadas