Files
KART_FRONT/.agent/project.md

2.0 KiB

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.