Amend.sh

Source Trace

The evidence chain that keeps requests, source work, releases, and updates connected.

Source trace is the reason Amend exists. It stops public product communication from drifting away from the work that actually shipped.

Trace shape

Every update should be able to show a compact chain:

customer request -> source work -> review decision -> public update -> notification audience

That chain can be shown to operators in the dashboard and collapsed into a cleaner story for customers in the portal.

Inputs

InputWhy it matters
FeedbackCaptures the customer ask and who should hear back
Account identityHelps prioritize impact and target notifications
GitHub issue or PRProvides source evidence and status
Release or commitProves the work shipped
Workspace rulesDecides whether to draft, hold, or require review
Prior updatesPrevents duplicate or contradictory announcements

Confidence levels

Use different behavior based on evidence quality:

ConfidenceExampleSuggested action
StrongFeedback links directly to a merged PR and releaseDraft update and queue notification
MediumFeedback matches an issue label or milestoneDraft for review with source caveat
WeakSimilar wording but no source relationSuggest investigation, do not publish

Review before publish

The reviewer should see the public copy beside the source chain. That makes it easy to rewrite tone, hold the update, merge duplicate asks, or mark the suggestion as not relevant.

Public output

Customers do not need to see every commit or internal decision. They need a clear answer:

  • what changed
  • why it matters to their request
  • whether action is required
  • where the roadmap or changelog item now lives

Keep the trace visible to the team, and keep the portal readable for customers.

  • Source events explains how evidence enters Amend.
  • Automation explains how source evidence becomes reviewable decisions.
  • Customer surfaces explains how users, accounts, feedback, and update feeds stay connected.

On this page