feat(source-control): bake native route phrases into commit and pull-request descriptions

docs/conventions/native-references/CHANGELOG.md

@@ -6,6 +6,13 @@ major change; additive guidance is minor; clarification is a patch. The doc ship
 unnumbered, which this file reads as **1.0**; the entry below is the first recorded change and lands
 the changelog the README said would arrive with it.
 
+## [3.3.1] - 2026-09-29
+
+Patch: clarification.
+
+- **The Adopters table records the description phrases baked in `/source-control:commit` and
+  `/source-control:pull-request`** for the bundled `commit` and `pr` skills and `/commit-push-pr`.
+
 ## [3.3.0] - 2026-09-29
 
 Minor: additive guidance.

docs/conventions/native-references/README.md

@@ -218,7 +218,7 @@ Classified per `melodic-software/standards` `conventions/engineering/enforceabil
 | `/claude-ops:audit-performance`, `/claude-ops:audit-skill-visibility` | `## Boundary` sections for the bundled `doctor` skill (and `/skill-doctor` for the second), verdict `complementary`; the second also carries the description phrase for `/skill-doctor`; detail in each skill's `reference/` file |
 | `/visualization:visualize` | Description phrase + `## Boundary` section for the bundled `design` skill (verdict `complementary`, user-run canvas versus a chosen form and medium); detail in the catalog spoke |
 | `/prototype:explore-directions` | Description phrase + `## Boundary` section for the bundled `design` skill (verdict `complementary`, user-run canvas versus throwaway mockup), and a second `## Boundary` section for the marketplace `playground` plugin; detail in the skill's `reference/` files |
-| `/source-control:commit`, `/source-control:pull-request`, `/source-control:babysit-prs` | `## Boundary` sections for the bundled `commit` and `pr` skills and `/commit-push-pr` (integration `route`, in both `commit` and `pull-request`), and `/autofix-pr` (`suggest`, in both `pull-request` and `babysit-prs`); verdict `complementary`, detail in each skill's `reference/` file; no description phrase |
+| `/source-control:commit`, `/source-control:pull-request`, `/source-control:babysit-prs` | `## Boundary` sections for the bundled `commit` and `pr` skills and `/commit-push-pr` (integration `route`, in both `commit` and `pull-request`), and `/autofix-pr` (`suggest`, in both `pull-request` and `babysit-prs`); verdict `complementary`, detail in each skill's `reference/` file; `commit` and `pull-request` carry one description phrase each for their `route` rows |
 | `/claude-config:draft-auto-mode-rules`, `/claude-config:audit-permission-state`, `/claude-config:audit-permission-grants`, `/claude-config:audit` | `## Boundary` sections for `/auto-mode-setup` (`suggest`), the bundled `fewer-permission-prompts` skill (`route`) with `/permissions` (`suggest`, in both permission audits), and the bundled `update-config` skill (`route`); verdict `complementary`; no description phrase |
 | `/bugs:write`, `/github:advise`, `/claude-memory:stateless` | `## Boundary` sections for `/bug`, `/install-github-app`, and `/memory` (integration `suggest`, verdict `complementary`); detail in each skill's `context/` or `reference/` file; no description phrase |
 | `/verification:confirm`, `/implementation:implement-dispatch`, `/debugging:debug` | `## Boundary` sections for the model-disabled bundled `verify`, `batch`, and `debug` skills (integration `suggest`, verdict `complementary`); no description phrase |

docs/native-surfaces.md

