Interaction models¶
North Star: predictable and forgiving: the same gesture does the same thing everywhere, and nothing is silent or irreversible (SUB-21, SUB-28).
Worked patterns applied the same way across hosts, tools and agents (DEV-08). Each model is one short page: the requirements it cites, a Mermaid sequence diagram, and a pointer to its reference implementation. Where an interaction is already a requirement, the model cites it rather than restating it.
| Model | Written in | Status |
|---|---|---|
| Selection and tool offering | Phase 1 | Requirements gathered |
| Tool invocation and forms | Phase 1 | Requirements gathered |
| Unavailable capabilities | Phase 1 | Requirements gathered |
| Undo | Phase 2 | Written |
| Conflicts | Phase 2 | Written |
| Long-running operations | Phase 2 | Requirements gathered |
| Check overrides | Phase 2 | Requirements gathered |
| Keyboard equivalents | Phase 3 | Requirements gathered |
Analysts review the Phase 1 models before they are built.