## KART Front Repository Rules ### Repository Role and Current Authority - This repository is the current React 17 and JavaScript frontend for KART survey processing and reporting. - Treat the existing routing, state management, report screens, tables, charts, exports, and custom publishing CSS as authoritative until an approved migration slice replaces them. - Do not perform incidental JavaScript-to-TypeScript, custom-CSS-to-Tailwind, React-to-Next.js, router, or state-library migrations while handling an unrelated change. - The sibling `../Style_publish` directory is outside this Git repository. Treat it as external reference material and do not modify it unless a task explicitly adds it to scope. ### Legacy Auxiliary Server - The tracked `server/` directory is a legacy auxiliary Express/MSSQL artifact and includes embedded connection configuration. Do not copy, disclose, extend, or rely on those values. - Treat removal or replacement of that server configuration as migration cleanup; keep it outside unrelated frontend maintenance. ### Frontend Migration Direction - The approved destination is Next.js with TypeScript and shadcn/ui, migrated by bounded route or feature slices. - In an approved migration slice, use shared KRI frontend contracts and shadcn components before creating application-local equivalents. - Do not create new frontend TypeScript type or interface names ending in `Dto` or `DTO`. - Preserve report filters, table and chart semantics, loading and error states, export behavior, responsive behavior, and user-visible styling during migration. - Existing partial Tailwind or shadcn work does not authorize a broad migration or establish that the entire application has already moved to the target architecture. ### Harness and Verification - `AGENTS.md` and `CLAUDE.md` are generated. Edit `.agent/profile.yml` or `.agent/project.md`, then recompose instead of editing generated files. - Use the repository's existing package manager and narrow frontend checks. Do not start the auxiliary server or connect to MSSQL during validation.