[ptr727]

Implements the lessons from the first full decision-triage run (#3759), items 1-7. Items 6 and 7 follow the maintainer's answer comment on the issue.

Changes

• Research cost (item 1). Researchers take topic clusters of five or six questions. Step 3 states the researcher count and a token estimate before dispatching.
• Comment weighting (item 2). The researcher brief says to read every comment newest last. A later maintainer or evidence comment outranks the body's design, and a tool's or bot's own statement of its behavior counts as evidence.
• OVERTAKEN (item 3). The classifier runs a cheap history check (git log origin/main, the state of child issues, later decision comments) and can return OVERTAKEN. A fix that is only on develop is HELD awaiting promotion. Queued decision issues get the same check. A new step 6 offers to close overtaken issues.
• Public output and write bound (item 4). The brief says researcher output is posted publicly and may cite only the repository, its history, and GitHub state. Each subagent gets a scratch directory of its own and writes nothing to the repository or GitHub.
• Coupled questions (item 5). Questions linked by a BLOCKS line, or whose fixes edit the same section, go in one prompt within the age order, with a split rule.
• deferred label (item 6). Declared in repo-config/labels.json and described in repo-config/README.md "Labels". decision-triage applies it on a "not yet" answer. The classifier and backlog-burndown skip it and report it by count.
• Agent-safety approval (item 7). A maintainer-sourced approval comment lets an attended run implement and drive an agent-safety edit. The merge still waits on a per-PR go-ahead given after reading the diff. backlog-burndown's merge grant is carved out for these PRs, and away mode still holds every such edit.
• Regenerated .github/skills/ and .claude-plugin/ with build_dist.py.

Local Review

Three frontier passes ran. Two edit rounds fixed 13 of round 1's 15 findings and 4 of round 2's 5. Findings declined with evidence:

• Re-reading each deferred condition every round: the maintainer's answer specifies skip and count-only reporting.
• Holding a promotion on a "not yet" decision: that hold is what "not yet" means.
• A GOVERNANCE wording clash with "deferred": GOVERNANCE's "asked once and deferred" means the asking was put off, a case step 7 keeps labelled.

A follow-up push with its own budget fixed the final pass's three introduced findings:

1. A gated agent-safety group ends as stopped on a maintainer-only question, so "Raising a Blocked Question" asks for the merge go-ahead. A resumed worker's brief then carries that go-ahead for the pull request.
2. The classifier brief states how a kept-open comment reads.
3. A queued decision HELD awaiting promotion leaves the queue and stays open. The first triage after the promotion then returns it as OVERTAKEN.

The pass over 7751a2d found nothing (COUNT 0) and is recorded.

Pre-existing findings, filed

• .agents/skills/backlog-burndown/SKILL.md "Ranking" (pre-existing): an attended run applies no agent-safety hold to an unapproved issue. Filed as Hold Unapproved Agent-Safety Issues in an Attended backlog-burndown Run #3761.

After Merge

• Run repo-config/configure.sh apply ptr727/ProjectTemplate to create the deferred label. Note this run also reasserts settings and rulesets, so it runs from current main or develop.
• Label Add safety hooks for opencode and codex #781, Generate the Qodo Settings Repository From the Hub So Fleet Rules Are Authored Once and Auditable #1464 and Hand a Variable Set of Environment Values to a Hub Task's Hook Instead of Named Pairs #2174 deferred.

Refs #3759

🤖 Generated with Claude Code

[coderabbitai]

Important

• Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

• Source mode: Auto
• Repository: ptr727/ProjectTemplate
• Branch: decision-triage-first-run-3759
• File: .coderabbit.yaml
• Commit: af43ea2
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Advanced
• Run ID: fa37438f-58e8-418d-a8d7-24dbb1c83e83

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

• X
• Mastodon
• Reddit
• LinkedIn

[Copilot]

🟡 Changes recommended

Several active documentation issues remain, including an unsafe attended dispatch path, an undefined worker outcome, and incomplete decision-triage transitions that could leave work blocked or misclassified.

5 open issues

• Apply the maintainer gate before attended-work dispatch · New
• Define the outcome when an agent-safety gate stops work · New
• Define how held decisions are rechecked after promotion · New
• Teach classifiers how to handle partially settled overtaken work · New
• Clarify when an overtaken issue must remain open · New

What changed in this PR

This pull request improves the decision-triage and backlog-burndown workflows based on their first full run, adding deferred decisions, history checks, clustered research, coupled-question handling, and agent-safety approval gates. It also regenerates the distributed skill files and source digests.

Changes:

• Adds and documents the deferred label and its triage/backlog behavior.
• Adds OVERTAKEN/HELD handling, improved evidence weighting, research constraints, and coupled-question ordering.
• Adds agent-safety approval and merge restrictions.
• Regenerates GitHub, Claude, and canonical skill distributions.

Five unresolved review findings remain, including an attended-path agent-safety bypass, incomplete gated and HELD outcomes, missing classifier handling for partial overtakes, and unclear overtaken-issue wording.

This pull request requires changes.

File	Description
repo-config/​README.md	Documents the new deferred label and backlog behavior.
repo-config/​labels.json	Declares the fleet-wide deferred label.
.github/​skills/​decision-triage/​SKILL.md	Regenerated GitHub Copilot decision-triage distribution.
.github/​skills/​backlog-burndown/​SKILL.md	Regenerated GitHub Copilot backlog-burndown distribution.
.claude-plugin/​fleet-skills/​skills/​decision-triage/​SKILL.md	Regenerated Claude decision-triage distribution.
.claude-plugin/​fleet-skills/​skills/​backlog-burndown/​SKILL.md	Regenerated Claude backlog-burndown distribution.
.claude-plugin/​fleet-skills/​.source-digests/​decision-triage	Updates the decision-triage source digest.
.claude-plugin/​fleet-skills/​.source-digests/​backlog-burndown	Updates the backlog-burndown source digest.
.agents/​skills/​decision-triage/​SKILL.md	Canonical decision-triage procedure and brief updates.
.agents/​skills/​backlog-burndown/​SKILL.md	Canonical backlog and agent-safety workflow updates.

_{Review effort: Lite}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.31%. Comparing base (4b7c352) to head (af43ea2).

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #3760   +/-   ##
========================================
  Coverage    82.31%   82.31%           
========================================
  Files           28       28           
  Lines         9438     9438           
========================================
  Hits          7769     7769           
  Misses        1669     1669           

Flag	Coverage Δ
python-3.13	82.31% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[ptr727]

A recorded local strict-review pass covers head 7751a2d1baceac4621b969c99d38da15fbcf025b, the content this pull request carries at that commit against develop, and it recorded 0 findings.

[ptr727]

A recorded local strict-review pass covers head af43ea2eea7a58820d68c87bd44e151e28b60c38, the content this pull request carries at that commit against develop, and it recorded 0 findings.