# Codex Project Instructions

This repository keeps project-specific agent rules in `.cursor/`. These rules are mandatory for Codex work in this repo.

## Mandatory Rule Loading

Before making code, UI, release-note, or documentation changes, inspect the relevant `.cursor` instructions and follow them as binding project policy.

Always apply:
- `.cursor/skills/react-best-practices/SKILL.md`
- `.cursor/rules/changelog-writing.mdc`

Apply for frontend UI work:
- `.cursor/skills/frontend-design/SKILL.md`

Apply for Figma design implementation:
- `.cursor/skills/figma-ui-implementation/SKILL.md`

## Enforcement

- Treat the matching `.cursor` instructions as higher-priority project conventions.
- If a task matches multiple files, read all matching files before editing.
- Do not silently ignore a matching rule. If a rule conflicts with user instructions or existing code constraints, explain the conflict and choose the safest path.
- For Figma-linked UI implementation, read the Figma design context first, then implement with Flex/Grid where possible and verify visual fidelity before finishing.
- For React changes, follow the React, TypeScript, state, effect, styling, i18n, and maintainability rules in `react-best-practices`.
- For changelog or version-update requests, inspect real repository changes first and write only from observed changes.