feat(auth,docs): add AGENTS guidelines, consistency kit, particle background, solid card, logo swap, header toggles, signup password rules, and phone input border fix
This commit is contained in:
35
docs/AGENT_CONTEXT.md
Normal file
35
docs/AGENT_CONTEXT.md
Normal file
@@ -0,0 +1,35 @@
|
||||
# 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.
|
||||
|
||||
Reference in New Issue
Block a user