Conversation
## Summary - make the complete `repo-config/` directory hub-only - route standup, resync, audit, and skills through the hub at `main` - remove downstream payload-based workflow-model inference ## Verification - 733 unit tests - ruff, mypy, Markdown, spelling, prose, JSON, EditorConfig, and ShellCheck gates - audit and generated-skill self-tests - live hub configuration check - live downstream audit classification Ref #827
Contributor
There was a problem hiding this comment.
Pull request overview
This pull request updates the fleet’s documentation, spec, skills, and linting logic to treat repo-config/ (payloads + tooling + reference docs) as hub-only content on main, and to align standup/resync/audit procedures around consuming that hub source rather than downstream copies.
Changes:
- Retire downstream
repo-config/carries in the spec/ledger and reframe docs to treat the hubmainbranch as the configuration source of truth. - Narrow the
home-pathexemption to only the repository-rootOPERATIONS.mdrunbook (instead of exempting whole operational repos). - Update standup/resync/audit runbooks, skills, and references to consistently instruct running
repo-config/configure.shfrom a hub checkout atmain.
Reviewed changes
Copilot reviewed 40 out of 40 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| WORKFLOW.md | Removes downstream-facing repo-config reference and points branch-model ruleset authority to governance. |
| STANDUP.md | Updates standup procedure to treat repository configuration as hub-hosted and adjusts links to docs/repo-config.md. |
| spec/readme-structure.md | Updates README “Contributing” guidance to point at governance instead of repo-config/README.md. |
| spec/project-types.json | Rewords ruleset assertions to reference hub main payloads and updates carried-file coordination rule list. |
| spec/host-tools.json | Updates jq rationale to match hub-only repo-config doc and workflow. |
| spec/files.json | Removes repo-config/ from baseline carry; repoints intent refs to docs/repo-config.md. |
| spec/divergences.json | Classifies repo-config/* payloads/docs as retire for downstreams and expands the retirement ledger accordingly. |
| scripts/tests/test_prose_lint.py | Updates tests to reflect OPERATIONS.md-only exemption and removes operational-repo model inference tests. |
| scripts/README.md | Updates prose-lint documentation to describe the OPERATIONS.md exemption. |
| RESYNC.md | Updates resync instructions to run configuration checks from hub main and delete retired downstream repo-config/ paths. |
| repo-config/README.md | Reframes repo-config/ as hub-only and updates apply/check instructions accordingly. |
| repo-config/configure.sh | Removes model inference from carried payloads and requires explicit model when registry is unavailable. |
| README.md | Updates repo overview links and documentation pointers to docs/repo-config.md. |
| OPERATIONS.md | Updates ops runbook to run repo configuration commands from a hub checkout at main. |
| GOVERNANCE.md | Updates workflow/ruleset guidance to reference hub repo-config/ payloads and clarifies publisher workflow path. |
| docs/repo-config.md | Rewrites repository-configuration doc to formalize hub-only source and hub-main command usage. |
| AUDIT.md | Replaces local diff snippets with “run hub repo-config/configure.sh check from main” guidance. |
| .github/skills/workflow-ci-contract/SKILL.md | Updates required-check/ruleset rename guidance to reference hub repo-config/ payloads. |
| .github/skills/standup-a-repo/SKILL.md | Updates standup skill to specify hub main as the execution context for configure.sh. |
| .github/skills/resync-a-repo/SKILL.md | Updates resync skill to specify hub main for configure.sh check. |
| .github/skills/operational-vs-release-workflow/references/branch-protection-and-promotion.md | Updates branch protection procedure to hub configure.sh apply usage. |
| .github/skills/comment-and-doc-style/SKILL.md | Removes repo-config/ from the carried-file “no coordination machinery” scope list. |
| .github/skills/comment-and-doc-style/references/carried-doc-references.md | Removes repo-config/ from the carried-file “no coordination machinery” scope list (reference doc). |
| .github/skills/audit-a-repo/SKILL.md | Updates audit skill to use hub main configure.sh check as the source of truth. |
| .github/actions/prose-gate/prose_lint.py | Implements OPERATIONS.md-only home-path exemption and expands HUB_HOSTED retire-path set. |
| .claude-plugin/fleet-skills/skills/workflow-ci-contract/SKILL.md | Mirrors workflow-ci-contract update for plugin-distributed skills. |
| .claude-plugin/fleet-skills/skills/standup-a-repo/SKILL.md | Mirrors standup-a-repo update for plugin-distributed skills. |
| .claude-plugin/fleet-skills/skills/resync-a-repo/SKILL.md | Mirrors resync-a-repo update for plugin-distributed skills. |
| .claude-plugin/fleet-skills/skills/operational-vs-release-workflow/references/branch-protection-and-promotion.md | Mirrors branch-protection reference update for plugin-distributed skills. |
| .claude-plugin/fleet-skills/skills/comment-and-doc-style/SKILL.md | Mirrors comment-and-doc-style scope update for plugin-distributed skills. |
| .claude-plugin/fleet-skills/skills/comment-and-doc-style/references/carried-doc-references.md | Mirrors carried-doc-references update for plugin-distributed skills. |
| .claude-plugin/fleet-skills/skills/audit-a-repo/SKILL.md | Mirrors audit-a-repo update for plugin-distributed skills. |
| .claude-plugin/fleet-skills/.source-digest | Updates plugin source digest to reflect skill/content changes. |
| .agents/skills/workflow-ci-contract/SKILL.md | Mirrors workflow-ci-contract update for agent-distributed skills. |
| .agents/skills/standup-a-repo/SKILL.md | Mirrors standup-a-repo update for agent-distributed skills. |
| .agents/skills/resync-a-repo/SKILL.md | Mirrors resync-a-repo update for agent-distributed skills. |
| .agents/skills/operational-vs-release-workflow/references/branch-protection-and-promotion.md | Mirrors branch-protection reference update for agent-distributed skills. |
| .agents/skills/comment-and-doc-style/SKILL.md | Mirrors comment-and-doc-style scope update for agent-distributed skills. |
| .agents/skills/comment-and-doc-style/references/carried-doc-references.md | Mirrors carried-doc-references update for agent-distributed skills. |
| .agents/skills/audit-a-repo/SKILL.md | Mirrors audit-a-repo update for agent-distributed skills. |
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
ptr727
marked this pull request as ready for review
August 20, 2026 02:25
## Summary - sync lockfile-backed Python project dependencies before linting - run ruff and the configured type checker inside the project environment - keep `uvx ...@latest` for lint-only repositories without a lockfile Refs #862 ## Verification - full local gate from `OPERATIONS.md` - actionlint with bundled shellcheck - 733 unit tests and audit self-tests - repository, prose, generated-distribution, JSON, schema, EditorConfig, shell, and PowerShell gates
ptr727
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
mainVerification
Closes #827
Closes #862