feedback Card

Feedback Cards

Feedback cards capture user responses inside the box.

Frontmatter:

• type-of-feedback: — query-response, comment, or brief.
• target: — {ref} pointing at the target element. The ref uses the path#fragment form, e.g. /_content/briefings/2026-02-01.briefing.card#q1.
• source: — text or voice.
• timestamp: — when the feedback was submitted.
• transcription: — populated by the transcribe pre-action for voice feedback. {text, language?, transcribed-at?}.
• transcription-error: — set if transcription failed.

Body (markdown): the user's typed text. For voice feedback the body may be empty; transcription.text is the source of truth.

The contains: field

Give this card a one-sentence contains: — the prime retrieval field for bbx search and listings. How to write a good one (carry the information when it's concise, never a list of parts, under 200 characters) is in the agent guide's ABOUT_CARDS section.