[ptr727]

Summary

Resyncs the carried instruction-set sections and the fleet skills tree from ptr727/ProjectTemplate at hub 9f3e03c, steps 1 and 3 of the hub's RESYNC.md. The two land together because the skills carry generated include regions copied from these same GOVERNANCE.md and AGENTS.md sections. Also, Copilot reviews with the head branch's fleet-code-review skill.

• AGENTS.md: re-vendors the "Where the Rules Live" verbatim section.
• GOVERNANCE.md: re-vendors the verbatim sections the audit reports as matching a past hub revision. They are "Repository Boundaries and Write Safety", "Representative Data in Agent-Authored Text", "Git and Commit Rules", "Operational Repositories", "Hub-Hosted Tooling", "Documentation Style Conventions", "Verification Discipline", "Design Before Code", "PR Review Etiquette", "Communicating with the User", "Workflow YAML Conventions", and "Editor and Tasks".
• .github/skills/: refreshes every stale carried skill, adds decision-triage, and prunes unattended-handoff, which the hub retired into backlog-burndown's away mode.
• CODESTYLE.md and .github/copilot-instructions.md: the carried lines the refreshed skills include or restate take the hub text. Those are the General "Command-Line Arguments" and env-file naming bullets, and the runbook's Merge Gate paragraph. The repository's own CODESTYLE sections and its Disproved Claims entries are unchanged.
• CODESTYLE.md "PlexCleaner Python Conventions" and RegressionTests/README.md: say CI runs ruff at the version the hub validator pins, beside the latest mypy and coverage, which is what the validator at this repository's pin runs and what the refreshed python-codestyle profile states.
• .gitignore: lists .vscode/settings.json, which the re-vendored "Editor and Tasks" section requires of a repository shipping Python.
• .prose-gate.json: lists .vscode/settings.json under hub_hosted. This repository tracked that file once, so the prose gate's dead-path rule reads the byte-locked "Editor and Tasks" mention as stale. The hub-side defect is recorded on GOVERNANCE.md Editor and Tasks Names .vscode/settings.json to Forbid It, Which Every Carrier That Ever Deleted That File Reads as a Dead Path ProjectTemplate#1612, whose reopening is the maintainer's call.

Verification

• spec/audit.py --branch develop PlexCleaner (audit run 2026-11-10T01:35:50Z, hub 9f3e03cf) classified every re-vendored section and skill file as stale, so none holds a local edit. The pruned skill is byte-identical to a past hub revision.
• carry.py apply-sections touched only the declared verbatim regions and asserted the rest of each file byte-identical. carry.py apply reports the skills tree digest equal to the hub's, and diff -rq against the hub's .github/skills is empty.
• No .github/skills path named by .github/copilot-instructions.md changes.
• The prose gate passes over the full diff, both at hub main and at the validate-task.yml pin. The pre-commit markdownlint and CSpell runs are clean.
• Three recorded local strict review passes cover the head. Their findings are fixed in this change, filed, or listed below.

The rest of the intent-fidelity drift the audit reports, in AUDIT.md and .editorconfig-checker.json, is left for a separate change.

Pre-existing findings, filed

• RegressionTests/synthetic/inject_cc_sei.py and inject_hdr10plus_sei.py, correctness: neither answers --help nor refuses an unknown argument, per the carried "Command-Line Arguments" rule. Filed as Answer --help and Refuse Unknown Arguments in the Synthetic SEI Inject Scripts #1241.

Pre-existing findings, filed at the hub

The local passes raised these against carried hub skill text this repository cannot edit. All three are filed as ptr727/ProjectTemplate#4023.

• .github/skills/session-handoff/SKILL.md step 0, carried-content gap: a session's fresh hub clone under the worktrees directory has no removal step.
• .github/skills/decision-triage/SKILL.md and .github/skills/backlog-burndown/SKILL.md, carried-content gap: a deferred issue whose condition is checkable state is never re-checked by any seat.
• .github/skills/backlog-burndown/SKILL.md away scope develop, carried-content gap: a run ending on a failed dispatch or a session end opens no promotion pull request and reports nothing about it.

