К основному содержанию
правило CX Codex

backlog — правило для Claude Code: синхронизация задач

Правило синхронизирует статусы задач в BACKLOG.md и TASK_STATUS.md и задаёт условия для перехода в merged. Пригодится командам, которые ведут бэклог в этих файлах.

Apache-2.0 ★ 121 обновлён 2026-10-29

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/backlog.md
Открыть на GitHub

Что делает backlog

Правило требует отражать каждое изменение статуса в обоих файлах до конца хода и не добавлять задачу в Active Wave без соответствующей записи в TASK_STATUS.md. Статус merged требует записанного QA-доказательства. После правок автоматически запускается валидатор через хук PostToolUse; его вывод нужно проверить перед продолжением.

Для межрепозиторных блокировок используется поле Blocked by: и карта docs/REPO_MAP.md; это не то же самое, что Depends on: для задач внутри репозитория. ID задач идут по порядку, а снятые с использования ID повторно не назначают. Архивные задачи валидатор не сравнивает, поэтому активные задачи туда помещать нельзя.

Правило также запрещает указывать в критериях приёмки команды проверки или ожидаемый вывод, которые ещё не запускали: нужно привести наблюдаемый результат либо пометить проверку как UNEXECUTED. Путь для Claude Code — .claude/rules/backlog.md; правило рассчитано на работу с файлами бэклога и статусов.

Какие задачи решает

  • синхронизировать статусы в BACKLOG.md и TASK_STATUS.md
  • не допустить перехода в merged без QA-доказательства
  • проверить межрепозиторные блокировки перед слиянием
  • не повторно использовать снятый с учёта ID задачи
  • отмечать непроверенные команды в критериях приёмки

Примеры запросов агенту

  • Проверь, совпадают ли статусы задач в BACKLOG.md и TASK_STATUS.md.
  • Перед переходом задачи в merged проверь наличие QA-доказательства в TASK_STATUS.md.
  • Проверь Blocked by: для этой задачи и сопоставь репозитории через docs/REPO_MAP.md.

Как установить backlog

Вручную: положить файлы

.claude/rules/backlog.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о backlog

Как установить backlog в Claude Code?

Добавьте файл правила по пути .claude/rules/backlog.md в проекте.

Что делает правило backlog?

Оно задаёт правила синхронизации BACKLOG.md и TASK_STATUS.md, проверки QA перед merged и обработки межрепозиторных блокировок.

Чем Blocked by: отличается от Depends on:?

Blocked by: задаёт межрепозиторный барьер с проверкой через docs/REPO_MAP.md. Depends on: используют для зависимостей внутри того же репозитория.

Исходный текст

backlog.md · Apache-2.0
---
paths:
  - "BACKLOG.md"
  - "TASK_STATUS.md"
---

# Backlog and Task Status Rules

- Every status change in BACKLOG.md must be mirrored in TASK_STATUS.md active tasks (and vice versa) before the turn ends.
- Never set status to `merged` without QA evidence recorded in TASK_STATUS.md.
- Never add a task to BACKLOG.md Active Wave without a matching entry in TASK_STATUS.md.
- After any edit to these files, the validator runs automatically via PostToolUse hook — check its output before proceeding.
- Archived tasks in `## Wave N — Archived` are not compared by the validator; do not put active tasks there.
- Task IDs are sequential integers (T-NNN). Never reuse a retired ID.
- `- **Blocked by:** <repo>/T-NNN` declares a cross-repo merge gate: the validator resolves `<repo>` via `docs/REPO_MAP.md` and blocks (or warns) merge until the referenced task in that repo is `merged`. Do not confuse with same-repo `Depends on:`.
- No-blockers convention: when a task has no cross-repo blockers, either omit the `Blocked by:` field entirely or set it to the standard em-dash (`—`) or plain hyphen (`-`) placeholder — both are treated as "no blockers", never as `blocked_by_unresolvable`. The gate only evaluates `Blocked by:` at gated statuses (`ready_for_qa`, `qa_passed`, `merged`), so a genuinely malformed value will not be reported until the task reaches one of those statuses.
- `- **Hold:** <what> — <why> (<since>)` (DR-005) marks a task as deliberately held, never mandatory and its absence is never a finding. It may downgrade ONLY `blocked_by_open`, and never a FAILURE-severity finding — `merged` × unmerged-blocker stays FAILURE/exit 2 regardless. It can never touch `merged_missing_commit_field`, evidence-completeness, mirror/sync-status, duplicate-entry detection, `config_check`, or `stale_verified` — see `HOLD_DOWNGRADABLE_CHECKS` in `mavp-validator.js`, a whitelist, not a blacklist of protected checks.
- Never register a verification command, named mutant, or expected-output claim in acceptance criteria without executing it first — quote the observed output, or label it `UNEXECUTED — verify before relying`. See `docs/core/ORCHESTRATION_RULES.md` — "Executed-check rule" for the full rule, the fixture-vs-live-reproduction distinction, and why no mechanical enforcement exists.
- **Task-ID citation discipline (T-593)** — `getNextTaskId()` (`scripts/mavp-operator-lib.js`) scans both artifacts for the highest heading with an anchored `/^###\s+T-(\d+)/gm`: it only matches a real heading sitting at the very start of a line. After T-593, a backticked, **mid-line** citation of another task's heading — e.g. a mid-sentence, backticked example such as `T-900` quoted inside a Problem/Notes bullet — is SAFE and will never be scanned. The residual ban is narrower and still real: never write the literal shape `###` immediately followed by `T-` and digits as the FIRST characters of a line anywhere in `BACKLOG.md` or `TASK_STATUS.md`, including inside a fenced code block — the scan is line-based with no fence-tracking, so a line-initial match there is indistinguishable from a real heading and will mint a duplicate/jumped ID. A mint-time tripwire (non-blocking stderr warning naming both values) covers this fenced-block residual when it slips through; it is a safety net, not a license to write the shape carelessly.

