backlog — правило для Claude Code: синхронизация задач
Правило синхронизирует статусы задач в BACKLOG.md и TASK_STATUS.md и задаёт условия для перехода в merged. Пригодится командам, которые ведут бэклог в этих файлах.
Apache-2.0 ★ 121 обновлён 2026-10-29
.claude/rules/backlog.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/backlog.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/backlog.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/backlog.mdВручную: положить файлы
.clinerules/backlog.mdПо шагам, с командами для каждой платформы: 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