[ptr727]

Summary

The per-directory Python profile rule from #3549 and #3555 still met per-repository wording in four places. Each now states the rule: a profile belongs to a declared directory, not to the repository.

• python-codestyle SKILL.md "Two profiles" names the build trait as a deliverable, not "the repo's deliverable" (Name the Build Trait as a Deliverable in python-codestyle SKILL.md #3548). It states that a profile belongs to a declared directory, and that a uv workspace is declared once, by its root.
• SKILL.md "Toolchain" says mypy may be a build directory's only CI checker (Name the Build Trait as a Deliverable in python-codestyle SKILL.md #3548).
• SKILL.md gates an undeclared root only where the repository tracks a root pyproject.toml, per WORKFLOW.md D1.2 (State the Root Gating Condition in the python-codestyle Skill #3554).
• references/profiles.md "Adapt before propagating" calls the default bundle a toolchain, not a profile, and sets its axes per declared directory (Stop Calling the Toolchain Bundle a Profile in python-codestyle profiles.md #3550).
• spec/type-model.md "Profiles: build vs lint-only" says Python's profile belongs to each declared directory (Bring the Spec's Python Profile Text Onto the Per-Directory Rule #3552).
• spec/project-types.json python.profileNote drops "the repo's deliverable" and "embedded in a non-Python repo". It states the per-directory rule and the workspace exception (Bring the Spec's Python Profile Text Onto the Per-Directory Rule #3552). The rewritten sentences are split to 25 words or fewer.
• The python-codestyle generated copies and source digest are regenerated with scripts/build_dist.py.

Deferrals, filed

• Say What the Registry's Python Profile Means Once the Profile Is Per Directory #3556: the registry still declares one profiles.python value per repository, which spec/validate.py and the schema accept. This change's bounds covered only the spec's Python profile text.

Verification

• spec/validate.py passes.
• tests/test_spec_validate.py and tests/test_audit_helpers.py pass under unittest.
• scripts/build_dist.py --check reports the distributions current.
• scripts/prose_lint.py --diff origin/develop reports no violation, with --check sentence-length too.

Closes on promotion: #3548, #3550, #3552, #3554

🤖 Generated with Claude Code

[ptr727]

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

[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/3548-python-profile-followups
• File: .coderabbit.yaml
• Commit: 22d754d
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Advanced
• Run ID: b4e8ec02-8a5c-4f3a-b8a5-c617b7d9d562

• 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.}

[Copilot]

🔵 Needs a closer look

Promotion should await maintainer review because the documented Python profile model no longer matches the registry and validator contract, and the related issue is explicitly deferred.

No open issues 🎉

What changed in this PR

This pull request aligns Python profile guidance with the per-directory profile model, updates the specification text, and regenerates the distributed python-codestyle skills and source digest.

Changes:

• Defines profiles, deliverables, toolchains, and CI guidance per declared Python directory.
• Clarifies uv workspace-root exceptions and undeclared-root gating.
• Updates the type model and machine-readable project metadata.
• Regenerates distributed skill copies and refreshes the source digest.

File	Description
spec/​type-model.md	Documents Python profiles per declared directory.
spec/​project-types.json	Updates Python profile metadata and workspace wording.
.github/​skills/​python-codestyle/​SKILL.md	Regenerated GitHub skill guidance.
.github/​skills/​python-codestyle/​references/​profiles.md	Regenerated profile reference guidance.
.claude-plugin/​fleet-skills/​skills/​python-codestyle/​SKILL.md	Regenerated Claude skill guidance.
.claude-plugin/​fleet-skills/​skills/​python-codestyle/​references/​profiles.md	Regenerated Claude profile reference guidance.
.claude-plugin/​fleet-skills/​.source-digests/​python-codestyle	Updates the generated skill source digest.
.agents/​skills/​python-codestyle/​SKILL.md	Updates the canonical Python profile and root-gating guidance.
.agents/​skills/​python-codestyle/​references/​profiles.md	Updates canonical per-directory toolchain guidance.

_{Review effort: Lite}

[ptr727]

Answer to the headline of the Copilot round on 22d754d4 (review), which counted no finding (0) and flagged one item in its headline:

the documented Python profile model no longer matches the registry and validator contract, and the related issue is explicitly deferred.

spec/type-model.md:37, spec/project-types.json python.profileNote: Deferred to #3556.

The mismatch is real and is not this change's to close. The per-directory rule was already stated in CODESTYLE.md "Python" and references/profiles.md by #3549, and this change brings the spec prose onto it. The per-repository profiles.python value lives in registry/repos.json, spec/project-types.schema.json, and spec/validate.py, all outside this change's file bounds. #3556 records it with the two candidate shapes and names those files.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.50%. Comparing base (367bba0) to head (22d754d).

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #3557   +/-   ##
========================================
  Coverage    81.50%   81.50%           
========================================
  Files           26       26           
  Lines         9065     9065           
========================================
  Hits          7388     7388           
  Misses        1677     1677           

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

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.