ПОЛНАЯ ИНСТРУКЦИЯ / v1

Карта проекта,
которая не даст запутаться.

Аннотация для владельца проекта: что делает каждый файл, в каком порядке работает система, что сохраняет Git и как продолжить работу с другим агентом.

Начать за 7 шагов ↓Открыть карту файлов

СОДЕРЖАНИЕ01 Что это 02 Быстрый старт 03 Карта файлов 04 Жизненный цикл 05 Расширения 06 Git и секреты 07 Восстановление

01 — НАЗНАЧЕНИЕ

Это файловая память проекта,
а не ещё один фреймворк.

Starter Kit раскладывает цель, правила, состояние, решения и историю по небольшому набору понятных Markdown-файлов. Поэтому проект можно восстановить без старого чата и продолжить с другим совместимым агентом.

Главный принципЧат помогает работать сегодня. Файлы объясняют проект завтра. Git подтверждает, что именно изменилось.

MASTER

Чистый шаблон

Публикуемая копия не содержит данных реального проекта и журналов сопровождения самого шаблона.

PROJECT

Рабочая копия

После START и ПРИМЕНИТЬ плейсхолдеры становятся проверяемой памятью с указанием источников данных.

02 — БЫСТРЫЙ СТАРТ

Семь шагов до готового проекта.

Скопируйте содержимое

Все файлы Starter Kit должны лежать прямо в корне нового проекта, без дополнительной вложенной папки.

Откройте корень в AI-агенте

Агент должен видеть README.md, AGENTS.md, docs/, prompts/, src/ и outputs/ в одной открытой директории.

Отправьте START

Команда пишется отдельным сообщением. Агент покажет краткую карту системы и проверит структуру без изменений.

Выберите режим START

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

Проверьте сводку

Агент покажет источники данных, принятые правила, отложенные вопросы, заблокированные действия и уровень готовности.

Отправьте ПРИМЕНИТЬ

Команда записывает сводку выбранного режима в документы, но не разрешает GitHub, публикацию или deploy.

Начните безопасную работу

Внутреннюю работу можно начать сразу после отчёта. Git подключается только после отдельной проверки контрольных точек.

С сопровождением

Рекомендуемый тест: зачем нужен ответ, варианты, последствия, рекомендация и возможность решить позже.

Быстрый

Только основные факты и отклонения. Остальные безопасные настройки принимаются одной сводкой.

Без брифа

Агент изучает проект, фиксирует основания и возвращается к вопросу только перед связанным действием.

Важно

Агент отличает ответ пользователя от вывода из файлов и временного значения. Неизвестное разрешение на рискованное действие всегда означает запрет.

03 — КАРТА ФАЙЛОВ

У каждого знания — один адрес.

Такой порядок уменьшает дублирование: стабильное лежит в контексте, текущее — в статусе, причины — в решениях, история — в сессиях и Git.

ROOT

Файлы управления

README.mdГлавная инструкция для человека

Объясняет замысел, команды, Git, безопасность и порядок работы. Начинайте знакомство отсюда.

AGENTS.mdКанонические правила для AI

Определяет порядок чтения, автономность, запреты, закрытие сессии и режим чистого мастер-шаблона.

CLAUDE.mdСовместимый указатель

Направляет совместимого агента к AGENTS.md, чтобы не создавать второй набор конфликтующих правил.

.gitignoreГраница Git

Исключает секреты и системные метаданные. Дополнительные исключения подтверждаются во время START.

.env.exampleКарта переменных

Показывает только безопасные имена настроек. Реальные токены и пароли сюда не записываются.

DOCS

Память проекта

docs/PROJECT_QUESTIONNAIRE.mdНастройка и её прогресс

Хранит ответы, выводы из файлов, безопасные значения и отложенные решения всех 13 блоков.

docs/PROJECT_CONTEXT.mdПаспорт проекта

Стабильная цель, аудитория, границы, языки, технологии, пути и критерии готовности.

