news-aggregator

Verify the app actually works — lint, typecheck/build, then boot it and drive the real routes. Run before saying a change is done. Use when asked to verify, test, or confirm something works.

Scaffold a new presentational primitive in components/UI following this project's non-negotiable component pattern (folder per component, types.ts, no FC, PropsWithChildren at the signature, Record variant maps, semantic tokens only). Use when adding a Button/Input/Modal-style reusable component, or when asked to add something to the UI library.

Add or change a color/design token correctly — raw palette in base.css, semantic alias, Tailwind mapping in globals.css, plus a WCAG AA contrast check in both themes. Use when a component needs a color that does not exist yet, or when changing the palette.

Add a news provider adapter (Guardian, NYT, NewsAPI, …) that normalizes one API's response onto the internal Article type. Use when adding or changing a data source, wiring an API key, or touching lib/sources. This is the architecture the case study is graded on — open-closed and dependency inversion made concrete.