# Feedback control

> Asks whether one of Kwark’s own tools helped: Useful or Not useful, with an optional note. Never placed on a person’s writing.

Source: https://kwark.space/designSystem/components/feedback-control

## Usage

### What it is
A two-word question about Kwark itself: an export, a help page, a suggestion the assistant made. The answer goes to the people who build Kwark, not to anyone in the project.

### When to use
- At the end of a tool’s result: an exported PDF, a breakdown the app read from the script, an AI result someone has finished reviewing.

### When not to use
- On a scene, a line, a character, a draft or anything a person made. Kwark never judges the script (Decision 0002) and is a safe, private place (Decision 0001).
- As stars, numbers, scales or emoji. Two words.
- More than once per session for the same tool.

### Writing
*Was this export useful?* · **Useful** · **Not useful**. After an answer: *Thanks. What was missing? (optional)*. Never *Rate*.

## Style

### Anatomy

1. **Question**: 12px Poppins, `--k-text-2`.
2. **Options**: 28px pills, 0 10px, 1px `--k-line`, 12px, `--k-text-2` (the same shape as the calendar’s person choices, `.tl-person`). Pressed: border `--k-accent-soft`, background `color-mix(--k-accent 14%)`, `--k-text`.
3. **Note**: appears after *Not useful*; optional, one line.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-accent` | #98633f | #98633f |
| `--k-accent-soft` | #e8b58b | #e8b58b |
| `--k-radius-pill` | 999px |  |
| `--k-fs-meta` | 12px |  |

## Code

### React

Use the HTML below with `kwark.css`. The example shows the markup and styling. Supply any application behavior described on this page.

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<div class="kw-feedback" role="group" aria-label="Was this export useful?">
  <span aria-hidden="true">Was this export useful?</span>
  <button class="kw-feedback__opt" type="button" aria-pressed="false">Useful</button>
  <button class="kw-feedback__opt" type="button" aria-pressed="true">Not useful</button>
</div>
<label class="kw-field kw-feedback__note"><span class="kw-label">What was missing? (optional)</span><input class="kw-input" placeholder="Scene numbers were not on the side"></label>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| Tab | Moves to each option. |
| Enter / Space | Chooses it; the note field appears and is not focused automatically. |

### ARIA
- A `role="group"` named by the question; options are toggle buttons with `aria-pressed`.

## For agents

### Rules

- **Never** attach feedback controls to a person’s writing or any project content (Decisions 0001, 0002).
- **Never** use stars, scores, scales or emoji.
- **Must** make the follow-up note optional.
- **Always** say who sees the answer if it is not obvious: the Kwark team.

### AI readiness test

**Task:** Add a way for writers to rate the outline templates.

**Give the agent:** This page, Decisions 0002 and 0004.

**Constraint:** The product team wants a 1–5 rating.

**A reliable answer:**
- Uses Useful / Not useful, not 1–5
- Places it on the template picker, not on the writer's outline
- Makes the note optional
