platform-specs-and-validation

platform-specs-and-validation (específicaciones y validación de plataforma)

La habilidad transversal de verificación previa a publicación — hace que un post sea correcto en cada destino (campos obligatorios, reglas multimedia, límites) y ejecuta el ciclo validar-antes-de-publicar. Es la piedra angular a la que apuntan las habilidades de formato. El agente mapea campos + corrige violaciones de especificación + valida; WoopSocial valida y publica; la creación de contenido y las decisiones de criterio humano permanecen en otras habilidades.

El punto de vista: listo para publicar, de forma atómica, la primera vez

WoopSocial valida y publica de forma atómica — POST /posts verifica todos los destinos juntos, y si falla alguno, no se crea nada. No hay endpoint de actualización, por lo que un post que se publica incorrectamente no se puede parchear (editar = eliminar + recrear). Eso convierte en acertar con los campos de cada destino antes de publicar en el juego completo: el postType correcto, los campos obligatorios por plataforma, las reglas multimedia y los valores específicos de la cuenta (tablero de Pinterest, privacidad de TikTok) resueltos desde platform-inputs — luego POST /posts/validate para detectar lo que quede. Esta habilidad es a donde acuden las habilidades de formato para asegurarse de que realmente pasará.

El marco de trabajo: CHECK

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

• C — Collect (Recolectar) los destinos + el proyecto: listar las cuentas sociales; confirmar que están en el mismo proyecto; anotar el conjunto de campos de cada plataforma.
• H — Hydrate (Hidratar) campos obligatorios por plataforma: completar los campos obligatorios de cada destino (FB/IG postType; los ocho de TikTok; YouTube title+privacy; Pinterest pinterestBoardId); resolver valores de cuenta desde GET /social-accounts/{id}/platform-inputs.
• E — Enforce (Aplicar) reglas multimedia + de contenido: Facebook no permite mezcla de imagen+video; Instagram Stories requieren contenido multimedia; Pinterest solo un medio; aplicabilidad de campos PHOTO/VIDEO en TikTok; usar contentOverride o posts separados donde haya conflictos de distribución; respetar límites de texto.
• C — Confirm (Confirmar) declaraciones veraces: isBrandedContent/isYourBrand/madeForKids son declaraciones veraces, no perillas de validación — nunca cambiarlas para eliminar un error; estas permanecen con la persona.
• K — Knock (Empujar) a través de la validación: POST /posts/validate → corregir todos los errores, revisar advertencias → crear (atómico). Sin actualización → eliminar + recrear (solo mientras esté en estado NOT_STARTED).

La especificación (fuente de verdad — verificar trimestralmente)

Enums de postType por plataforma + matrices de campos obligatorios + reglas multimedia + endpoint de descubrimiento de entradas de plataforma + hechos del ciclo de vida (creación atómica, sin actualización, estado de entrega, tipos de programación): references/woopsocial-publish-spec.md. El ciclo validar-luego-crear, la tabla completa de códigos ValidationField + la lista CreatePostErrorCode + ejemplos prácticos: references/validation-reference-and-recipes.md. (La especificación OpenAPI en vivo / tools/integrations/woopsocial.md es la fuente de verdad; los enums y límices cambian.)

Alcance honesto (nunca violar)

• Esta habilidad garantiza la preparación para publicar (campos/medios/especificación correctos + validados) — no escribe ni mejora el contenido creativo (lo hacen las habilidades de formato/contenido) y no puede garantizar el rendimiento.
• WoopSocial valida + publica de forma atómica; un destino que falla hace fallar todo el post. Sin actualización → eliminar + recrear (solo mientras esté en estado NOT_STARTED).
• Las declaraciones de divulgación/cumplimiento se mantienen veraces (isBrandedContent/isYourBrand/madeForKids) — nunca se cambian para pasar la validación; la intención de privacidad y la veracidad de la divulgación permanecen con la persona.
• Resolver valores de cuenta (tablero, privacidad) desde platform-inputs — no adivinar. Nunca inventar métricas — solo análisis nativos. (Alcance, distinciones + conexiones: references/scope-and-connections.md.)

Distinto de sus habilidades hermanas (enrutar correctamente)

platform-specs-and-validation (esta) = la capa cross-platform de campos/medios/validación que hace que un post esté listo para publicar en cada destino · las habilidades de formato por plataforma (tiktok-photo-mode, tiktok-video-publishing, threads-post, youtube-publishing-and-metadata, carousel-writer, …) = crean el contenido de una plataforma y apuntan aquí para la validación · scheduling-and-queue = tiempo/cadencia, no corrección · tools/integrations/woopsocial.md = la guía de integración compartida que esta habilidad aplica a nivel de post.

Dónde se conecta

Recibe de: cada habilidad de formato (contenido creado + postType elegido) y calendario de contenido (el plan). Resuelve con: GET /social-accounts/{id}/platform-inputs (tableros, opciones de privacidad) + la guía de integración. Entrega a: scheduling-and-queue → WoopSocial (POST /posts después de isValid), luego webhooks/estado de entrega para confirmación. Apoya: reutilización cross-platform (contentOverride por destino), analítica e informes (lectura de entrega nativa), experimentación (variantes válidas). La creación de contenido + las declaraciones veraces permanecen con las habilidades de formato + la persona.

Definición de completado

Todos los destinos recolectados y confirmados en un mismo proyecto; los campos obligatorios de cada destino hidratados (postType / privacidad / tablero / divulgación / título según corresponda) con valores específicos de la cuenta resueltos desde platform-inputs; reglas multimedia + de contenido aplicadas (sin mezcla en FB, contenido multimedia en IG-Story, medio único en Pinterest, aplicabilidad de campos en TikTok) con contentOverride o posts separados donde haya conflictos de distribución; declaraciones de divulgación/madeForKids mantenidas veraces (nunca cambiadas para pasar); POST /posts/validate ejecutado con todos los errores resueltos y advertencias revisadas antes de una creación atómica; las ediciones manejadas mediante eliminar+recrear, nada inventado y sin rendimiento prometido; correctamente distinguido de las habilidades de formato por plataforma y de scheduling-and-queue.