docs/PROJECT_POLICY.mdДействующие правила

Реестр статусов, источников решений и действий, которые ждут подтверждения пользователя.

docs/STATUS.mdТекущий снимок

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

docs/INTEGRATIONS.mdSkills, плагины и MCP

Источники, версии, область действия, способ восстановления и проверка расширений без credentials.

docs/GIT_POLICY.mdПравила Git и GitHub

Приватность, remote, ветка, состав commit, крупные файлы и условия безопасного push.

docs/BACKUP.mdМодель резервирования

Что действительно попадает в GitHub, что остаётся вне Git и как проверить полноту копии.

docs/SECRETS.mdКарта восстановления секретов

Хранит имена и места восстановления, но никогда не хранит значения ключей, токенов и паролей.

docs/RECOVERY.mdПорядок восстановления

Строгий маршрут для нового агента после clone, смены аккаунта или длительного перерыва.

docs/INITIALIZATION_REPORT.mdОтчёт первого запуска

Показывает режим START, источники данных, уровень готовности и оставшиеся контрольные точки.

docs/CHANGELOG.mdИзменения для пользователя

Фиксирует только заметные изменения продукта и не дублирует техническую историю Git.

docs/decisions/Причины важных решений

Отдельные записи о существенном выборе, последствиях, рисках и способе отката.

WORK

Работа и результаты

src/Основная рабочая зона

Код, тексты, исследования, данные или другие исходные материалы конкретного проекта.

outputs/Готовые результаты

Документы, изображения, сборки и другие артефакты, которые являются результатом работы.

logs/sessions/Краткая история сессий

Запрос, результат, проверки, решения, риски и следующий шаг — без копии всего чата и терминала.

prompts/00–07Сценарии жизненного цикла

START, инициализация, аудит, Git, начало работы, рабочая сессия, закрытие и восстановление.

AI ЧИТАЕТAGENTS→POLICY→CONTEXT→INTEGRATIONS→STATUS

04 — ЖИЗНЕННЫЙ ЦИКЛ

От первого START до нового агента.

01START

Ориентация

Агент читает структуру, определяет состояние и предлагает три режима настройки.

02НАСТРОЙКА

13 блоков

Тест, быстрые ответы или анализ без брифа охватывают одни и те же правила разным способом.

03ПРИМЕНИТЬ

Запись сводки

Документы получают ответы, обоснованные выводы, безопасные значения и явные контрольные точки.

04РАБОТА

Задачи и проверки

Контекст дополняется по мере работы, а нерелевантные открытые вопросы не мешают текущей задаче.

05закрываем сессию

Память и backup

Статус, лог, проверки, secret scan, размеры, commit и обычный push в приватный origin.

06RECOVERY

Продолжение

Новый агент восстанавливает состояние по локальным файлам до любых изменений.

05 — ИНТЕРФЕЙС

Три команды, которые стоит помнить.

START

Обзор и настройка нового проекта. Повторный START после инициализации только показывает краткий статус.

ПРИМЕНИТЬ

Записывает сводку выбранного режима и запускает аудит. Не создаёт GitHub и не выполняет внешние действия.

закрываем сессию

Обновляет память, проверяет безопасность и размеры, создаёт commit и выполняет обычный push.

Команды срабатывают только как отдельное сообщение. Обычное упоминание фразы ничего не запускает.

06 — ПЕРЕНОСИМОСТЬ

Skills, плагины и MCP:
код переносится, доступы — нет.

Единый реестр docs/INTEGRATIONS.md отвечает на четыре вопроса: что нужно проекту, где источник, какая версия и как проверить работу после clone.