🤖 Generated with Claude Code

[ptr727]

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

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

• Source mode: Auto
• Repository: ptr727/PlexCleaner
• Branch: resync/instruction-sections
• File: .coderabbit.yaml
• Commit: aef4146
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Advanced
• Run ID: 862c855e-c687-4d78-b185-ab36c2761e7a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• Trigger review

Finishing Touches

Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• 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

[qodo-free-for-open-source-projects]

PR Summary by Qodo

Resync fleet instructions and skills with the hub

📝 Documentation ✨ Enhancement ⚙️ Configuration changes 🕐 40+ Minutes

AI Description

• Re-vendors carried rules and skills together so generated includes match their source sections.
• Adds decision triage and moves unattended backlog work into backlog-burndown’s away mode.
• Aligns related style and review guidance, and exempts ignored VS Code settings from prose
 checking.

Diagram

graph TD
  Hub["ProjectTemplate hub"] --> Rules["Carried rules"] --> Skills["Fleet skills"] --> Agents["Fleet agents"]
  Hub --> Style["Style guidance"] --> Skills
  Rules --> Gate["Prose gate"]

Loading

High-Level Assessment

Keep the section-scoped and whole-skills-tree resync together: the skills embed text from the carried sections, and the tree is intended to match the hub. A full instruction-file overwrite would risk repository-specific content; independently editing carried skills would create drift.

Files changed (31) +1483 / -509

Enhancement (2) +809 / -94

SKILL.mdAdd away mode to backlog burndown +562/-94

Add away mode to backlog burndown

• Extends round planning, file claims, cleanup, issue accounting, and promotion handling. Incorporates unattended execution with scoped merge permissions, decision parking, and a generated decision-triage rule include.

.github/skills/backlog-burndown/SKILL.md

SKILL.mdAdd attended decision triage +247/-0

Add attended decision triage

• Introduces classification and research of open questions before unattended backlog work. Defines how to record decisions, ask the maintainer, handle deferred answers, and report remaining work.

.github/skills/decision-triage/SKILL.md

Documentation (28) +671 / -415

copilot-instructions.mdAlign Copilot coverage and local-pass guidance +1/-1

Align Copilot coverage and local-pass guidance

• Clarifies coverage tables for files without changed lines and when review policy permits a local pass. Documents how excluded files, Copilot refusals, and repository policy affect the merge gate.

.github/copilot-instructions.md

SKILL.mdRefresh conduct triggers and generated rules +16/-21

Refresh conduct triggers and generated rules

• Shortens the skill trigger and updates included verification and user-communication rules, including finding follow-up and where user-run commands belong.

.github/skills/agent-conduct/SKILL.md

SKILL.mdClarify audit skill trigger +10/-1

Clarify audit skill trigger

• Rewords the audit description while retaining its hub-context, read-only measurement role.

.github/skills/audit-a-repo/SKILL.md

SKILL.mdClarify operational-repository commits +22/-16

Clarify operational-repository commits

• Documents in-place develop commits, the guard-policy prerequisite, and commit-message issue references that promotion pull requests convert into closing keywords.

.github/skills/branching-and-release-model/SKILL.md

SKILL.mdTighten carried-file guard trigger +9/-10

Tighten carried-file guard trigger

• Condenses the trigger description while preserving its warning against overwriting downstream instruction files.

.github/skills/carried-instruction-file-guard/SKILL.md

SKILL.mdClarify in-repository hub check +7/-8

Clarify in-repository hub check

• Simplifies the distinction between this repository’s self-check and a hub-driven resync.

.github/skills/check-this-repo/SKILL.md

SKILL.mdRefresh prose-checking guidance +14/-19

