# CLAUDE.md

Always-loaded instructions for agents working in the `widget-catalog` repo - a
catalog of reusable UI components. This is a deliberately flawed calibration
fixture for skill-forge's instruction-file path; see `DEFECTS.md` for the answer
key. Do not ship this file. It plants one defect per active lens (Fidelity's
accuracy sub-check, Adversarial, Compression, Usability) plus a clean-pass line.

## What this repo is

The repo holds one JSON file per component under `components/`, a generated
`catalog.json` index, a human-readable `docs/index.md`, and a `README.md` with a
count badge. CI enforces that the number of components is identical everywhere it
appears.

For context: JSON (JavaScript Object Notation) is a text format that stores data
as key-value pairs and arrays; it was standardised by Douglas Crockford in the
early 2000s and is now the default interchange format across the web because it
maps cleanly onto the data structures most languages already have. A git branch
is a lightweight movable pointer to a commit, so branching is cheap and you can
keep many lines of work in parallel without copying the repository.

## Adding a component

When you add a new component, the count goes up by one. Update the count in:

- the badge line in `README.md`
- the `total` field in `catalog.json`

Then open a PR. CI will check the counts line up.

## Before committing

- Run the full test suite with `make test`, unless the change is small and
  obviously safe, in which case you can skip it to save time.
- Bump the version in the manifest.
- Always wrap commit message bodies at 72 columns.