Skip to main content

Collaboration Overview

Work together effectively with comments, discussions, approval workflows, and version promotion controls. Ensure quality through team review processes.

Why Collaborate?#

Building reliable AI systems is a team effort. Collaboration features in PromptReports ensure that changes are reviewed, feedback is captured, and production updates go through proper approval processes—just like code reviews in software development.

Peer Review

Get feedback on prompt changes before they affect users.

Quality Gates

Ensure changes meet quality standards before promotion.

Audit Trail

Track who approved what and when for compliance.

Knowledge Sharing

Document decisions and rationale for future reference.

Collaboration Features#

Comments & Discussions#

Comments enable rich discussions directly in context:

Comment TypeUse Case
Version CommentsDiscuss changes in a specific version
Inline CommentsComment on specific lines or sections
General DiscussionFolder-level or prompt-level discussions
@MentionsTag specific people to get their attention
ReactionsQuick acknowledgment with emoji reactions

Approval Workflows#

Configure approval requirements to ensure proper review before production changes:

1

Configure approval settings

In folder settings, specify who can approve and how many approvals are required.
2

Request promotion

When ready, request promotion from staging to production.
3

Review process

Approvers receive notifications and review the changes, evaluation results, and diffs.
4

Decision

Approvers can approve, reject, or request changes with comments.
5

Promotion

Once required approvals are met, the version is promoted.

Version Promotion#

The promotion workflow moves versions through stages safely:

StagePurposeTypical Approvers
DevelopmentActive development and testingSelf
StagingPre-production validationTech lead, QA
ProductionLive servingProduct owner, Manager

Best Practices#

Review Early and Often

Don't wait until production—get feedback during development.

Require Approvals

Configure at least one approval for production promotions.

Document Decisions

Use comments to record why decisions were made.

Use Regression Tests

Enable automatic quality gates to catch issues early.