Refresh prose-checking guidance

• States that sentence-length checking runs by default and clarifies the scope of the comment-growth rule. Condenses the skill trigger.

.github/skills/comment-and-doc-style/SKILL.md

SKILL.mdClarify Copilot runbook ownership +6/-9

Clarify Copilot runbook ownership

• Shortens the trigger and explains that audits do not judge content drift within Copilot-instruction sections.

.github/skills/copilot-instructions-keeper/SKILL.md

SKILL.mdCondense .NET skill trigger +11/-14

Condense .NET skill trigger

• Rewords the description of the existing .NET build, analyzer, logging, and testing conventions.

.github/skills/dotnet-codestyle/SKILL.md

SKILL.mdRefresh PR drive and merge procedure +133/-34

Refresh PR drive and merge procedure

• Routes feature merges through the hub’s gated merge command and its documented recovery outcomes. Updates handling for review-policy decisions, unthreaded findings, and observed data.

.github/skills/drive-pr/SKILL.md

SKILL.mdBound shared-primitive migration +1/-1

Bound shared-primitive migration

• Limits immediate migration to touched files and routes other instances through the finding-class disposition rules.

.github/skills/fleet-code-review/SKILL.md

SKILL.mdDocument operational commits and cleanup exception +11/-10

Document operational commits and cleanup exception

• Adds issue-reference guidance for direct operational pushes and a narrowly scoped abandoned-worker cleanup exception.

.github/skills/git-commit-conventions/SKILL.md

SKILL.mdRequire a reviewer-written pass report +36/-31

Require a reviewer-written pass report

• Changes pass recording to consume a digest-bound report written by the dispatched reviewer. Updates finding dispositions and describes when another review round is owed.

.github/skills/local-strict-review/SKILL.md

SKILL.mdRecognize backlog away-mode promotion grants +29/-27

Recognize backlog away-mode promotion grants

• Replaces unattended-handoff references with away-mode grants and clarifies handling when a promotion merged before the gate read.

.github/skills/merge-and-release/SKILL.md

SKILL.mdRefresh review coverage and finding gate +186/-66

Refresh review coverage and finding gate

• Accounts for repository review policy, advisory-reviewer checks, and acknowledgments for findings without threads. Adds observed-data escalation and more specific pre-existing-finding outcomes.

.github/skills/pr-review-conduct/SKILL.md

SKILL.mdAlign Python tool and script guidance +15/-15

Align Python tool and script guidance

• Notes the hub-pinned Ruff version used by CI and refreshes the generated command-line argument rules.

.github/skills/python-codestyle/SKILL.md

profiles.mdExplain lint-only Ruff pinning +13/-9

Explain lint-only Ruff pinning

• Describes how the hub’s Dependabot-maintained tool pin reaches CI while carrier tasks and documentation use latest versions.

.github/skills/python-codestyle/references/profiles.md

SKILL.mdDocument operational worktree exception +17/-17

Document operational worktree exception

• Allows an operational repository’s live develop checkout as an exception when its main-branch agent policy permits it.

.github/skills/repo-worktree/SKILL.md

SKILL.mdRefresh handoff setup and away-mode links +50/-31

Refresh handoff setup and away-mode links

• Requires a fresh hub clone when resuming a handoff and redirects unattended-lane references to backlog-burndown. Updates included guidance on presenting commands and decisions.

.github/skills/session-handoff/SKILL.md

SKILL.mdRefresh shell skill and argument rules +9/-12

Refresh shell skill and argument rules

• Condenses the shell-skill trigger and synchronizes its generated command-line argument guidance with CODESTYLE.md.

.github/skills/shell-codestyle/SKILL.md

SKILL.mdDocument skill-description limit +14/-2

Document skill-description limit

• Adds the 1024-character description limit and related distribution-build refusals to skill-authoring guidance.

.github/skills/skill-lifecycle/SKILL.md

