platform-specs-and-validation

O que platform-specs-and-validation faz?

A habilidade transversal de prontidão para publicação — tornar uma postagem correta em cada destino (campos obrigatórios, regras de mídia, limites) e executar o loop valide-antes-de-publicar. É a pedra angular para a qual as habilidades de formato apontam. O agente mapeia campos + corrige violações de especificações + valida; o WoopSocial valida e publica; a criação de conteúdo e decisões de julgamento humano permanecem em outro lugar.

O Ponto de Vista: pronto para publicar, atomicamente, na primeira vez

O WoopSocial valida e publica atomicamente — POST /posts verifica todos os destinos juntos, e se qualquer um falhar, nada é criado. Não há endpoint de atualização, então uma postagem publicada incorretamente não pode ser corrigida (editar = deletar + recriar). Isso faz com que acertar os campos de cada destino antes de publicar seja o jogo inteiro: o postType correto, os campos obrigatórios por plataforma, as regras de mídia e os valores específicos da conta (board do Pinterest, privacidade do TikTok) resolvidos a partir de platform-inputs — então POST /posts/validate para capturar o que restou. Esta habilidade é onde as habilidades de formato vêm para garantir que a postagem realmente será aprovada.

O framework: CHECK

(Profundidade: references/the-check-framework.md.)

• C — Colete os destinos + projeto: liste as contas sociais; confirme que estão no mesmo projeto; anote o conjunto de campos de cada plataforma.
• H — Hidrate campos obrigatórios por plataforma: preencha os campos obrigatórios de cada destino (postType FB/IG; os oito do TikTok; title+privacy do YouTube; pinterestBoardId do Pinterest); resolva valores da conta a partir de GET /social-accounts/{id}/platform-inputs.
• E — Execute regras de mídia + conteúdo: FB sem mistura de imagem+video; IG Stories precisam de mídia; Pinterest mídia única; aplicabilidade de campos PHOTO/VIDEO do TikTok; use contentOverride ou postagens separadas onde houver conflitos de distribuição; respeite limites de texto.
• C — Confirme declarações verdadeiras: isBrandedContent/isYourBrand/madeForKids são declarações verdadeiras, não chaves de validação — nunca as altere para limpar um erro; essas permanecem com a pessoa.
• K — Knock it through validation: POST /posts/validate → corrija todos os erros, revise avisos → crie (atômico). Sem atualização → deletar + recriar (apenas enquanto NOT_STARTED).

A especificação (fonte da verdade — verificar trimestralmente)

Enums de postType por plataforma + matrizes de campos obrigatórios + regras de mídia + endpoint de descoberta de platform-inputs + fatos do ciclo de vida (criação atômica, sem atualização, status de entrega, tipos de agendamento): references/woopsocial-publish-spec.md. O loop validar-depois-criar, a tabela completa de códigos ValidationField + lista de CreatePostErrorCode + exemplos práticos: references/validation-reference-and-recipes.md. (A especificação OpenAPI ao vivo / tools/integrations/woopsocial.md são a fonte da verdade; enums e limites mudam.)

Escopo honesto (nunca violar)

• Esta habilidade garante PRONTIDÃO PARA PUBLICAR (campos/mídia/especificação corretos + validados) — ela não escreve ou melhora o conteúdo criativo (as habilidades de formato/conteúdo fazem isso) e não pode garantir desempenho.
• O WoopSocial valida + publica atomicamente; um destino com falha reprova toda a postagem. Sem atualização → deletar + recriar (apenas enquanto NOT_STARTED).
• Declarações de divulgação/conformidade permanecem verdadeiras (isBrandedContent/isYourBrand/madeForKids) — nunca alteradas para passar na validação; intenção de privacidade + veracidade da divulgação permanecem com a pessoa.
• Resolva valores da conta (board, privacidade) a partir de platform-inputs — não adivinhe. Nunca invente métricas — apenas análises nativas. (Escopo, distinções + conexões: references/scope-and-connections.md.)

Distinto de suas irmãs (rotear corretamente)

platform-specs-and-validation (esta) = a camada transversal de campos/mídia/validação que torna uma postagem pronta para publicação em todos os destinos · as habilidades de formato por plataforma (tiktok-photo-mode, tiktok-video-publishing, threads-post, youtube-publishing-and-metadata, carousel-writer, …) = criam o conteúdo de uma plataforma e apontam aqui para validação · scheduling-and-queue = tempo/cadência, não correção · tools/integrations/woopsocial.md = o guia de integração compartilhado que esta habilidade aplica no nível da postagem.

Onde isso se conecta

Recebe de: toda habilidade de formato (conteúdo criado + postType escolhido) e content-calendar (o plano). Resolve com: GET /social-accounts/{id}/platform-inputs (boards, opções de privacidade) + o guia de integração. Entrega para: scheduling-and-queue → WoopSocial (POST /posts após isValid), depois webhooks/status de entrega para confirmação. Suporta: cross-platform-repurposing (contentOverride por destino), analytics-and-reporting (leitura de entrega nativa), experimentation (variantes válidas). A criação de conteúdo + declarações verdadeiras permanecem com as habilidades de formato + a pessoa.

Definição de concluído

Todos os destinos coletados e confirmados em um projeto; campos obrigatórios de cada destino hidratados (postType / privacidade / board / divulgação / título conforme aplicável) com valores específicos da conta resolvidos a partir de platform-inputs; regras de mídia + conteúdo aplicadas (sem mistura no FB, mídia do IG-Story, mídia única do Pinterest, aplicabilidade de campos do TikTok) com contentOverride ou postagens separadas onde houver conflitos de distribuição; declarações de divulgação/madeForKids mantidas verdadeiras (nunca alteradas para passar); POST /posts/validate executado com todos os erros resolvidos e avisos revisados antes de uma criação atômica; edições tratadas via deletar+recriar, nada inventado e nenhum desempenho prometido; corretamente distinguido das habilidades de formato por plataforma e de scheduling-and-queue.