convention-least-astonishment

Community

Align behavior with user expectations.

AuthorsunLeee
Version1.0.0
Installs0

System Documentation

What problem does it solve?

The Principle of Least Astonishment guides teams to design predictable, intuitive systems so users are not surprised by behavior.

Core Features & Use Cases

  • Clear naming and predictable side effects to minimize cognitive load.
  • Guidance for API design, function naming, and error handling to align with user expectations.
  • Use Case: A developer refactors a function to be more predictable, reducing bugs and improving UX.

Quick Start

Design and implement features so system behavior remains predictable for users.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: convention-least-astonishment
Download link: https://github.com/sunLeee/optimization/archive/main.zip#convention-least-astonishment

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.