Тип	Обычный путь	Что хранит Git	Что восстановить отдельно
`Project Skill`	`.agents/skills/<имя>/`	`Да: SKILL.md и ресурсы`	`Зависимости и доступы`
`User Skill`	`Пользовательский каталог агента`	`Нет: в реестре только источник и версия`	`Повторная установка`
`Project Plugin`	`Исходники + project marketplace`	`Да, если принадлежит проекту`	`Установка, кэш и OAuth`
`Project MCP`	`.codex/config.toml`	`Да: только безопасная конфигурация`	`Доверие, зависимости и авторизация`
`Global MCP`	`Конфигурация компьютера/аккаунта`	`Нет: в реестре инструкция`	`Глобальная настройка и вход`

Project Skills

Храните в .agents/skills/, если они принадлежат проекту. Не создавайте каталог, если Skills не нужны.

Plugins

Исходники можно сохранить, но установку и авторизацию нужно повторить в поддерживаемом клиенте.

Project MCP

Проверяйте .codex/config.toml перед доверием к проекту. Секретные значения передавайте через окружение.

Health check

Для каждого обязательного расширения укажите короткую проверку. «Файл существует» не всегда значит «сервис работает».

07 — BACKUP

Git хранит историю смысла,
а не секреты и случайный кэш.

В GIT

исходники и документы;
невоспроизводимые данные и результаты;
проектные Skills и безопасные конфигурации;
решения, статусы и session logs.

ВНЕ GIT

токены, пароли и private keys;
OAuth-сессии и credentials;
системные метаданные;
согласованный кэш и воспроизводимые зависимости.

Репозиторий по умолчанию приватный. Перед commit агент проверяет состав, секреты и файлы от 50 MiB. Большой файл всегда требует решения владельца.

08 — ВОССТАНОВЛЕНИЕ

Новый clone. Новый агент.
Тот же понятный проект.

01
Проверьте ветку, последний commit, приватный origin и чистоту рабочей папки.
02
Дайте агенту prompts/07-recovery.md. До отчёта реконструкции он ничего не изменяет.
03
Восстановите секреты из защищённого хранилища по карте docs/SECRETS.md.
04
Восстановите обязательные Skills, плагины и MCP по docs/INTEGRATIONS.md, затем выполните проверки.
05
Сверьте цель, границы, последнее состояние, риски и первый безопасный следующий шаг.

09 — ВОПРОСЫ

Что чаще всего вызывает путаницу.

Почему часть файлов пустая?+

Это чистый мастер-шаблон. PROJECT_CONTEXT, STATUS и отчёт инициализации заполняются только данными нового проекта после START и ПРИМЕНИТЬ.

Можно не проходить бриф?+

Да. Выберите режим «Без брифа». Агент изучит файлы, предложит безопасную конфигурацию и отложит вопросы до момента, когда ответ действительно понадобится.

Можно сразу дать агенту рабочую задачу?+

Сначала выберите режим START и отправьте ПРИМЕНИТЬ. После этого безопасная внутренняя работа разрешена даже при отложенных низкорисковых вопросах.

Нужно ли использовать все Skills и плагины?+

Нет. По умолчанию обязательных расширений нет. Добавляйте только те, без которых конкретный проект действительно не работает.

Почему Git не копирует буквально каждый байт папки?+

Секреты всегда исключаются, системные метаданные не являются данными проекта, а кэш и воспроизводимые зависимости могут зря раздувать копию. Политика фиксируется во время START.

Что произойдёт с большим файлом?+

До commit агент покажет путь, размер и варианты. Git LFS, сжатие, внешнее хранилище или исключение применяются только после вашего решения.

Можно сделать репозиторий публичным?+

Starter Kit по умолчанию требует отдельный приватный репозиторий. Публичная публикация — самостоятельное внешнее действие и не входит в закрытие сессии.

ГОТОВЫ НАЧАТЬ?

Скопируйте Starter Kit.
Напишите START.

Пройдите понятный тест, выберите быстрый режим или начните без брифа.

Открыть GitHub ↗Вернуться к презентации

Карта проекта,которая не даст запутаться.

Это файловая память проекта,а не ещё один фреймворк.