Conversation
## Summary - document digest-pinned, network-disabled Docker lint commands with read-only repository mounts - separate executor-neutral authorization rules from Codex, Claude Code, and opencode host configuration - document persistent worktree access and link the future host-hook work tracked by #781 ## Verification - `python3 scripts/build_dist.py --check` - `python3 -m unittest scripts.tests.test_build_dist` - `python3 scripts/repo_gate.py` - `python3 scripts/prose_lint.py --diff origin/develop --summary` - `python3 scripts/prose_lint.py --check sentence-length --diff origin/develop --summary` - markdownlint-cli2 in the documented digest-pinned Docker invocation - CSpell in the documented digest-pinned Docker invocation - editorconfig-checker, ShellCheck, PSScriptAnalyzer, and actionlint in their documented Docker invocations References #866.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR promotes the Docker lint authorization contract to main by updating the canonical governance guidance, operational runbooks, and agent skill distributions to reflect a minimized-exposure Docker invocation pattern and provider-specific approval boundaries.
Changes:
- Update Docker-based “known-working” lint commands to a safer headless form (pull first, run by resolved digest, read-only mounts,
--network=none), and document the corresponding authorization model. - Clarify provider-specific host guardrail coverage and gaps (Claude Code vs. Codex/opencode), with links to the tracking issue.
- Promote the updated guidance into generated skill distributions and supporting docs (repo-worktree and comment-and-doc-style).
Reviewed changes
Copilot reviewed 14 out of 14 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| spec/scope-model.md | Clarifies host-vs-repo rule “home” using provider-specific host config framing. |
| README.md | Documents provider-specific host guardrails and links the Codex/opencode hook gap to issue #781. |
| OPERATIONS.md | Updates local verification Docker commands to digest-resolved, RO mounts, and no-network execution; documents repo exposure approval boundary. |
| host-setup/agent-safety/README.md | Renames to Claude-specific kit and clarifies scope plus references to missing Codex/opencode hooks. |
| GOVERNANCE.md | Updates canonical “Running the Linters Locally” contract with minimized-exposure Docker invocations and explicit authorization boundaries. |
| docs/host-setup.md | Splits provider-specific write-safety and adds agent worktree access guidance, including Codex config notes. |
| cspell.json | Adds “opencode” to the word allowlist. |
| .github/skills/repo-worktree/SKILL.md | Adds a provider-specific worktree tool section (Claude Code vs Codex/opencode behavior). |
| .github/skills/comment-and-doc-style/SKILL.md | Adds a “Docker lint authorization” section that routes to GOVERNANCE for canonical commands. |
| .claude-plugin/fleet-skills/skills/repo-worktree/SKILL.md | Promotes the updated repo-worktree skill content into the Claude plugin distribution. |
| .claude-plugin/fleet-skills/skills/comment-and-doc-style/SKILL.md | Promotes the updated comment-and-doc-style skill content into the Claude plugin distribution. |
| .claude-plugin/fleet-skills/.source-digest | Updates the plugin distribution source digest to match the promoted skill set. |
| .agents/skills/repo-worktree/SKILL.md | Promotes the updated repo-worktree skill content into the Codex/opencode overlay distribution. |
| .agents/skills/comment-and-doc-style/SKILL.md | Promotes the updated comment-and-doc-style skill content into the Codex/opencode overlay distribution. |
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
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
Verification
Closes #866.
References #781.