SKILL.mdCondense upstream contribution trigger +11/-14

Condense upstream contribution trigger

• Rewords the existing fork, iteration, and upstream-pull-request workflow description.

.github/skills/upstream-contribution-workflow/SKILL.md

SKILL.mdCondense CI contract trigger +11/-14

Condense CI contract trigger

• Shortens the skill description while retaining its scope over workflow guarantees, validation, and publishing.

.github/skills/workflow-ci-contract/SKILL.md

d-guarantees.mdClarify required checks and .NET coverage +2/-2

Clarify required checks and .NET coverage

• Requires the aggregator’s ruleset-bound name only on pull-request events and describes test-project coverage when the root has no solution or project.

.github/skills/workflow-ci-contract/references/d-guarantees.md

test-methodology.mdRephrase workflow test scenarios +5/-5

Rephrase workflow test scenarios

• Splits several dense scenario-table descriptions into clearer sentences without changing their stated expected outcomes.

.github/skills/workflow-ci-contract/references/test-methodology.md

AGENTS.mdResync rule-location and skill index +4/-4

Resync rule-location and skill index

• Refreshes the carried rule-location section and replaces the retired unattended-handoff reference with backlog-burndown away mode and decision-triage.

AGENTS.md

CODESTYLE.mdAlign command-line and env-file naming rules +3/-3

Align command-line and env-file naming rules

• Clarifies PowerShell help and unknown-argument behavior and adds repository-name constraints for env or secret filenames.

CODESTYLE.md

GOVERNANCE.mdResync carried governance sections +25/-19

Resync carried governance sections

• Refreshes rules for operational checkouts, observed data, verification, review follow-up, and user communication. Aligns the carried prose with the skills that include or apply it.

GOVERNANCE.md

Other (1) +3 / -0

.prose-gate.jsonExempt ignored VS Code settings path +3/-0

Exempt ignored VS Code settings path

• Adds .vscode/settings.json to hub_hosted so the dead-path check accepts its mention in byte-locked carried guidance.

.prose-gate.json

[qodo-free-for-open-source-projects]

Code Review by Qodo

🐞 Bugs (2) 📘 Rule violations (0) 📎 Requirement gaps (0) 🎨 UX issues (0) 🔗 Cross-repo conflicts (0) 📜 Skill insights (0)

1. Merged promotions can miss their release 🐞 Bug ≡ Correctness

Description

The new state=MERGED path in merge-and-release skips dispatch without checking whether a release
ran. If someone merges the promotion between steps 1 and 2 without dispatching the publisher, a
requested release scope proceeds to skills refresh and cleanup even though merges do not trigger
publication.

Code

.github/skills/merge-and-release/SKILL.md[R65-67]

+   step 4, run the ready-report comparison below against its `head=`, and report both. Dispatch no
+   release from here, since whoever merged it may have released it already. The merge has landed
+   all the same, so go on to step 7 where a release scope was chosen, and then step 8. A digest carrying

Evidence

The new branch explicitly skips dispatch. This repository's publisher does not run on merge, while
the away-mode release scope calls for a dispatch for each promotion; the subsequent steps only
refresh skills and clean up.

.github/skills/merge-and-release/SKILL.md[63-68]
.github/workflows/publish-release.yml[8-14]
.github/skills/backlog-burndown/SKILL.md[726-737]
.github/skills/merge-and-release/SKILL.md[131-163]

Agent prompt

The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
The newly merged-state path can skip a requested release when another actor merged the promotion but did not publish it.
## Fix Focus Areas
- .github/skills/merge-and-release/SKILL.md[63-68]
## Recommended Fix
For a release scope, verify whether publication for the confirmed merge commit already ran before deciding not to dispatch. If it has not, dispatch and correlate the release using the normal procedure; stop and report if publication state is ambiguous.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

---

2. Answered questions remain open as work 🐞 Bug ≡ Correctness

Description

