Template
6.1 KiB
6.1 KiB
Инструкции для 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 явно сообщи о нём и запроси решение владельца.
Git-процесс OpenSpec Change
- Для каждой задачи используй одну feature-ветку от целевой ветки репозитория:
feature/<task-code>-<task-name>. Код бери из связанной задачи, имя — короткий ASCII slug в нижнем регистре с дефисами. Не переименовывай уже используемую ветку вслед за переименованием задачи. - Используй эту ветку для двух последовательных PR в одну целевую ветку. Обычный push разрешён только в feature-ветку; прямой push в целевую ветку, force push и изменение чужих веток запрещены.
- Первый PR содержит только артефакты планирования OpenSpec: proposal, delta
specs либо отметку
skip_specs: true, design, tasks и связанные метаданные. Не начинай и не публикуй реализацию до ручного слияния первого PR и отдельной команды владельца. - После открытия первого PR остановись. Владелец отдельно ревьюит и вручную сливает его, сохраняя feature-ветку. Одобрение или слияние сами по себе не разрешают продолжать: дождись явной команды владельца в этом чате.
- После команды проверь в Git, что первый PR действительно слит в целевую ветку. Если он ещё не слит, сообщи об этом и жди. После подтверждения обнови ту же feature-ветку из целевой и продолжай реализацию в ней.
- Второй PR содержит реализацию, применимые проверки, документацию и обновлённые задачи OpenSpec; добавь ссылку на задачу и первый PR. Для него требуется отдельное актуальное ревью и успешные обязательные проверки. Оба PR вручную сливает владелец.
- После запроса правок продолжай только по явной команде владельца. Закрытый без слияния PR останавливает процесс до отдельного решения владельца. Автоматическое слияние и продолжение по событиям Git не используются.
Task Management
Для всех OpenSpec Changes используй скилл task-tracker.
Task tracker configuration:
- Project key:
- Application label:
Lifecycle:
- Если пользователь передал ID задачи YouTrack для начала Explore/Propose или change, используй эту задачу как контекст; новую задачу не создавай.
- При создании change без переданного ID создай или привяжи задачу после содержательного proposal.
- При существенном изменении change синхронизируй существующую задачу.
- После каждого рабочего сеанса Apply синхронизируй фактическое время.
- Перед archive выполни финальную синхронизацию; после успешной архивации
закрой связанную задачу и создай коммит с изменениями change. Начинай сообщение
коммита с ключа связанной задачи, затем кратко опиши изменения по-русски:
CON-27 Правка тестов. При ошибке archive задачу не закрывай и коммит не создавай. - При повторном запросе или незавершённой синхронизации возобнови работу с существующей связью, включая архивные changes.
Все операции управления задачами выполняй через скилл task-tracker.