From a0fe47d4d384916d7c61c1b6e034b153eeb3c27f Mon Sep 17 00:00:00 2001 From: zosimovaa Date: Tue, 13 Oct 2026 23:17:01 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D0=BB=20?= =?UTF-8?q?=D1=82=D0=B8=D0=BF=D0=BE=D0=B2=D1=8B=D0=B5=20=D1=84=D0=B0=D0=B9?= =?UTF-8?q?=D0=BB=D1=8B=20=D0=BD=D0=BE=D0=B2=D0=BE=D0=B3=D0=BE=20=D0=BF?= =?UTF-8?q?=D1=80=D0=BE=D0=B5=D0=BA=D1=82=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- examples/project-bootstrap/AGENTS.md | 22 ++++++++++ examples/project-bootstrap/README.md | 41 +++++++++++++++++++ .../openspec/context/index.md | 17 ++++++++ 3 files changed, 80 insertions(+) create mode 100644 examples/project-bootstrap/AGENTS.md create mode 100644 examples/project-bootstrap/README.md create mode 100644 examples/project-bootstrap/openspec/context/index.md diff --git a/examples/project-bootstrap/AGENTS.md b/examples/project-bootstrap/AGENTS.md new file mode 100644 index 0000000..949c173 --- /dev/null +++ b/examples/project-bootstrap/AGENTS.md @@ -0,0 +1,22 @@ +# Инструкции для Codex + +## Навигация по контексту + +- Начинай с `openspec/context/index.md`, затем читай только документы, + относящиеся к текущей задаче. +- Перед архитектурными изменениями изучай применимые ADR со статусом `Accepted`. +- Не дублируй в проектном контексте функциональные требования из + `openspec/specs/`. +- Поддерживай индекс в актуальном состоянии, когда состав документов меняется. + +## OpenSpec + +- Для изменений используй workflow OpenSpec Change и Apply. +- При подготовке каждого change оценивай влияние на постоянный контекст проекта + и необходимость создать или обновить ADR и другие документы. +- Если документы контекста нужно изменить, добавляй проверяемые задачи в + `tasks.md` и выполняй их в рамках Apply. +- Если change добавляет, удаляет или переименовывает документы контекста, + обновляй `openspec/context/index.md`. +- Не принимай Proposed ADR самостоятельно. При конфликте запроса с принятым ADR + явно сообщи о нём и запроси решение владельца. diff --git a/examples/project-bootstrap/README.md b/examples/project-bootstrap/README.md new file mode 100644 index 0000000..a03bf45 --- /dev/null +++ b/examples/project-bootstrap/README.md @@ -0,0 +1,41 @@ +# Заготовки контекста проекта + +Этот каталог содержит стартовые файлы для проекта, использующего схему +OpenSpec `use-case-driven`. Схема не устанавливает их автоматически. Скопируйте +`AGENTS.md` и каталог `openspec/context/` в проект с сохранением относительной +структуры и адаптируйте их к его устройству. Этот README служит инструкцией для +комплекта и не предназначен для копирования поверх README проекта. + +В комплект входят: + +- `AGENTS.md` — навигация по проектному контексту и правила OpenSpec; +- `openspec/context/index.md` — карта постоянных документов проекта; +- `openspec/context/adr/README.md` — правила ведения ADR; +- `openspec/context/adr/ADR-template.md` — заготовка нового решения. + +После копирования проверьте и настройте пути в индексе. Добавляйте туда +проектные документы по мере появления; не дублируйте в Context функциональные +требования из `openspec/specs/`. Перед архитектурными изменениями читайте +применимые принятые ADR. + +`ADR-template.md` соответствует +`openspec/schemas/use-case-driven/templates/adr.md` в этом репозитории. При +изменении исходного шаблона обновляйте его копию здесь. + +После `openspec init` настройте в `openspec/config.yaml` проектные параметры +интеграции YouTrack в существующем блоке `context`, сохранив остальной контекст: + +```yaml +context: | + YouTrack project key: + YouTrack application label: +``` + +Укажите ключ проекта и имя приложения, которое должно записываться в тег каждой +задачи. Общие правила создания задачи, учёта времени и архивации берутся из +схемы `use-case-driven`. Добавьте также `operations.archive.guidance` из раздела +«Настройка YouTrack» в README схемы: OpenSpec загружает эту подсказку отдельно +при вызове `openspec instructions archive`. + +Заготовка не содержит готовых решений или описания бизнес-домена. ADR создаются +в проекте только для конкретных долгосрочных архитектурных решений. diff --git a/examples/project-bootstrap/openspec/context/index.md b/examples/project-bootstrap/openspec/context/index.md new file mode 100644 index 0000000..0f46a59 --- /dev/null +++ b/examples/project-bootstrap/openspec/context/index.md @@ -0,0 +1,17 @@ +# Индекс проектного контекста + +Используй этот файл как карту постоянных знаний проекта. Сначала определи по +задаче нужные документы и загружай их выборочно. Обновляй индекс при добавлении, +удалении или переименовании документов. + +| Путь | Назначение | Когда читать | +| --- | --- | --- | +| `../../README.md` | Обзор проекта и инструкции по запуску | При знакомстве с проектом или изменении его назначения | +| `../../AGENTS.md` | Правила работы Codex и навигации по контексту | В начале работы над задачей | +| `adr/README.md` | Правила оформления, принятия и замены ADR | При подготовке или пересмотре ADR | +| `adr/ADR-template.md` | Заготовка нового архитектурного решения | При создании ADR | +| `adr/ADR-[0-9][0-9][0-9][0-9]-*.md` | Архитектурные решения проекта | Перед архитектурными изменениями — читай только применимые принятые решения | + +Добавляй сюда другие документы постоянного контекста с кратким назначением и +условием чтения. Не переноси сюда функциональные требования: актуальные +требования находятся в `../specs/`, а планы изменений — в `../changes/`.