Step 7 of decision-triage says to leave an issue open as work whenever an answer settles it. When
a split created an issue holding only a question and the maintainer answers that no fix is wanted,
removing its decision label leaves an open backlog item with nothing to do.

Code

.github/skills/decision-triage/SKILL.md[R146-148]

+7. **Apply each answer** as it arrives, as "Communicating with the User" below states for an item
+   leaving the queue. Where the answer settles the work, leave the issue open as work, so an away
+   run fixes it. Where the answer is "not yet", record it in a comment stating the condition the

Evidence

The new procedure creates split issues containing only the undecided item, then directs the agent to
leave settled issues open. The governing queue rule closes an issue when it held nothing but the
question.

.github/skills/decision-triage/SKILL.md[119-123]
.github/skills/decision-triage/SKILL.md[146-151]
GOVERNANCE.md[258-259]

Agent prompt

The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
Triage leaves a split, question-only issue open even when the answer calls for no further work.
## Fix Focus Areas
- .github/skills/decision-triage/SKILL.md[146-151]
## Recommended Fix
After recording the answer and removing the decision label, distinguish an answer that creates actionable work from one that settles the issue entirely. Close question-only issues in the latter case; keep issues open when they still track work.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

---

Tip of the day

💡 Did you know, you can move or hide resolved findings to focus on what still needs action

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

[ptr727]

@qodo-free-for-open-source-projects please dismiss findings 1 and 2. Both are declined here as out of scope for this repository.

1. .github/skills/merge-and-release/SKILL.md:65-67, merged promotions can miss their release. Declined, carried hub text. .github/skills/ is the hub's generated tree, carried byte for byte: diff -rq .github/skills <hub>/.github/skills at hub 9f3e03cf is empty. A change to this text lands at ptr727/ProjectTemplate and reaches this repository at its next resync. .pr_agent.toml excludes this tree once it reaches main, which is why Qodo still reviewed it here.
2. .github/skills/decision-triage/SKILL.md:146-148, answered questions remain open as work. Declined, carried hub text, on the same evidence as finding 1.

[qodo-free-for-open-source-projects]

free-for-open-source-projects please dismiss findings 1 and 2. Both are declined here as out of scope for this repository.

1. .github/skills/merge-and-release/SKILL.md:65-67, merged promotions can miss their release. Declined, carried hub text. .github/skills/ is the hub's generated tree, carried byte for byte: diff -rq .github/skills <hub>/.github/skills at hub 9f3e03cf is empty. A change to this text lands at ptr727/ProjectTemplate and reaches this repository at its next resync. .pr_agent.toml excludes this tree once it reaches main, which is why Qodo still reviewed it here.
2. .github/skills/decision-triage/SKILL.md:146-148, answered questions remain open as work. Declined, carried hub text, on the same evidence as finding 1.

I can't dismiss findings 1 and 2 right now. The findings catalog for this PR is empty, so I can't match either finding to a stable ID, and dismissal requires one. Nothing has been changed.

The published report does list both findings by title: "Merged promotions can miss their release" (finding 1) and "Answered questions remain open as work" (finding 2). If the review's findings aren't indexed yet, the dismissal can't go through. Please try again once the review has finished syncing. If it still fails, you can dismiss them in the Qodo portal or the PR review UI.

[Copilot]

🟡 Changes recommended

The carried Python profile conflicts with this repository’s existing CI guidance on the Ruff version used for RegressionTests, leaving agents with contradictory instructions that must be reconciled.

1 open issue

• Resolve conflicting CI Ruff version guidance · New

What changed in this PR

This pull request resynchronizes PlexCleaner's carried instruction set and generated fleet skills with ProjectTemplate hub revision 9f3e03c. It also adds decision-triage, removes the retired unattended-handoff skill, and updates repository metadata for hub-hosted editor settings.

Changes:

