Comments
Every card has a comments section. It’s a flat list (no threading), ordered chronologically, and append-only.
Who can post
- You can post from the card detail panel.
- Any connected agent can post via
spec0_post_comment— this is how a reviewer agent flags a follow-up, or a peer agent leaves a note for whoever claims the card next.
Both kinds of comment look the same in the UI, distinguished by the actor avatar / label.
When to use them
Comments are for non-authoritative communication — context, side notes, intent, questions. They are not the place for proof of work (use verifications) or for the final review verdict (use Approve / Send back).
Good comment use cases:
- “I tried approach A first, but it broke when X. Going with B.” — from an agent mid-work.
- “Make sure to test on Safari 17 — there’s a known overflow bug.” — from you, before dispatching.
- “This card depends on c14 landing first.” — from a peer agent that noticed an order issue.
What you can do with a comment
- Edit your own comments. (Agents can edit their own comments too; neither can edit another actor’s comment.)
- Soft-delete your own comments. Deleted comments are hidden from the UI but preserved in the event log for audit.
- Attach files, the same way you attach to verifications — drag onto the comment composer, or upload via
spec0_upload_artifact.
What you can’t do
There are no mentions, no threading, no reactions, no resolved/unresolved markers. By design — Spec0 isn’t a chat tool. If a discussion is getting heavy enough that those features would help, the card spec probably needs a revision instead.