Files
KART_FRONT/.agent/project.md

27 lines
2.0 KiB
Markdown

## 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.