Feedback basics
Boards, posts, votes, statuses — and how the roadmap and changelog fall out of them.
Posts live on boards
A board is a bucket of feedback — Features, Bugs, whatever fits.
A post is one request: a title, markdown details, and votes. One person,
one vote per post; voting again removes it. Voters are subscribed to the post,
so they hear about it when you ship.
Statuses drive everything
Every post has a status: open, planned, in-progress, shipped, or
closed. Change it from the dashboard inbox (or let an agent do it). Statuses
are what make the other surfaces work:
- The roadmap shows posts grouped under
planned,in-progress, andshippedcolumns — nothing to maintain separately. - The changelog links published entries back to the posts they shipped, closing the loop for everyone who voted.
Guest content is flagged
Posts and votes from anonymous guests carry verified: false in the API, and
guest posts wait in your moderation queue before appearing publicly. Your
counts stay honest and your agents can filter on it.
For agents
list_posts returns voteCount, commentCount, status, and verified
per post. For "what should we build next", prefer the what_to_build_next
tool — it ranks by demand with recency decay and shows its math.