diff --git a/AGENTS.md b/AGENTS.md index 2f59fe8030..da6c1a7bcb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -284,21 +284,24 @@ where the error points. > **verified, recurring workflow trap** with its real error signature, and > **reproducible + non-obvious**. A genuine repo bug is not a row — fix it. -| Symptom | Cause | Fix | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| CI step **"Check all generated code is committed"** fails (`git diff --exit-code`) | You changed an `@flr-generate` component's props, an icon, prop JSDoc, or a `.module.scss`'s class names and didn't regenerate — or regenerated but didn't commit | `pnpm build` (or the specific generator from the [Generated code](#generated-code--must-be-committed) table), then commit the changed `view.ts`, `src/views/*`, `src/auto-generated/**`, `*.module.d.scss.ts`, icon, or `doc-properties.json` | -| `test:compile` fails on a new component — the `flowComponent("X", …)` name/props type isn't assignable | `flowComponent` names are typed as `keyof` a hand-maintained props registry | Register the props type in `packages/components/src/components/propTypes/index.ts` (see [The flowComponent factory](packages/components/AGENTS.md#the-flowcomponent-factory)) | -| A package script errors (e.g. **"X is not exported from `@mittwald/flow-…`"**, missing module) or silently uses **stale** output from another package | You ran the package script directly (`pnpm --filter