docs: add agent harness instructions
This commit is contained in:
19
.agent/profile.yml
Normal file
19
.agent/profile.yml
Normal file
@@ -0,0 +1,19 @@
|
||||
schema_version: 1
|
||||
|
||||
project:
|
||||
id: kart-front
|
||||
name: KART Front
|
||||
type: internal-service
|
||||
layer: frontend
|
||||
legacy: true
|
||||
|
||||
stack:
|
||||
- react
|
||||
|
||||
migration:
|
||||
status: planned
|
||||
target_stack:
|
||||
- typescript
|
||||
- react
|
||||
- nextjs
|
||||
strategy: staged
|
||||
26
.agent/project.md
Normal file
26
.agent/project.md
Normal file
@@ -0,0 +1,26 @@
|
||||
## 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.
|
||||
Reference in New Issue
Block a user