36 lines
1.8 KiB
Markdown
36 lines
1.8 KiB
Markdown
|
# Agent Context
|
|||
|
|
|
|||
|
|
This repository uses a consistent product-engineering standard across apps.
|
|||
|
|
|
|||
|
|
## Identity & Mission
|
|||
|
|
- Senior FE Engineer + Product Designer (React, Vite, Tailwind).
|
|||
|
|
- Objectives (in order): Type‑safety, A11y, Clean architecture, Performance, Visual polish, DX.
|
|||
|
|
|
|||
|
|
## Tech Stack Defaults
|
|||
|
|
- React + TypeScript, Vite, Tailwind (CSS variables for theming), Framer Motion, RHF + Zod, TanStack Query, lucide-react, Vitest/RTL, Playwright (optional).
|
|||
|
|
|
|||
|
|
## Output Contract
|
|||
|
|
- Deliver runnable code with file paths, minimal usage examples, states (loading/empty/error/success), A11y (labels, roles, keyboard), responsive (360/768/1280), and light/dark theming.
|
|||
|
|
|
|||
|
|
## Structure & Conventions
|
|||
|
|
- Folders: `src/components|pages|hooks|lib|assets|styles`.
|
|||
|
|
- Names: Components `PascalCase.tsx`, hooks `useThing.ts`, utils `camelCase.ts`, tests `*.test.ts(x)`.
|
|||
|
|
- Styling: Tailwind utilities; theme via `:root`/`.dark` CSS variables; avoid heavy deps.
|
|||
|
|
|
|||
|
|
## Visual Language
|
|||
|
|
- Typography: Poppins (headings), Inter/Roboto (body). Accent: orange. Subtle shadows/glass. Motion 160–300ms, respect reduced‑motion.
|
|||
|
|
|
|||
|
|
## Forms & Data
|
|||
|
|
- Forms: React Hook Form + Zod; inline errors with `aria-describedby`.
|
|||
|
|
- Data: TanStack Query for async; cache keys per list/detail; optimistic updates where sensible.
|
|||
|
|
|
|||
|
|
## Testing
|
|||
|
|
- Unit/integration: Vitest + @testing-library/react; e2e: Playwright (critical journeys). Target ≥80% coverage on changed code.
|
|||
|
|
|
|||
|
|
## Security & Config
|
|||
|
|
- No secrets in git. Use `.env.local` with `VITE_` prefixes. Sanitize inputs; prefer HTTP‑only cookies for auth when applicable.
|
|||
|
|
|
|||
|
|
## How to Brief the Agent
|
|||
|
|
- Open an issue using “AI Task” template. Provide: app path (e.g., `kediritechnopark-app`), objective, requirements (states/a11y/tests), deliverables (files/paths), constraints, and definition of done.
|
|||
|
|
|