lamina-feedback-and-status

Solid

System state visibility in contracts — modeless feedback, progress, and async status. Use when actors can't tell what happened after actions.

AI & Automation 65 stars 2 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 82/100

Stars 20%
61
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
83
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Feedback and Status (agent-native) Every mutating operation declares **what the actor sees during and after** — in workflow steps and `scenarios[]`. ## Contract encoding Per workflow step: - `feedback`: immediate | progress | async_poll | silent_ok - `visible_state`: what changes on screen (entity state, badge, banner) - Async: `status: processing` scenario until terminal state **Modeless feedback** preferred over modals for routine status. ## Frameworks - **Visibility of system state**: actor always knows where they are in multi-step flows. - **Forcing functions**: only for safety-critical irreversible ops — document in scenario. - **Feedforward**: preview consequence before commit (destructive ops). ## Design checklists 1. No dialog reports normal completion. 2. Disabled controls explain why (link to scenario or inline hint). 3. Progress for ops > ~1s perceived wait. 4. Optimistic UI only when `consistency-guarantees` allow + rollback scenario exists. 5. Group related status in same screen region. ## Verify checks - Actor walk: each mutating step produces expected visible feedback. - Async probe: refresh during processing — stale state handled per invariant. - Double-click submit — idempotency feedback (`idempotency-concurrency`). ## Anti-patterns - Async silence — upload with no progress. - Disabled with no explanation. - "Are you sure?" without true irreversibility. - Modal blocking batch flow for recoverable status. ## Related - [Discoverability](../lamin...

Details

Author
aryaniyaps
Repository
aryaniyaps/lamina
Created
3 weeks ago
Last Updated
today
Language
TypeScript
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category