davidteren

Expectation Fit — Security skill for Claude Code

Security community

Expectation Fit: a Claude Code plugin with 5 review lenses (predictability, convention, simplicity, experience, architecture) for planning, plan validation, code review, and codebase audit.

How to install Expectation Fit

This entry records only its repository, not the path inside it, so there is no exact command to give. Open davidteren/expectation-fit and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Expectation Fit does

Expectation Fit: a Claude Code plugin with 5 review lenses (predictability, convention, simplicity, experience, architecture) for planning, plan validation, code review, and codebase audit. Formerly intent-engineering.

Alternatives in Security

FastAPI Review — Review a FastAPI application for architecture, async correctness, dependency injection, Pydantic schemas, secu 243.5k ★
Pal — Multi-model AI integration — chat, debugging, code review, planning, security audit 11.3k ★
Data Viz Audit — Audit a data visualization for chart type selection, accessible color palette, annotations, and anti-patterns 309 ★

README

expectation-fit

Formerly intent-engineering (0.8.x). The `/ie-*` skills are now `/fit-*`. There is no `/ie-*` shim: after updating, the `/ie-*` commands are gone. Use the `/fit-*` names. See [Upgrading from intent-engineering](plugins/expectation-fit/README.md#upgrading-from-intent-engineering).

[![contracts](https://github.com/davidteren/expectation-fit/actions/workflows/contracts.yml/badge.svg)](https://github.com/davidteren/expectation-fit/actions/workflows/contracts.yml) [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Listed on ClaudePluginHub](https://www.claudepluginhub.com/badge/davidteren-expectation-fit-plugins-expectation-fit)](https://www.claudepluginhub.com/plugins/davidteren-expectation-fit-plugins-expectation-fit?ref=badge)

**Site:** [davidteren.github.io/expectation-fit](https://davidteren.github.io/expectation-fit/)

A Claude Code plugin that enforces **expectation fit**: software — and the experience around it — that behaves the way a reasonable developer or user already expects. It guards against *surprise* on both sides: hidden side effects and reinvented conventions in the **code**, and broken flows, weak interaction states, or dark patterns in the **UX**. It applies a set of well-established design principles — plus framework architecture analysis across six stacks (Rails, Python/FastAPI, Laravel, Express, Phoenix, React) — as review **lenses** that fan out as parallel agents and return scored, deduplicated findings with concrete fixes.

**What / Why / How (plain language)**

**What:** A toolkit you run against a plan, a pull request, your local changes, or a whole codebase. It checks whether the work follows time-tested principles of "least surprise" — does the code/UI behave the way people expect, follow conventions, stay simple, and feel coherent?

**Why:** Surprising software is expensive. Hidden side effects, reinvented conventions, needless complexity, and inconsistent UX cost rev