Skip to content

State That the Hub Commits Audit Reports and a Downstream Session Resyncs Itself - #1823

Merged
ptr727 merged 7 commits into
developfrom
feature/bootstrap-report-authorship
Sep 25, 2026
Merged

ptr727 merged 7 commits into
developfrom
feature/bootstrap-report-authorship

Conversation

@ptr727

@ptr727 ptr727 commented Sep 25, 2026

Copy link
Copy Markdown
Owner

Downstream sessions kept asking the maintainer for permission to open a hub pull request that commits their own audit report under reports/. AUDIT.md section 8 already forbids that, but the carried Fleet Bootstrap told every repository to "commit the report" without saying who, and RESYNC.md ended the same way.

  • AGENTS.md "Fleet Bootstrap" and the host-wide fleet block. The hub commits the report under its own reports/. A session in the repository being audited fixes its own drift, files its findings about the hub as issues, and leaves the report to a hub-side audit.
  • RESYNC.md, the AUDIT.md section 9/10 diagram, and resync-a-repo. Each names the hub as the report's author. RESYNC.md adds that a session resyncing its own repository leaves the report to a hub-side audit.
  • check-this-repo. It no longer says a downstream repository never resyncs itself. The maintainer settled that a downstream session may resync its own repository per RESYNC.md, with resync-a-repo from a hub checkout as the other route.

The Fleet Bootstrap section is byte-locked, so every carrier reports drift on it until its next resync.

Four local strict-review passes are recorded. The last one left three findings that are deferred to #1822 by the maintainer's choice.

🤖 Generated with Claude Code

ptr727 and others added 5 commits September 25, 2026 11:32
The Fleet Bootstrap told every carrier to "commit the report" without
saying the hub authors it, so downstream sessions kept asking for
permission to open a hub pull request. Name the hub as the report's
author and route downstream findings to hub issues, in the carried
section and in the host-wide fleet block, matching AUDIT.md section 8.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings September 25, 2026 19:06
@coderabbitai

coderabbitai Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

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

⚙️ Run configuration

Configuration used: Repository: ptr727/ProjectTemplate/.coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 9e49a2d4-8ef4-4918-b628-54b1b73f1a2d


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

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The updated guidance still contains contradictory phrasing about “hub-driven resync” vs self-resync and unconditional hub report commits, which can keep misrouting sessions even after the hub-authorship clarification.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 3 Low severity

Open (3)
What changed in this PR

This PR clarifies ownership and workflow boundaries around audit reports and resyncs: audit reports are authored/committed by the hub under reports/, while downstream sessions resync their own repositories (and escalate hub defects as issues) without attempting to write hub audit reports themselves.

Changes:

  • Updates AGENTS.md, RESYNC.md, and the AUDIT.md mermaid diagram to explicitly state that the hub commits audit reports under reports/.
  • Extends the host-wide fleet bootstrap block to reflect the same report ownership and downstream responsibilities.
  • Updates resync-a-repo / check-this-repo skill text and regenerates the distributed skill copies plus digest stamps.
File Description
RESYNC.md Clarifies that the hub commits the audit report and that self-resync sessions leave report writing to a hub-side audit.
host-setup/​agent-safety/​claude/​claude-md-fleet.md Updates the host-wide fleet bootstrap text to describe hub-owned audit reports and downstream behavior.
AUDIT.md Updates the audit/resync diagram label to state the hub commits the report.
AGENTS.md Updates Fleet Bootstrap to clarify hub report ownership and downstream actions (fix drift locally, file hub issues).
.agents/​skills/​resync-a-repo/​SKILL.md Updates resync skill wording to commit reports under hub reports/.
.agents/​skills/​check-this-repo/​SKILL.md Updates check-this-repo to allow resync via the repo’s own session or via resync-a-repo from a hub checkout.
.github/​skills/​resync-a-repo/​SKILL.md Regenerated distribution copy reflecting the resync-a-repo wording change.
.github/​skills/​check-this-repo/​SKILL.md Regenerated distribution copy reflecting the check-this-repo wording change.
.claude-plugin/​fleet-skills/​skills/​resync-a-repo/​SKILL.md Regenerated plugin distribution copy reflecting the resync-a-repo wording change.
.claude-plugin/​fleet-skills/​skills/​check-this-repo/​SKILL.md Regenerated plugin distribution copy reflecting the check-this-repo wording change.
.claude-plugin/​fleet-skills/​.source-digests/​resync-a-repo Updates digest stamp for the regenerated resync-a-repo skill distribution.
.claude-plugin/​fleet-skills/​.source-digests/​check-this-repo Updates digest stamp for the regenerated check-this-repo skill distribution.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread .agents/skills/check-this-repo/SKILL.md Outdated
Comment thread .agents/skills/resync-a-repo/SKILL.md Outdated
Comment thread host-setup/agent-safety/claude/claude-md-fleet.md Outdated
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings September 25, 2026 19:23

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

The changes are internally consistent documentation/skill guidance updates with no remaining contradictions observed in the edited text.

Review effort: Lite
Findings: None

Resolved since last review (3)

Copilot AI review requested due to automatic review settings September 25, 2026 19:28

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

The changes consistently align the documented procedures and skills with AUDIT.md section 8’s report authorship model without introducing conflicting guidance.

Review effort: Lite
Findings: None

@ptr727
ptr727 merged commit 57e1e82 into develop Sep 25, 2026
9 checks passed
@ptr727
ptr727 deleted the feature/bootstrap-report-authorship branch September 25, 2026 19:32
ptr727 added a commit that referenced this pull request Sep 25, 2026
…rship to Main (#1827)

Promotes `develop` to `main`.

## Carried

- #1806: adds the unattended handoff loop and the attended resume
procedure.
- #1807: renames three skills and states which skill wins each shared
trigger.
- #1809: names a pin by its mechanism rather than its value, and audits
for copies.
- #1808: leads every choice with a recommendation and closes every
session in order.
- #1813: bans every version literal in the four instruction documents
and catches abbreviated SHAs, following #1809.
- #1820: refuses a coverage marker indented into a code block, per
#1725.
- #1823: states that the hub commits audit reports and that a downstream
session resyncs itself. This covers the Fleet Bootstrap section, the
host fleet block, `RESYNC.md`, `AUDIT.md`, `check-this-repo`, and
`resync-a-repo`, and settles #1822. The Fleet Bootstrap section is
byte-locked, so every carrier reports drift on it until its next resync.
- #1825: strips a tilde or unclosed fence before reading review
coverage, per #1821.

Closes #1725
Closes #1821
Closes #1822

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants