Files
openspec-schema/examples/project-bootstrap/AGENTS.md
T

48 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Инструкции для 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`.