• Refreshes carried governance, coding-style, workflow, review, and Copilot guidance.
• Updates the fleet skills tree and replaces retired handoff behavior with backlog-burndown away mode.
• Adds .vscode/settings.json handling to .gitignore and .prose-gate.json.
• Leaves one documentation consistency nit regarding conflicting Ruff version guidance in the Python profile and repository CI documentation.

This pull request is too complex or risky for automated approval.

File	Description
CODESTYLE.md	Refreshes command-line argument and environment-file naming rules.
AGENTS.md	Updates the rules map and skill descriptions.
.prose-gate.json	Declares the hub-hosted VS Code settings path.
.gitignore	Ignores generated VS Code settings.
.github/​skills/​workflow-ci-contract/​SKILL.md	Refreshes workflow contract guidance.
.github/​skills/​workflow-ci-contract/​references/​test-methodology.md	Updates workflow test scenarios.
.github/​skills/​workflow-ci-contract/​references/​d-guarantees.md	Refreshes workflow validation and guarantee definitions.
.github/​skills/​upstream-contribution-workflow/​SKILL.md	Refreshes upstream contribution guidance.
.github/​skills/​unattended-handoff/​SKILL.md	Removes the retired unattended-handoff skill.
.github/​skills/​skill-lifecycle/​SKILL.md	Updates skill generation and validation rules.
.github/​skills/​shell-codestyle/​SKILL.md	Refreshes shell and command-line guidance.
.github/​skills/​session-handoff/​SKILL.md	Updates handoff and away-mode procedures.
.github/​skills/​repo-worktree/​SKILL.md	Adds operational-repository worktree guidance.
.github/​skills/​python-codestyle/​SKILL.md	Refreshes Python style and toolchain guidance.
.github/​skills/​python-codestyle/​references/​profiles.md	Updates Python profile and Ruff versioning guidance.
.github/​skills/​pr-review-conduct/​SKILL.md	Refreshes review coverage and finding-handling rules.
.github/​skills/​merge-and-release/​SKILL.md	Updates promotion, release, and cleanup procedures.
.github/​skills/​local-strict-review/​SKILL.md	Updates review-report and recording mechanics.
.github/​skills/​git-commit-conventions/​SKILL.md	Adds operational repository commit guidance.
.github/​skills/​fleet-code-review/​SKILL.md	Refines class-sweep and reuse review guidance.
.github/​skills/​drive-pr/​SKILL.md	Updates pull-request driving and merge mechanics.
.github/​skills/​dotnet-codestyle/​SKILL.md	Refreshes .NET style guidance.
.github/​skills/​decision-triage/​SKILL.md	Adds maintainer decision-triage procedures.
.github/​skills/​copilot-instructions-keeper/​SKILL.md	Refreshes Copilot instruction synchronization guidance.
.github/​skills/​comment-and-doc-style/​SKILL.md	Updates prose, sentence-length, and comment guidance.
.github/​skills/​check-this-repo/​SKILL.md	Refreshes repository currency-check guidance.
.github/​skills/​carried-instruction-file-guard/​SKILL.md	Updates carried-file overwrite protection guidance.
.github/​skills/​branching-and-release-model/​SKILL.md	Adds operational repository commit and release rules.
.github/​skills/​audit-a-repo/​SKILL.md	Refreshes repository audit routing.
.github/​skills/​agent-conduct/​SKILL.md	Updates verification and review conduct guidance.
.github/​copilot-instructions.md	Refreshes the Copilot review runbook.

_{Review effort: Lite}

[ptr727]

@coderabbitai review

[coderabbitai]

Action not completed

Head commit changed.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[ptr727]

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

[ptr727]

Qodo re-keyed the same two findings on head aef4146 (merged promotions can miss their release, and answered questions remain open as work). Both stay declined as carried hub text, on the evidence in the earlier answer: .github/skills/ is byte-identical to the hub at 9f3e03cf, so the fix lands at ptr727/ProjectTemplate.