Template
48 lines
3.1 KiB
Markdown
48 lines
3.1 KiB
Markdown
# Инструкции для 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
|
||
явно сообщи о нём и запроси решение владельца.
|
||
|
||
## Task Management
|
||
|
||
Для всех OpenSpec Changes используй скилл `task-tracker`.
|
||
|
||
Task tracker configuration:
|
||
|
||
- Project key: <KEY>
|
||
- Application label: <APP-NAME>
|
||
|
||
Lifecycle:
|
||
|
||
- Если пользователь передал ID задачи YouTrack для начала Explore/Propose или
|
||
change, используй эту задачу как контекст; новую задачу не создавай.
|
||
- При создании change без переданного ID создай или привяжи задачу после
|
||
содержательного proposal.
|
||
- При существенном изменении change синхронизируй существующую задачу.
|
||
- После каждого рабочего сеанса Apply синхронизируй фактическое время.
|
||
- Перед archive выполни финальную синхронизацию; после успешной архивации
|
||
закрой связанную задачу и создай коммит с изменениями change и русским
|
||
описанием в 4–7 слов. При ошибке archive задачу не закрывай и коммит не создавай.
|
||
- При повторном запросе или незавершённой синхронизации возобнови работу
|
||
с существующей связью, включая архивные changes.
|
||
|
||
Все операции управления задачами выполняй через скилл `task-tracker`.
|