© yahor-punko · Apache-2.0 · yahor-punko/mavericks-os

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
om-backlog open-mercato Скилл om-backlog превращает продуктовый бриф или спецификацию в дерево задач трекера: эпики, истории с критериями приёмки, подзадачи. Показывает дерево и ждёт подтверждения. CX Codex +1 2 300установок team-backlog sametcelikbicak Скилл team-backlog для Claude Code разбивает PRD на вертикальные тикеты с критериями приёмки и зависимостями. После согласования он записывает их в .team/03-backlog.md. CX Codex +1 ★ 71звёзд репо backlog-swipe-triage официальный James Montemagno Плагин backlog-swipe-triage для GitHub Copilot разбирает бэклог свайпами: назначить, запросить детали, отложить, закрыть или пропустить. Выручает, когда issues накопились и решать по каждой лень. ★ 41 430звёзд репо backlog-capture mvschwarz Скилл backlog-capture для Claude Code и ещё пяти агентных сред, который превращает сырые заметки в структурированные записи бэклога. Запускается после встреч и звонков, когда нужно быстро зафиксировать идею, не дать ей потеряться. CX Codex +1 ★ 8 928звёзд репо backlog-grooming VoltAgent Субагент backlog-grooming проводит ревизию продуктового бэклога: убирает устаревшие задачи, проверяет критерии готовности и подготавливает истории к спринту. CX Codex ★ 6 505звёзд репо backlog-plan microsoft Скилл backlog-plan планирует задачи в Azure DevOps, GitHub и Jira без изменения данных в трекере. Разбирает очереди, готовит спринты и формирует локальные файлы планов. CX Codex +1 ★ 1 627звёзд репо

Из того же набора16

Весь набор →
validate Скилл validate запускает валидатор MavP для сверки BACKLOG.md и TASK_STATUS.md. Помогает убедиться в синхронности задач перед началом работы. CX Codex +1 ★ 121звёзд репо product-docs Субагент product-docs создаёт и обновляет внутреннюю документацию проекта: спецификации агентов, шаблоны процессов, артефакты решений. CX Codex ★ 121звёзд репо technical-writer Субагент technical-writer операционной модели Mavericks для подготовки публичной документации. Пишет руководства, API-справочники и чейнджлоги, не трогая код проекта. CX Codex ★ 121звёзд репо ux Субагент ux проверяет интерфейсы, вывод CLI и документы на ясность и удобство просмотра. Даёт рекомендации, но не меняет файлы. CX Codex ★ 121звёзд репо ui-designer Субагент ui-designer для Claude Code читает Figma-файлы, извлекает токены, создаёт Code Connect-маппинги и экспортирует ассеты. Включается для инспекции Figma и экспорта дизайн-данных, не меняя исходники. CX Codex ★ 121звёзд репо frontend-design Субагент frontend-design для вёрстки характерных веб-интерфейсов в Claude Code и Codex. Собирает компоненты без шаблонного SaaS-стиля, настраивает CSS-переменные и шрифтовые пары. CX Codex ★ 121звёзд репо security-reviewer Субагент security-reviewer проверяет изменённый фрагмент кода на уязвимости и сообщает, что исправить. Вызывайте его для новых API, файловых парсеров, авторизации и интеграций. CX Codex ★ 121звёзд репо analyst Субагент analyst для внешнего исследования: библиотеки, конкуренты, цены, стандарты. Возвращает структурированный бриф для решения, а не просто ссылки. CX Codex ★ 121звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой