feat: update for agent
This commit is contained in:
51
AGENTS.md
Normal file
51
AGENTS.md
Normal file
@@ -0,0 +1,51 @@
|
||||
# AGENTS.md
|
||||
|
||||
Универсальный одностраничный лендинг-шаблон (shadcn + Payload-ready) для любого продукта/бизнеса. Композиция секций собрана в `src/app/page.tsx`; каждая секция — отдельный widget.
|
||||
|
||||
## Project Specifics
|
||||
|
||||
- `src/app/page.tsx` — только композиция: `Header` + секции в `<main>` + `Footer`. Не превращай его в монолит, добавляй/убирай секции, а не код блоков.
|
||||
- Каждая секция лендинга — самостоятельный widget в `src/widgets/*-section.tsx`; правь нужную секцию точечно.
|
||||
- Базовые UI-примитивы shadcn — в `src/shared/ui/*` (vendored, не переписывай).
|
||||
- Проверка после правок: `pnpm lint` и `pnpm build`.
|
||||
|
||||
## Design System
|
||||
|
||||
Источник токенов — `src/app/globals.css` (`@theme` + `:root`/`.dark`). Шрифт — Roboto Flex (`--font-roboto-flex`). Работай через семантические классы Tailwind (`bg-primary`, `text-muted-foreground`, `border`), не хардкодь hex/oklch.
|
||||
|
||||
**Важно — это нейтральная база.** Токены сейчас grayscale (монохром, `--radius` 0.625rem) — дефолтная shadcn-тема без характера. Это значит главный риск шаблона — **дженерик «AI-лендинг»**, который выглядит как все остальные. Поэтому:
|
||||
|
||||
- **Сначала задай направление.** Под конкретный продукт выбери осознанную эстетику и зашей её в **токены** `globals.css` (`--primary`, `--secondary`, `--accent`, `--radius`, типографику) — а не точечными классами по секциям. Тогда все секции автоматически становятся on-brand.
|
||||
- **Расширяй личность, а не сбрасывай в дефолт.** Если у проекта уже задан характер — держи его консистентно во всех секциях.
|
||||
|
||||
| Роль | База (neutral) | Назначение |
|
||||
|---|---|---|
|
||||
| `background` / `foreground` | white / near-black | фон и текст |
|
||||
| `primary` | near-black | основные CTA, акценты |
|
||||
| `secondary` / `muted` | light gray | вторичные поверхности, приглушённый текст |
|
||||
| `accent` | light gray | подсветки (задай ярче под бренд) |
|
||||
| `border` / `ring` | gray | границы, фокус |
|
||||
|
||||
Do / Don't:
|
||||
- **Do:** определять тему через токены; держать единый ритм отступов/типографики между секциями; контент-first (оффер, доказательства, цена).
|
||||
- **Don't:** оставлять монохром-дефолт «как есть» под реальный продукт; хардкодить цвета мимо токенов; стакать секции без выбранного направления — это и есть «одинаковый AI-лендинг».
|
||||
|
||||
## File Map
|
||||
|
||||
Композиция: `src/app/page.tsx` → `Header` + секции + `Footer`.
|
||||
|
||||
| Блок | Widget |
|
||||
|---|---|
|
||||
| Шапка | `src/widgets/header.tsx` |
|
||||
| Hero | `src/widgets/hero-section.tsx` |
|
||||
| Features | `src/widgets/features-section.tsx` |
|
||||
| Stats | `src/widgets/stats-section.tsx` |
|
||||
| How it works | `src/widgets/how-it-works-section.tsx` |
|
||||
| Comparison | `src/widgets/comparison-section.tsx` |
|
||||
| Gallery | `src/widgets/gallery-section.tsx` |
|
||||
| Social proof | `src/widgets/social-proof-section.tsx` |
|
||||
| Team | `src/widgets/team-section.tsx` |
|
||||
| Pricing | `src/widgets/pricing-section.tsx` |
|
||||
| FAQ | `src/widgets/faq-section.tsx` |
|
||||
| CTA | `src/widgets/cta-section.tsx` |
|
||||
| Footer | `src/widgets/footer.tsx` |
|
||||
Reference in New Issue
Block a user