Напишите файл контекста (AGENTS.md)

Самое высокорычажное, что вы можете сделать, — написать файл контекста, который AI читает автоматически. Разные инструменты ищут разные имена — AGENTS.md, CLAUDE.md, .cursorrules или .github/copilot-instructions.md, — но идея идентична: живой документ, который рассказывает AI, как работает ваш проект и как вы хотите, чтобы он себя вёл.

Без него AI гадает. С ним AI перестаёт переформатировать ваш код, перестаёт изобретать библиотеки, которые вы не используете, и перестаёт заново объяснять решения, которые вы уже приняли. Думайте о нём как об онбординг-документации для нового товарища по команде, который гениален, но между сессиями страдает полной амнезией, — всё, что нужно ему для продуктивности, должно лежать там, где он прочитает это каждый раз.

Практичный стартовый файл:

# Project: Invoice Manager

## What this is
A small web app for freelancers to create and track invoices.

## Tech stack
- TypeScript + React (Vite)
- Tailwind for styling
- SQLite via Prisma
- Vitest for tests

## Commands
- Install: `npm install`
- Run dev server: `npm run dev`
- Run tests: `npm test`
- Lint: `npm run lint`

## Conventions
- Use functional components and hooks; no class components.
- Keep components small; one component per file.
- Write a test for every new function in `src/lib`.
- Never edit files in `src/generated/` — they are auto-generated.

## Don'ts
- Don't add new dependencies without flagging it first.
- Don't commit secrets; use environment variables.

Держите его коротким и держите его актуальным. Файл контекста, разросшийся до тысячи строк, перестаёт читаться внимательно — и вами, и моделью, — так что обрезайте его так же агрессивно, как и дополняете. Когда AI раз за разом делает одно и то же неверное предположение — это ваш сигнал добавить строку; когда правило больше не соответствует реальности, удалите его, прежде чем оно начнёт активно вводить агента в заблуждение.

Несколько паттернов отличают работающий файл контекста от игнорируемого:

• Будьте конкретны и точны. «Используй наши соглашения» бесполезно. «Для валидации используй zod; мы не используем yup» — правило, которому AI реально может следовать.
• Произносите «нельзя» так же громко, как «нужно». Модели рвутся помочь, а значит, охотно добавят зависимость или перепишут конфиг, если вы не запретите.
• Указывайте на примеры. «Соответствуй стилю src/features/invoices» даёт AI конкретный образец для копирования вместо расплывчатой инструкции для толкования.

Относитесь к файлу контекста как к записи каждого урока, который иначе вам пришлось бы повторять. Это самая дешёвая и самая долговечная инвестиция во всей этой главе.