Add an Away Mode to backlog-burndown and Retire unattended-handoff - #3735

…nd Add a backlog-burndown Away Mode (#3736)

Promotes the changes merged into `develop` since promotion #3715 to
`main`.

- [#3704](#3704):
squash-merges a gate-met feature pull request through `pr_review.py
merge`, and the host-safety kit now owns its `autoMode` entries.
- [#3735](#3735) adds an
away mode to `backlog-burndown`:
- Parallel file-claimed rounds with no maintainer present, run by a lean
orchestrator.
- A group meeting a question parks behind a `decision` issue instead of
asking.
- Merges go only as far as the `develop`, `main` or `release` scope
named at invocation.
  - The end report names each held-back issue's real reason.

It also adds the attended `decision-triage` skill, which researches and
asks every open question at once, and retires `unattended-handoff`.
- [#3737](#3737) reads a
pull request that reads back closed after `pr_review.py merge`'s merge
call as a refusal that merged nothing, rather than as an unconfirmed
merge. It answers this promotion's first review round.

After the release, the host-safety installer re-run that #3704 needs is
still the maintainer's, per its handoff #3734. That handoff's step 3
names an `unattended-handoff` worker. That skill is retired here, so the
verification runs from a `backlog-burndown` worker instead.

Fixes #3375

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Re-vendor .github/skills from ProjectTemplate main at c175d557 through
carry.py apply. Every changed file matched a past hub revision, so
nothing local is overwritten. This adds decision-triage, which the hub
added to the baseline, and removes unattended-handoff, which the hub
retired into backlog-burndown's away mode (ptr727/ProjectTemplate#3735).

The AGENTS.md "Where the Rules Live" text that still names
unattended-handoff is re-vendored by the companion instruction-set
resync.

Audit run 2026-11-09T16:23:30Z | hub c175d557.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

## Summary

Part of a hub resync of this repository, per the hub's `RESYNC.md`
section 3 step 3 (verbatim re-vendors). It closes the `tree` and
`.markdownlint-cli2.jsonc` findings of audit run `2026-11-09T16:22:15Z |
hub c175d557`.

- Re-vendors `.github/skills/**` with `carry.py apply`. That refreshes
the stale skills, carries the new `decision-triage` skill, and prunes
`unattended-handoff`, which the hub retired in
ptr727/ProjectTemplate#3735.
- Re-vendors `.markdownlint-cli2.jsonc`, whose hub copy split its
comments into one sentence per line. The comment lines are the hub's
verbatim text, hence the `comments` label.

The tree is byte-identical to the hub's `.github/skills/` at `c175d557`.
The config is byte-identical to the hub's root copy.

## Merge Order

This lands together with two sibling resync pull requests, and all three
ride the same `develop -> main` promotion:

1. This pull request.
2. #667, the instruction-set resync. Its re-vendored `AGENTS.md` "Where
the Rules Live" routes to `decision-triage` and away mode, which only
this tree carries. In turn, this tree removes the `unattended-handoff`
skill the current `AGENTS.md` still names.
3. The intent-files resync (`chore/resync-intent-files`). Its
`.github/copilot-instructions.md` names `pr_review.py attest` and the
coverage reading this tree's `pr-review-conduct` relies on.

## Local Review

One recorded `local-strict-review` pass ran against this head. Its three
findings were all the cross-PR dependencies above, and the two sibling
pull requests resolve them.

🤖 Generated with [Claude Code](https://claude.com/claude-code)


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

<!-- coderabbit-ai-generated:v1 -->

## Summary by CodeRabbit

* **New Features**
* Added a guided decision-triage workflow for reviewing open questions,
gathering context, and recording maintainer decisions.
* **Documentation**
* Updated guidance for repository setup, code and documentation
standards, audits, pull requests, releases, and CI to clarify procedures
and verification expectations.
  * Expanded handoff guidance for tracking work and resuming sessions.
* **Removals**
  * Removed the unattended handoff workflow guidance.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

… and backlog-burndown (#4166)

Closes review gaps in four fleet skills, and gives the carried-table
bound its reason in `GOVERNANCE.md` and the Copilot instructions.

## Changes

- **`repo-worktree` "Preparing Git Hooks" (#3620 item 5).** The
pre-commit check is now one complete command: `test -x` and a `grep` for
the framework's own header, on the shared hook path. A non-framework
executable there no longer counts as the gate. It falls to the unchanged
next bullet: "A missing or wrong shared hook is reported to the
maintainer, not repaired from the worktree."
- **`drive-pr` (#3697).** A feature PR a peer merged mid-drive still
owes an outcome for each open finding. That covers unresolved threads
and every finding step 4 names, whether or not `merge` would refuse on
it, since `merge` never runs there. Step 3's `state=MERGED` path and
step 4's `next=cleanup` route both give those outcomes before `cleanup`
runs. A fix lands as a fresh feature -> develop pass.
- **`GOVERNANCE.md` "PR Review Etiquette", `pr-review-conduct` Merge
Gate item 2, and `.github/copilot-instructions.md` (#3620 item 3).**
Each gets two sentences on why the carried-table bound is the file set
rather than file recency, per the maintainer's answer on #3746.
- **`backlog-burndown` "The Promotion Boundary" step 5 (#3620 item 4).**
The displaced pull request waits until the next round dispatches, and
that round dispatches its fresh worker. That matches step 6 in an
attended run, and the away-mode promotion path, which has no freeze.
- Generated copies under `.github/skills/` and
`.claude-plugin/fleet-skills/` were regenerated with
`scripts/build_dist.py`.

## Item Dispositions

- **#3620 item 1** (`session-handoff` resume filter): already fixed. It
was consolidated into #4013 item 1 and landed in #4034. A comment now
counts as a round only by its whole archived shape.
- **#3620 item 2** (`unattended-handoff` picker): stale. That skill was
retired in #3735 and no longer exists.
- **#3620 item 3**: declined, as the maintainer decided on #3746. The
reason sentences it asked for are added above.
- **#3620 item 4**: it still stood on develop, since step 5's "then
dispatches" read as a dispatch during the freeze. Fixed above.
- **#3620 item 5**: it still stood on develop, since `test -x` accepted
any executable. Fixed above.
- **#3766**: already resolved on develop. `repo-worktree` "The Base
Branch" names "Creating a Worktree"'s return of the base clone to its
own working branch as the second exception. It applies where a
continuation finds the task branch checked out there. That landed in
#1685, so no edit was needed.
- **#3869**: parked behind decision #4167 and left out of this pull
request's closing line. A draft of #3869's own proposal was taken back
out of this branch. In it, the agent installs the hook in the base clone
on the maintainer's yes. Each local review round found a new cost in
that draft: chaining a foreign hook, a Husky.Net setting breaking other
worktrees, a hook failing on branches without the config, and a
dispatched worker either stalling its round or never reaching the
maintainer. The decision issue lays out the options.

## Verification

- `scripts/build_dist.py --check` reports the generated distributions
current. `spec/validate.py` passes.
- The prose gate and `repo_gate.py --check eol` are clean on every
commit.
- The hook check was run against a constructed repository. With no hook
it exits 1, with a foreign executable 1, and with a framework-header
hook 0. The header line was read from the pre-commit framework's own
hook template on this host.

Closes on promotion: #3620, #3697, #3766

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>