[ptr727]

Part of #3531.

Splits the over-length sentences in comments and docstrings of scripts/build_dist.py, scripts/handoff.py, scripts/carry.py, scripts/skills_install.py, scripts/skills_install.ps1, tests/test_build_dist.py, tests/test_handoff.py, tests/test_skills_install.py, and tests/test_carry.py. prose_lint --check sentence-length goes from 214 hits to 0 across them.

Comments and docstrings only. Python ASTs with docstrings masked are identical to base, python3 scripts/build_dist.py --check reports the generated trees current, and the carry, handoff, build_dist, and skills_install tests pass.

Notes:

• The module docstrings of build_dist.py and skills_install.py feed argparse description, so their --help wording changes. No test asserts on it.
• The Usage synopsis in the handoff.py module docstring gains - bullet prefixes, since the gate reads an unterminated synopsis block as one long sentence. Only the docstring's first line reaches --help.
• Where scripts/README.md already read zero, its wording was adopted (the --repo no-default sentence, the include-region sentence, and the carry tree-root sentences).

Local review: four recorded passes, the last over the current head with no meaning drift. Remaining borderline items, all left as is: an elliptical "So is one" in the include_destinations docstring, a two-part reason in tree_source now read as two, and "it" two sentences from str.splitlines in carry.py.

Copies left for the comment sweep

A search of the whole tree (every tracked file outside this slice) for the replaced sentences found matches only in files that already read zero: scripts/README.md, the skills under .agents/skills/, .github/skills/, .claude-plugin/, .github/copilot-instructions.md, and AGENTS.md. Those carry different wordings of the same content, not identical sentences, so no pair is left for another slice.

🤖 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/3531-cmt-dist-carry-handoff
• File: .coderabbit.yaml
• Commit: 4f70527
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Advanced
• Run ID: 0d2724f4-1ee2-4659-b508-2fd56009700c

• 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 4b507c6e8e19e807de4bed644af7fdf7f6f08968, the content this pull request carries at that commit against develop, and it recorded 3 findings.

[Copilot]

🟡 Changes recommended

Two unresolved nit-level findings remain, both involving ambiguous references after a sentence split: "it" at scripts/carry.py line 435 and "Outside one" at scripts/build_dist.py line 277.

2 open issues

• Clarify the code sample reference · New
• Clarify the ambiguous reference to str.splitlines · New

What changed in this PR

This PR splits over-length sentences in comments and docstrings across the build, handoff, carry, and skills installer scripts and their tests. It is part of #3531, which asks for the repository's sentence-length check to pass on these files. The check drops from 214 hits to 0. The change is limited to comments and docstrings, so program behavior is unchanged.

Changes:

• Long comment and docstring sentences are split into shorter sentences in the listed scripts and tests.
• The handoff.py Usage synopsis gains bullet prefixes so the check reads it as a list rather than one long sentence.
• The module docstrings of build_dist.py and skills_install.py feed argparse --help, so their help wording changes. No test checks that text.

File	Description
tests/​test_skills_install.py	Splits long docstring and comment sentences in the installer tests. Wording only.
tests/​test_handoff.py	Splits long docstring sentences in the handoff tests. Wording only.
tests/​test_carry.py	Splits long docstring sentences in the carry tests. Wording only.
tests/​test_build_dist.py	Splits long docstring and comment sentences in the build tests. Wording only.
scripts/​skills_install.py	Splits long module, function, and comment sentences. The module docstring feeds --help.
scripts/​skills_install.ps1	Splits one long launcher comment into shorter lines.
scripts/​handoff.py	Splits long docstring and comment sentences and bullets the Usage synopsis.
scripts/​carry.py	Splits long comment and docstring sentences, including the line-ending and section-reconciliation notes.
scripts/​build_dist.py	Splits long comment and docstring sentences. The module docstring feeds --help.

_{Review effort: Lite}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.60%. Comparing base (0d4e6f1) to head (4f70527).
⚠️ Report is 2 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #3608   +/-   ##
========================================
  Coverage    81.60%   81.60%           
========================================
  Files           26       26           
  Lines         9070     9070           
========================================
  Hits          7402     7402           
  Misses        1668     1668           

Flag	Coverage Δ
python-3.13	81.60% <ø> (ø)

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 4f70527fbb00687516c6c46c415d057d1b25d28a, the content this pull request carries at that commit against develop, and it recorded 0 findings.