Files
social-media/docs/FEATURES/review-workflows.md
Jonathan Bourdon b6eb692c27
Some checks failed
Backend CI/CD / build_and_deploy (push) Has been cancelled
Frontend CI/CD / build_and_deploy (push) Has been cancelled
chore: moving towards agentic development
2026-04-24 21:12:26 -04:00

2.0 KiB

Review Workflows

Status

Active

Use Case 1: Internal Review Before Client Review

Actors

  • Content contributor
  • Provider
  • Internal reviewer
  • Manager

Scenario

  1. A contributor or provider creates or updates a draft.
  2. The team links assets and updates the content item metadata.
  3. An internal reviewer leaves comments or requests changes.
  4. Revisions are linked or uploaded.
  5. A manager decides the content item is ready for client review.

Outcome

  • the content item has an internal review history
  • revisions are traceable
  • the item advances to client review only after internal readiness

Use Case 2: Client Approval

Actors

  • Social media manager
  • Client approver

Scenario

  1. The team sends a content item for client review.
  2. The client reviews assets, caption/copy, dates, and notes.
  3. The client records a decision:
    • approve
    • reject
    • request changes
  4. The team responds with comments or revisions when necessary.

Outcome

  • the decision is captured in the system
  • the audit trail shows who decided what and when
  • the team knows whether the item is approved, blocked, or requires changes

Use Case 3: Revision Loop

Actors

  • Provider or internal contributor
  • Reviewer

Scenario

  1. A reviewer requests changes.
  2. The owner of the work creates a revised asset or revised copy.
  3. The new revision is linked to the content item.
  4. The reviewer can compare current state against prior feedback context.

Outcome

  • the latest revision is identifiable
  • older revisions remain traceable
  • feedback does not get detached from the work item

Use Case 4: Ready For Publishing Handoff

Actors

  • Manager
  • Publishing owner

Scenario

  1. All required review and approval work is complete.
  2. The content item transitions to Ready to publish.
  3. The downstream publishing owner uses the item as the approved handoff package.

Outcome

  • publishing handoff is based on an approved state
  • the approved revision and metadata are clear
  • the workflow history remains visible