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

3.1 KiB
Raw Blame History

Инструкции для 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:
  • Application label:

Lifecycle:

  • Если пользователь передал ID задачи YouTrack для начала Explore/Propose или change, используй эту задачу как контекст; новую задачу не создавай.
  • При создании change без переданного ID создай или привяжи задачу после содержательного proposal.
  • При существенном изменении change синхронизируй существующую задачу.
  • После каждого рабочего сеанса Apply синхронизируй фактическое время.
  • Перед archive выполни финальную синхронизацию; после успешной архивации закрой связанную задачу и создай коммит с изменениями change и русским описанием в 4–7 слов. При ошибке archive задачу не закрывай и коммит не создавай.
  • При повторном запросе или незавершённой синхронизации возобнови работу с существующей связью, включая архивные changes.

Все операции управления задачами выполняй через скилл task-tracker.