[ptr727]

Summary

Splits the GOVERNANCE.md "Communicating with the User" command bullet by where the command runs.

• The bullet opens with a placement test. A command runs outside this session where this session's input line cannot run it or cannot hold its effect, such as one waiting on typed input, one meant for another host, or one setting a variable the session reads at launch. Every other one runs at the session's input line, where that line can run a command.
• A command run outside the session stays in the question's own text, as before.
• A command run at the session's input line, a ! line on Claude Code, never goes in an interactive prompt, since an open prompt blocks the place it runs. It opens a plain message as a fenced block holding the ! line. Any question the turn owes follows as a numbered list, then any report. The message asks the user to reply once it has run, the turn ends with no prompt open, and the agent reads back the state or output on the next message.
• The "Ask every question", "Raise work blocked on the user", and parked-queue handoff bullets each name such a turn as an exception that carries its questions in that message. The session-handoff skill's own steps 4 and 5 and "The Parked Decision Queue" say the same.
• The agent-conduct and session-handoff include copies are regenerated with scripts/build_dist.py.

Closes on promotion: #3638

Local review findings

Every finding the earlier local passes raised was fixed in a later push. The last pass, over the current head, raised one introduced finding, declined with evidence below.

1. introduced, declined: the pass asked for a fourth example, a command that never exits such as a foreground server, among the outside-session cases. The test sentence already states the property, "where this session's input line cannot run it or cannot hold its effect", and a process that outlives the line's run is one the line cannot hold. The examples after it illustrate that property rather than closing it. A fourth example adds length without changing what the rule decides.

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

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

Run configuration

• Source mode: Auto
• Repository: ptr727/ProjectTemplate
• Branch: feature/auto-3638
• File: .coderabbit.yaml
• Commit: f091795
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Advanced
• Run ID: 66ec6b52-eaa1-4735-9b56-e3dd1c441069

• 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

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

[ptr727]

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

[Copilot]

🟡 Changes recommended

GOVERNANCE.md still leaves the command format ambiguous by not defining the ordering of unrelated questions, limiting the exception to command-related questions, or requiring the executable ! prefix.

3 open issues

• Specify ordering of questions and command block · New
• Require the executable ! prefix in the fenced command · New
• Restrict numbered-list exception to command-related questions · New

What changed in this PR

This pull request updates the user-communication rules so commands run at the current session prompt are sent in a plain fenced message rather than an interactive prompt, then verified on the user's next message. The governance change is propagated to the authored and generated skill copies.

Changes:

• Distinguishes commands run outside the session from Claude Code ! commands run at the session prompt.
• Requires session-prompt commands to be followed by user confirmation and read-back verification.
• Regenerates the affected skill distributions and source digests.
• Three unresolved documentation findings remain in GOVERNANCE.md regarding unrelated questions, message ordering, and explicitly including the ! prefix.

This pull request requires changes.

File	Description
GOVERNANCE.md	Defines the revised command-delivery and verification rules.
.github/​skills/​session-handoff/​SKILL.md	Regenerated GitHub session-handoff skill distribution.
.github/​skills/​agent-conduct/​SKILL.md	Regenerated GitHub agent-conduct skill distribution.
.claude-plugin/​fleet-skills/​skills/​session-handoff/​SKILL.md	Regenerated Claude session-handoff skill distribution.
.claude-plugin/​fleet-skills/​skills/​agent-conduct/​SKILL.md	Regenerated Claude agent-conduct skill distribution.
.claude-plugin/​fleet-skills/​.source-digests/​session-handoff	Updated session-handoff source digest.
.claude-plugin/​fleet-skills/​.source-digests/​agent-conduct	Updated agent-conduct source digest.
.agents/​skills/​session-handoff/​SKILL.md	Updated authored session-handoff skill include.
.agents/​skills/​agent-conduct/​SKILL.md	Updated authored agent-conduct skill include.

_{Review effort: Lite}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.70%. Comparing base (b38e084) to head (f091795).
⚠️ Report is 22 commits behind head on develop.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #3646      +/-   ##
===========================================
+ Coverage    81.60%   81.70%   +0.09%     
===========================================
  Files           26       26              
  Lines         9070     9119      +49     
===========================================
+ Hits          7402     7451      +49     
  Misses        1668     1668              

Flag	Coverage Δ
python-3.13	81.70% <ø> (+0.09%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[ptr727]

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

[ptr727]

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

[ptr727]

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

[ptr727]

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