What a pattern is here
A component is a part: a button, a sheet, a toast. A pattern is how parts work together to solve a problem a person meets again and again: their words not reaching the cloud, a screen with nothing on it yet, a producer who needs the call sheet as a PDF. Each pattern below starts with the problem as a writer or a crew member meets it, gives Kwark’s answer and the decision behind it, and ends with a test an agent can be held to.
Three things are true of every pattern:
- The work comes first. Nothing competes with the page while someone writes. Chrome steps back; the script does not.
- The work is never at risk, and never looks it. Every state says whether the work is safe, in plain words.
- Nothing is compulsory. Structure, rhythm, tours and targets are optional and can be switched off.
Saving, safety and state
Finding your way
Starting and filling in
Working with others
Making things
How to read a pattern page
| Section | Answers |
|---|---|
| The problem | What the person meets, in their situation |
| Kwark’s answer | What Kwark does, and the decision record it comes from |
| Anatomy | The parts and what each means |
| Rules | Must, Never and Always bullets an agent can check |
| Phone and desktop | What changes under 768 wide and on a phone held sideways |
| Writing | The exact words, from the app |
| Accessibility | Roles, focus, announcements, targets |
| Demo | Live HTML in Kwark’s classes, light and dark |
| AI readiness test | A task an agent should be able to do from the page alone |
Before you design a flow in Kwark, find the pattern that covers it here and follow it. If two patterns seem to conflict, the one closer to the work being safe wins; then ask.
AI readiness test
Task. A module shows “Sync failed” in red when offline. Fix it.
Give the agent. This page, Saving and sync, Errors.
Constraint. Use the app’s own words.
A reliable answer
- Replaces it with a state that says the work is safe (“Saved on this device”)
- Uses amber with a word, never red alone, because nothing is lost
- Offers a next step only if the person can act (Retry, Backup)
- Removes the message when the state is ordinary