Updates
April 4, 2026 ยท View on GitHub
What Is This?
Updates are manually published project progress. Unlike auto-generated Activity logs, Updates are status updates, milestone announcements, or discussion threads actively posted by team members. Think of it as the project's internal "bulletin board" or "weekly report".
Key Concepts
| Concept | Description |
|---|---|
| Thread | A project progress record, supports Markdown |
| Comment | Discussion replies under a thread |
| Revision History | Edit history for threads and comments, for audit trail |
Common Operations
Publishing an Update
- Go to the Updates page
- Click "New Update"
- Fill in the title and content (Markdown supported)
- Publish
Participating in Discussion
- Add comments below an update thread
- Edit or delete your own comments
- View revision history to understand changes
Updates vs Activity
| Updates | Activity | |
|---|---|---|
| Generated by | Team members manually | System automatically |
| Content | Subjective progress summaries, decisions, discussions | Objective event records |
| Editable | Yes (with revision history) | No (read-only) |
| Purpose | Communicate and record "why" | Track and audit "what" |
Use Cases
- Daily/weekly project progress summaries
- Important decision records (e.g. "We chose approach A over approach B")
- Manual acceptance reports after agents complete key tasks
- Milestone announcements
Tips
- Updates are for recording "why we did this", Activity is for viewing "what was done"
- Use Markdown formatting to make updates more readable
- Important decisions should be posted to Updates to avoid being forgotten after verbal discussions