lamina-feedback-and-status
SolidSystem state visibility in contracts — modeless feedback, progress, and async status. Use when actors can't tell what happened after actions.
AI & Automation 71 stars
3 forks Updated today Apache-2.0
Install
Quality Score: 80/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
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
AI & Automation Solid
lamina-discoverability
Signifiers and affordances in screen contracts — actors must see what they can do. Use when actor walks report execution/evaluation gulfs.
71 Updated today
aryaniyaps Code & Development Solid
lamina-side-effects
Downstream effects of state changes — notifications, updates to related entities, and cross-actor handoffs. Use when one operation must trigger updates beyond the primary screen.
71 Updated today
aryaniyaps AI & Automation Solid
lamina-feedback-loops
Feedback loops in product behavior — balancing and reinforcing dynamics, delays, and oscillation. Use when state changes feed back into further change.
71 Updated today
aryaniyaps