diff --git a/.claude/source-control.md b/.claude/source-control.md
deleted file mode 100644
index 57acc12..0000000
--- a/.claude/source-control.md
+++ /dev/null
@@ -1,40 +0,0 @@
-# source-control configuration
-
-Team-tracked layer consumed by the `source-control@melodic-software` plugin. Key names, valid
-values, and resolution order are defined upstream in
-<https://github.com/melodic-software/claude-code-plugins/blob/main/plugins/source-control/reference/config-resolution.md>
-— the `babysit_loop_*` keys under "Loop-lane keys (`babysit_loop_*`)", and
-`pr_body_required_sections` under "The config surface". The merge-rung ladder and the ratification
-rule that makes this reviewed file the recorded baseline are defined in
-<https://github.com/melodic-software/claude-code-plugins/blob/main/docs/conventions/loop-lane/README.md>.
-
-`pr_body_required_sections` below mirrors the body contract the single required check `ci-status`
-reports on, and that contract is authoritative:
-[`.claude/rules/pr-body-contract.md`](rules/pr-body-contract.md) states it in full, including the
-closing-keyword (or `No related issue`) requirement this key's grammar cannot express. The body
-contract is advisory, not gating: `ci-status` leaves a comment and the `needs-issue-linkage` label
-instead of failing. The key is a closed literal list of heading names with no pointer form, so the
-headings are necessarily restated here; never move them independently of that contract.
-
-## babysit_loop_stop_mode
-
-standing
-
-## babysit_loop_tier
-
-worker
-
-## babysit_loop_merge
-
-c3-autonomous
-
-## babysit_loop_grace_window_minutes
-
-30
-
-## pr_body_required_sections
-
-- Summary
-- Fix
-- Verification
-- Related
diff --git a/docs/conventions/source-control.yaml b/docs/conventions/source-control.yaml
new file mode 100644
index 0000000..6396ad8
--- /dev/null
+++ b/docs/conventions/source-control.yaml
@@ -0,0 +1,23 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/melodic-software/claude-code-plugins/main/plugins/source-control/schemas/source-control.schema.json
+# Team layer of the source-control plugin's settings. Keys, values and resolution:
+# https://github.com/melodic-software/claude-code-plugins/blob/main/plugins/source-control/reference/config-resolution.md
+# (the babysit_loop_* keys under "Loop-lane keys", pr_body_required_sections under "The config
+# surface"). The merge-rung ladder and the ratification rule that makes this reviewed file the
+# recorded baseline: https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/loop-lane/README.md
+#
+# pr_body_required_sections mirrors the body contract the single required check `ci-status`
+# reports on, and that contract is authoritative: .claude/rules/pr-body-contract.md states it in
+# full, including the closing-keyword (or `No related issue`) requirement this key's grammar cannot
+# express. The body contract is advisory, not gating: `ci-status` leaves a comment and the
+# `needs-issue-linkage` label instead of failing. The key is a closed literal list of heading names
+# with no pointer form, so the headings are restated here; never move them independently of that
+# contract.
+babysit_loop_stop_mode: standing
+babysit_loop_tier: worker
+babysit_loop_merge: c3-autonomous
+babysit_loop_grace_window_minutes: 30
+pr_body_required_sections:
+  - Summary
+  - Fix
+  - Verification
+  - Related