Skip to content

Add a New Venue Adapter

Controlled process for adding a publication destination without breaking the publish loop.

When to add a new adapter

  • A target audience needs a venue currently not supported (e.g., mastodon, internal-confluence, static-site-deploy).
  • An existing manual publishing flow has matured into a repeatable shape.

Steps

  1. Adapter design proposal.
  2. Adapter name and version.
  3. supported_content_types it will accept.
  4. Auth method and credential label (per credential-lifecycle-policy.yaml).
  5. Rate limits and retry policy from venue's documented constraints.
  6. Capabilities (dry_run, publish, unpublish, etc.).
  7. Audit events emitted.

  8. Schema-conformance check.

  9. Adapter declaration validates against venue-adapter.schema.json.

  10. Auth and secret handling.

  11. Provision an agent-scoped credential per agent-credential-provisioning.md.
  12. Verify least-privilege scope (SPB-04).
  13. Verify the credential cannot be read by other adapters.
  14. Confirm rotation cadence in credential-lifecycle-policy.yaml.

  15. Sandbox publish validation.

  16. Use a non-production target on the venue (sandbox account, draft workspace, hidden post).
  17. Run publish-loop.md end-to-end with data_classification: low_sensitive test content.
  18. Verify dry-run, publish, post-publish confirmation, unpublish (if supported).

  19. Policy updates.

  20. Add the new venue category (if any) to publishing-policy.yaml approvals_required.
  21. Add classification routing rules in policy if the venue is public.

  22. Audit conformance.

  23. Adapter emits all required events per publish-audit-log-spec.md.

  24. Document and announce.

  25. Add the adapter to README.md "Files" table (if hosted here) or to a registry of adapters.
  26. Add a row to the history below.

Rollback

  • If sandbox validation fails, do not promote the adapter to production usage.
  • Revoke the credential.
  • Document failure mode for future re-evaluation.

Unpublish considerations

  • If the venue does not support unpublish, document the gap and require pre-publish approval criteria stricter than for unpublish-capable venues.
  • Maintain a published-artifact registry that supports manual takedown coordination.

History

Date Adapter Status