Проекты

Проекты позволяют организовать сессии внутри workspace вокруг общей рабочей папки и контекста системного запроса. Каждая сессия, привязанная к проекту, наследует рабочую папку проекта и блок <project_context>, благодаря чему агент начинает каждый диалог с необходимым фоновым контекстом.

Как работают проекты

Проект — это папка внутри workspace, объединяющая связанные сессии вместе с активами и контекстом, которые они разделяют. В отличие от workspace, которые разделяют целые конфигурации, проекты находятся внутри workspace и переиспользуют его источники, скиллы и статусы.

Хранилище проектов

Проекты находятся внутри директории workspace:

~/.craft-agent/workspaces/{workspace-id}/projects/{project-slug}/
├── config.json     # Конфигурация проекта (имя, цвет, рабочая папка)
├── MEMORY.md       # Необязательная долговременная память проекта
└── assets/         # Файлы, доступные через манифест активов

Сессии ссылаются на проект по его projectId. При удалении проекта сессии сохраняются, но отвязываются от проекта.

Создание проекта

Просто попросите своего агента. Скажите что-нибудь вроде «создай проект под названием Alpha с рабочей папкой ~/code/alpha», и агент настроит его для вас.

Чтобы создать проект вручную:

1. Откройте навигатор Проекты в боковой панели
2. Нажмите Новый проект
3. Введите имя, выберите цвет акцента и укажите рабочую папку
4. Сохраните — проект появится в навигаторе и станет доступен в композиторе сессий

Привязка сессий к проекту

При создании новой сессии выберите проект в композиторе. Сессия затем:

• Использует рабочую папку проекта в качестве основной
• Получает блок <project_context> в системном запросе с именем проекта, описанием и манифестом активов
• Отображается в группе этого проекта в списке сессий и на доске Kanban

Вы также можете переместить существующую сессию в проект из меню сессии.

Контекст проекта

Каждая сессия, привязанная к проекту, получает блок <project_context> в верхней части своего системного запроса. Блок содержит:

• Имя и описание проекта
• Рабочую папку
• Отрывок из MEMORY.md (ограниченный по размеру)
• Манифест активов, перечисляющий файлы из папки проекта

Используйте MEMORY.md для устойчивого контекста — конвенций программирования, целей продукта, персонажей или чего-либо, что агент должен помнить между сессиями. Сохраняйте его сфокусированным; внедряемый отрывок ограничен по размеру, поэтому чрезмерно длинные файлы будут усечены.

# Project Memory

## Product goals
- Ship v2 of the reporting dashboard by end of quarter.
- Prioritise accessibility parity across all charts.

## Conventions
- All new components live in `src/components/` and use TypeScript.
- Tests use Vitest. Never commit `.only`.

## People
- Design lead: Sam. Ping on Slack for visual decisions.

Цвета акцента и внешний вид

Каждый проект имеет цвет акцента, который отображается в:

• Навигаторе проектов и списке сессий
• Карточках доски Kanban
• Заголовках сессий

Переключите оформление в настройках проекта, чтобы цвет акцента был ненавязчивым (только маркер) или выраженным (заливка карточек и заголовков).

Группировка и фильтрация

• Список сессий — группировать по проекту или фильтровать до одного проекта.
• Доска Kanban — фильтровать доску до одного проекта. Новые задачи, созданные при активной фильтре, автоматически наследуют этот проект.

Советы

Начинайте с одного проекта на репозиторий

Один проект на код-репозиторий — это естественный выбор: рабочая папка соответствует чётко, а MEMORY.md становится местом для специфичных для репозитория конвенций.

Поддерживайте MEMORY.md кратким и актуальным

Внедряемый отрывок ограничен по размеру. Удаляйте устаревшие заметки, чтобы агент получал самый свежий контекст на каждом шаге.

Используйте цвета акцента для быстрого просмотра

Выбирайте различные цвета акцента для проектов, с которыми вы работаете параллельно. Это делает список сессий и доску Kanban удобочитаемыми на первый взгляд.