@@ -137,7 +137,7 @@ and when. See [`docs/conventions/native-references/`](conventions/native-referen
   - docs cross-check (commands reference, 2026-09-29): undocumented
 - **Observation:** extraction: extracted from binary v2.1.284 on 2026-09-29 (the /claude-ops:inventory extraction of the installed native build; integrity ok on every lane, counts are totals) (2026-09-29)
 - **Recheck trigger:** a Claude Code release renames or removes `/commit-push-pr`, changes its invocability, or the commands reference documents it (verified 2026-09-29)
-- **Baked:** description phrase no · Boundary section yes · Native step no · suggest sentence no
+- **Baked:** description phrase yes · Boundary section yes · Native step no · suggest sentence no
 - **Budget caveat:** the baked phrase may be dropped from the skill listing under budget pressure. It is the best available routing surface, not a guaranteed one
 
 ### `commit-push-pr` → `source-control:pull-request`
@@ -154,7 +154,7 @@ and when. See [`docs/conventions/native-references/`](conventions/native-referen
   - docs cross-check (commands reference, 2026-09-29): undocumented
 - **Observation:** extraction: extracted from binary v2.1.284 on 2026-09-29 (the /claude-ops:inventory extraction of the installed native build; integrity ok on every lane, counts are totals) (2026-09-29)
 - **Recheck trigger:** a Claude Code release renames or removes `/commit-push-pr`, changes its command type or invocability, or the commands reference starts documenting it (verified 2026-09-29)
-- **Baked:** description phrase no · Boundary section yes · Native step no · suggest sentence no
+- **Baked:** description phrase yes · Boundary section yes · Native step no · suggest sentence no
 - **Budget caveat:** the baked phrase may be dropped from the skill listing under budget pressure. It is the best available routing surface, not a guaranteed one
 
 ### `export` → `session-flow:clean-stop`
@@ -607,7 +607,7 @@ and when. See [`docs/conventions/native-references/`](conventions/native-referen
   - docs cross-check (commands reference, 2026-09-29): undocumented
 - **Observation:** extraction: extracted from binary v2.1.284 on 2026-09-29 (the /claude-ops:inventory extraction of the installed native build; integrity ok on every lane, counts are totals) (2026-09-29)
 - **Recheck trigger:** a Claude Code release renames or removes the bundled `commit` skill, changes its invocability or gating, or the commands reference starts documenting it (verified 2026-09-29)
-- **Baked:** description phrase no · Boundary section yes · Native step no · suggest sentence no
+- **Baked:** description phrase yes · Boundary section yes · Native step no · suggest sentence no
 - **Budget caveat:** the baked phrase may be dropped from the skill listing under budget pressure. It is the best available routing surface, not a guaranteed one
 
 ### `debug` → `debugging:debug`
@@ -838,7 +838,7 @@ and when. See [`docs/conventions/native-references/`](conventions/native-referen
   - docs cross-check (commands reference, 2026-09-29): undocumented
 - **Observation:** extraction: extracted from binary v2.1.284 on 2026-09-29 (the /claude-ops:inventory extraction of the installed native build; integrity ok on every lane, counts are totals) (2026-09-29)
 - **Recheck trigger:** a Claude Code release renames or removes the bundled `pr` skill, changes its invocability or gating, or the commands reference starts documenting it (verified 2026-09-29)
-- **Baked:** description phrase no · Boundary section yes · Native step no · suggest sentence no
+- **Baked:** description phrase yes · Boundary section yes · Native step no · suggest sentence no
 - **Budget caveat:** the baked phrase may be dropped from the skill listing under budget pressure. It is the best available routing surface, not a guaranteed one
 
 ### `prototype` → `prototype:explore-directions`

docs/native-surfaces/records.json

@@ -910,7 +910,7 @@
         "verified": "2026-09-29"
       },
       "baked": {
-        "description_phrase": false,
+        "description_phrase": true,
         "boundary_section": true,
         "native_step": false,
         "suggest_sentence": false
@@ -952,7 +952,7 @@
         "verified": "2026-09-29"
       },
       "baked": {
-        "description_phrase": false,
+        "description_phrase": true,
         "boundary_section": true,
         "native_step": false,
         "suggest_sentence": false
@@ -990,7 +990,7 @@
         "verified": "2026-09-29"
       },
       "baked": {
-        "description_phrase": false,
+        "description_phrase": true,
         "boundary_section": true,
         "native_step": false,
         "suggest_sentence": false
@@ -2074,7 +2074,7 @@
         "verified": "2026-09-29"
       },
       "baked": {
-        "description_phrase": false,
+        "description_phrase": true,
         "boundary_section": true,
         "native_step": false,
         "suggest_sentence": false

plugins/source-control/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "source-control",
-  "version": "0.62.29",
+  "version": "0.62.30",
   "description": "Git and GitHub delivery workflow: /commit (Conventional Commits + Co-authored-by trailer via safe heredoc mechanics), /pull-request (prep, create, CI monitoring, review-comment triage, merge, CI-log fetch), /babysit-prs (self-pacing fleet loop, safe by default; opt-in worker/autopilot tiers add gate-checked merge and thread resolution behind a deterministic Python engine), /babysit-loop (the loop-lane merge lane: a standing or drain loop that invokes babysit-prs per cycle, configured through repo-scoped babysit_loop_* keys on the layered source-control.md seam, with merge authority human-only until the target repo's tracked config adopts the lane, a gate-proven C2-mechanical baseline once adopted, and standing merge-rung raises binding from the team-tracked layer only, with one named exception, where an invocation line explicitly typing both the autopilot tier keyword and the dedicated raise argument --merge c3-this-run widens that single invocation's merge authority up to C3 behind a fresh independent frontier-tier resolver, while C4-structural and C5-untrusted-provenance stay unconditionally human-merge), /worktree (create, status, cleanup, audit for parallel-session isolation), /setup (check the effective commit-subject / PR-title convention merged across its config layers and the babysit-prs config, or apply, which interviews the repo and writes the convention config to a chosen layer), and /resolve-conflicts (intent-first merge/rebase conflict resolution with a semantic-conflict sweep, never --abort). The commit-subject / PR-title convention is configurable via a source-control.md config written by a re-runnable setup skill, layered across a ~/.claude user-global file, the tracked team file, and a gitignored .claude/source-control.local.md personal overlay merged per key; Conventional Commits is the default when no convention is declared.",
   "author": {
     "name": "Melodic Software",

plugins/source-control/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to the `source-control` plugin are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this plugin uses semantic versioning.
 
+## [0.62.30] - 2026-09-29
+
+### Changed
+
+- **`commit` and `pull-request` descriptions open with a presence-gated routing clause for the
+  native surfaces their Boundary sections cover.** `commit` routes to the bundled `commit` skill
+  only when none of its contract (convention, trailer, surgical staging, pre-checks) is wanted, and
+  a commit-push-PR request to the built-in `/commit-push-pr` command, when either resolves in the
+  session; it keeps every other commit. `pull-request` routes a one-shot PR with no draft, body
+  contract, or later ready, monitor or merge step to the bundled `pr` skill when the work is
+  committed, to `/commit-push-pr` only when the whole working tree belongs in the commit, and
+  keeps everything else. Its Boundary section says the same, so unrelated uncommitted changes never reach a
+  native commit.
+
 ## [0.62.29] - 2026-09-29
 
 ### Added

plugins/source-control/skills/commit/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "Create a git commit with a subject matching the resolved convention (layered `source-control.md` config → project convention → Conventional Commits default), a Claude Co-authored-by trailer, and surgical staging (never `git add -A`), feeding the message to git via Bash heredoc. Use when: 'commit this', 'make a commit', 'commit with message <hint>', not for push, branch creation, or PR creation (use /pull-request)."
+description: "When the bundled commit skill or built-in commit-push-pr command resolves in this session, prefer the first only when none of this skill's contract (convention, trailer, surgical staging, pre-checks) is wanted and the second to commit, push, and open a PR at once; this skill for every other commit. Create a git commit with a subject matching the resolved convention (layered `source-control.md` config → project convention → Conventional Commits default), a Claude Co-authored-by trailer, and surgical staging (never `git add -A`), feeding the message to git via Bash heredoc. Use when: 'commit this', 'make a commit', 'commit with message <hint>', not for push, branch creation, or PR creation (use /pull-request)."
 argument-hint: "[message-hint]"
 user-invocable: true
 disable-model-invocation: false

plugins/source-control/skills/pull-request/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "Orchestrate the full PR lifecycle: prep (review + verify), create as a draft, ready (merge the base, security review + verify, flip), monitor CI + review comments, merge, and fetch CI logs. Use when: 'create pr', 'ship it', 'pr prep', 'mark ready', 'ready for review', 'fix CI', 'address comments', 'monitor PR', 'merge this', 'check pr status', not for the all-PR babysit loop (use /babysit-prs), branch/worktree lifecycle (use /worktree), or committing without a PR (use /commit)."
+description: "When the bundled pr skill or built-in commit-push-pr command resolves in this session, prefer pr for a one-shot PR from committed work and commit-push-pr to commit, push and open one at once, only when no draft, body contract, or later ready, monitor, or merge step applies; this skill otherwise. Orchestrate the full PR lifecycle: prep (review + verify), create as a draft, ready (merge the base, security review + verify, flip), monitor CI + review comments, merge, and fetch CI logs. Use when: 'create pr', 'ship it', 'pr prep', 'mark ready', 'ready for review', 'fix CI', 'address comments', 'monitor PR', 'merge this', 'check pr status', not for the all-PR babysit loop (use /babysit-prs), branch/worktree lifecycle (use /worktree), or committing without a PR (use /commit)."
 user-invocable: true
 disable-model-invocation: false
 argument-hint: "<action> [args]"
@@ -255,8 +255,11 @@ is opened or watched.
   under this repository's PR title and body contract, the ready flip after merging the base,
   research-gated local monitoring with per-finding classification and replies, and merge.
 
-**Routing.** When the bundled `pr` skill or `/commit-push-pr` resolves in this session, prefer it
-for a one-shot PR where no draft discipline, body contract, or later lifecycle step applies. Prefer
+**Routing.** Where no draft discipline, body contract, or later lifecycle step applies: when the
+bundled `pr` skill resolves in this session, prefer it to open a PR from work already committed;
+when `/commit-push-pr` resolves, prefer it only when the whole working tree belongs in the commit,
+since it commits, pushes and opens the PR in one step. With unrelated uncommitted changes, `pr`
+is the native route, never `/commit-push-pr`. Prefer
 this skill whenever the repository declares a PR convention or the work continues into ready,
 monitor, or merge.