# Wellworn

The judgment layer for coding agents. It answers which stack, library, skill, or design
system to use, what breaks at which version, and who verified it. Every answer names a
reviewer, the version tested, the sources, and the date it has to be checked again.

Corpus right now: verdicts served 25, flagged for recheck 0, traps 58, catalog tools 28242.

## Install

claude mcp add --transport http wellworn https://mcp.wellworn.dev/mcp

Works without a key at 60 calls a day per IP. A free key raises that to 2,000 a month
and allows trap submissions: https://wellworn.dev/keys

## Tools

- recommend: which stack, library, or service to use for a task, with the traps and the skill
- compare: verified comparison of 2 to 4 options, with the condition under which each one wins
- alternatives: open-source or self-hosted alternatives to a SaaS or library
- traps: known breakages for a library at a version: symptom, severity, fix
- skill: the SKILL.md procedure for a verdict or library, or its install command
- design: design system, tokens, layout rules, and anti-patterns for a screen
- docs: official docs URL, llms.txt, and latest version for a library
- submit_trap: report a breakage and its fix; reviewed before it is served, needs a free key

## Pages

- https://wellworn.dev/verdicts: every served verdict, filterable by kind and tag
- https://wellworn.dev/compare: the head-to-head verdicts on their own
- https://wellworn.dev/alternatives: the open-source catalog behind the alternatives tool
- https://wellworn.dev/alternatives/to: hosted products mapped to the catalog categories that replace them
- https://wellworn.dev/traps: breakages by library and version
- https://wellworn.dev/skills: skills published with the verdicts
- https://wellworn.dev/design: design systems and screen rules
- https://wellworn.dev/docs: install instructions per agent
- https://wellworn.dev/blog: notes on what verdicts and traps are
- https://wellworn.dev/pricing: limits and plans
- https://wellworn.dev/about: who writes the verdicts and how
- https://wellworn.dev/stats: live counts from the database
- https://wellworn.dev/sitemap.xml: sitemap index, one shard per page type
- https://wellworn.dev/llms-full.txt: every served verdict in the compact form the MCP returns

## URL scheme

- https://wellworn.dev/verdicts/{slug} one verdict: the pick, one alternative and when it wins, what to avoid, the traps at the tested version, the sources, and the recheck date
- https://wellworn.dev/tools/{slug} one catalog tool: name, maintainer summary, licence, stars, commits in the last three months, latest version, last release date, categories, and repository, website and demo links
- https://wellworn.dev/alternatives/{category} every catalog tool in one category, most stars first
- https://wellworn.dev/alternatives/to/{product} the catalog tools that cover what a named hosted product does
- https://wellworn.dev/traps/{library} the served traps for one library, each with its version range, symptom, fix, and evidence link

Verdict pages state who verified them, the version tested, and the date the claim has to
be checked again. Catalog tool pages with no maintainer summary, and tools under 20 stars
with no release in two years, are served with robots noindex; they stay readable and stay
linked from their category.

## Licence

Verdicts are CC BY-SA 4.0. The server and the plugin are MIT.