docs(provenance): migrate the corpus to the Research registry grammar

Repoint every `Research doc:` at the plugin's Research registry (git/sources.md, pre-commit/sources.md, gitea/sources.md, agentsmd/sources.md), keeping the old topic-doc link as a parenthetical `(digest: ...)` annotation. Brace expansions and the gitea-releases semicolon pair collapse to one path. Entries with no registry (org-commit-conventions, org-git-conventions, governance-secrets-hard-prohibition, adr-0002-0003-two-tier-claude-md) now declare `none` plus `Basis:` bullets. The two git entries cite core/instructions/git.md and commits.md as `(removed in 5deed07)`. Remove the house-vale-3-15-2-repro entry and its source_keys citations from vale-config and vale-run. It claimed six behaviours were reproduced against purpose-built fixtures in this repo, but the entry was added in d1afdbe with no test or fixture files, and none exists in history. The behavioural rules stay; only the unbacked provenance claim goes. Refs: #121 ADR: 0028 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EGHFJextYtVQseaHPDDhxB
2026-09-21 17:28:21 +00:00
parent 5a52949c57
commit 740f631d1d
18 changed files with 46 additions and 59 deletions
--- a/plugins/git/.apm/skills/git-branches/references/sources.md
+++ b/plugins/git/.apm/skills/git-branches/references/sources.md
@@ -9,7 +9,7 @@

 **Source:** https://nvie.com/posts/a-successful-git-branching-model/

- **Research doc:** plugins/git/docs/research/docs/git/gitflow.md (whole-document reference)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/gitflow.md — whole-document reference)

 **Contributing files:**
 - SKILL.md (Gitflow vs. GitHub Flow inference and the not-mixable rule)
@@ -21,7 +21,7 @@

 **Source:** https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow

- **Research doc:** plugins/git/docs/research/docs/git/gitflow.md (whole-document reference)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/gitflow.md — whole-document reference)

 **Contributing files:**
 - SKILL.md (Gitflow vs. GitHub Flow inference and the not-mixable rule)
@@ -34,7 +34,7 @@

 **Source:** https://danielkummer.github.io/git-flow-cheatsheet/

- **Research doc:** plugins/git/docs/research/docs/git/gitflow.md (whole-document reference)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/gitflow.md — whole-document reference)

 **Contributing files:**
 - references/branch-patterns.md (feature/release/hotfix naming conventions)
@@ -45,7 +45,7 @@

 **Source:** context7:/git/htmldocs

- **Research doc:** plugins/git/docs/research/docs/git/branching-merging.md (whole-document reference)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/branching-merging.md — whole-document reference)

 **Contributing files:**
 - SKILL.md (Gotchas — `git switch` abort-on-conflict behaviour, branch/tag name ambiguity)
--- a/plugins/git/.apm/skills/git-commits/references/sources.md
+++ b/plugins/git/.apm/skills/git-commits/references/sources.md
@@ -14,27 +14,29 @@ Sources extracted from the git plugin research phase. Only sources that directly
 ## conventional-commits-spec

 - **Description:** Conventional Commits Specification (v1.0.0) — message format, types, breaking changes, footer rules
- **Research doc:** plugins/git/docs/research/docs/git/commits.md § "Conventional Commits Specification (v1.0.0)"
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/commits.md § "Conventional Commits Specification (v1.0.0)")
 - **Contributing files:** SKILL.md, references/conventional-commits-spec.md, references/create-commit.md
 - **Status:** extracted

 ## commitlint-config-conventional

 - **Description:** commitlint config-conventional preset — validation constraints (max 100 chars header, no trailing periods, lowercase type, 11-type set enforcement)
- **Research doc:** plugins/git/docs/research/docs/git/commits.md § "commitlint Constraints (`config-conventional`)"
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/commits.md § "commitlint Constraints (`config-conventional`)")
 - **Contributing files:** SKILL.md, references/conventional-commits-spec.md, references/create-commit.md
 - **Status:** extracted

 ## org-commit-conventions

 - **Description:** Organization commit message body template and git conventions (atomic commits, no `--no-verify`, no force-push main/master, `rtk git` wrapper) — content fully embedded in this skill; the org's `core/instructions/git.md` and `core/instructions/commits.md` are provenance only and are not a live dependency
- **Research doc:** core/instructions/commits.md, core/instructions/git.md (org convention, not part of the plugin's research corpus)
+- **Research doc:** none
+- **Basis:** core/instructions/commits.md (removed in 5deed07)
+- **Basis:** core/instructions/git.md (removed in 5deed07)
 - **Contributing files:** SKILL.md, references/commit-template.md, references/create-commit.md, references/rewrite-history.md
 - **Status:** extracted

 ## context7-git-htmldocs

 - **Description:** Official Git HTML documentation — `git commit --squash`/`--fixup`, `git rebase --autosquash`, and `git cherry-pick` range and abort semantics
- **Research doc:** plugins/git/docs/research/docs/git/cli-reference.md § "Committing", § "Rebasing", § "Cherry-picking"
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/cli-reference.md § "Committing", § "Rebasing", § "Cherry-picking")
 - **Contributing files:** SKILL.md, references/rewrite-history.md, references/cherry-pick.md
 - **Status:** extracted
--- a/plugins/git/.apm/skills/git-history/references/sources.md
+++ b/plugins/git/.apm/skills/git-history/references/sources.md
@@ -10,7 +10,7 @@ source_keys:

 Git bisect documentation covering binary search through commit history to find the commit that introduced a bug. Includes manual flow, automated mode with exit codes, skip patterns, and visualization options.

- **Research doc:** plugins/git/docs/research/docs/git/history-inspection.md
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/history-inspection.md)
 - **Doc heading:** `## git bisect`
 - **Contributing files:** SKILL.md, references/bisect.md

@@ -18,7 +18,7 @@ Git bisect documentation covering binary search through commit history to find t

 Git log documentation covering format presets, custom format placeholders (commit identity, author, committer, message, refs, GPG signature), pickaxe search (`-S` and `-G`), `--follow` for file renames, `--diff-filter`, and line-range history (`-L`).

- **Research doc:** plugins/git/docs/research/docs/git/history-inspection.md
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/history-inspection.md)
 - **Doc heading:** `## git log — Format and Filtering`
 - **Contributing files:** SKILL.md, references/git-log-format.md

@@ -26,6 +26,6 @@ Git log documentation covering format presets, custom format placeholders (commi

 Git diff documentation covering output control (--stat, --name-only, --name-status, --word-diff) and whitespace handling flags.

- **Research doc:** plugins/git/docs/research/docs/git/history-inspection.md
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/history-inspection.md)
 - **Doc heading:** `## git diff — Output Control`
 - **Contributing files:** SKILL.md, references/git-log-format.md
--- a/plugins/git/.apm/skills/git-remotes/references/sources.md
+++ b/plugins/git/.apm/skills/git-remotes/references/sources.md
@@ -9,7 +9,7 @@

 **Source:** https://git-scm.com/docs/git-remote

- **Research doc:** plugins/git/docs/research/docs/git/remotes.md → `## Remote Management (`git remote`)`
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/remotes.md → `## Remote Management (`git remote`)`)

 **Contributing files:**
 - references/remote-config.md
@@ -22,7 +22,7 @@

 **Source:** https://git-scm.com/docs/git-fetch

- **Research doc:** plugins/git/docs/research/docs/git/remotes.md → `## Fetching (`git fetch`)`
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/remotes.md → `## Fetching (`git fetch`)`)

 **Contributing files:**
 - SKILL.md (Gotchas — prune does not touch tags)
@@ -36,7 +36,7 @@

 **Source:** https://git-scm.com/docs/git-push

- **Research doc:** plugins/git/docs/research/docs/git/remotes.md → `## Pushing (`git push`)`
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/remotes.md → `## Pushing (`git push`)`)

 **Contributing files:**
 - SKILL.md (Gotchas — `--force-with-lease` caveat; Step 1 force-push gate)
@@ -50,7 +50,7 @@

 **Source:** https://git-scm.com/docs/git-pull

- **Research doc:** plugins/git/docs/research/docs/git/remotes.md → `## Pulling (`git pull`)`
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/remotes.md → `## Pulling (`git pull`)`)

 **Contributing files:**
 - SKILL.md (Gotchas — pull default drift)
@@ -64,7 +64,7 @@

 **Source:** Context7 MCP / Git library

- **Research doc:** plugins/git/docs/research/docs/git/remotes.md (cross-cutting — no dedicated section)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/remotes.md — cross-cutting — no dedicated section)

 **Contributing files:**
 - SKILL.md (all sections)
--- a/plugins/git/.apm/skills/git-submodules/references/sources.md
+++ b/plugins/git/.apm/skills/git-submodules/references/sources.md
@@ -10,7 +10,7 @@ source_keys:

 **Source:** https://git-scm.com/docs/git-submodule

- **Research doc:** plugins/git/docs/research/docs/git/submodules.md (whole-document reference — the research doc is organized by descriptive prose headings such as "Concept Overview" and "Key Commands" rather than a heading matching this slug; this key covers the entire doc, not a single section)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/submodules.md — whole-document reference — the research doc is organized by descriptive prose headings such as "Concept Overview" and "Key Commands" rather than a heading matching this slug; this key covers the entire doc, not a single section)

 **Contributing files:**
 - SKILL.md (all sections)
--- a/plugins/git/.apm/skills/git-workflow/references/sources.md
+++ b/plugins/git/.apm/skills/git-workflow/references/sources.md
@@ -9,7 +9,7 @@

 **Source:** https://nvie.com/posts/a-successful-git-branching-model/

- **Research doc:** plugins/git/docs/research/docs/git/gitflow.md (whole-document reference)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/gitflow.md — whole-document reference)

 **Contributing files:**
 - SKILL.md (Interaction style — branching-model-aware tips)
@@ -20,7 +20,7 @@

 **Source:** https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow

- **Research doc:** plugins/git/docs/research/docs/git/gitflow.md (whole-document reference)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/gitflow.md — whole-document reference)

 **Contributing files:**
 - SKILL.md (Interaction style — branching-model-aware tips)
@@ -31,7 +31,7 @@

 **Source:** https://danielkummer.github.io/git-flow-cheatsheet/

- **Research doc:** plugins/git/docs/research/docs/git/gitflow.md (whole-document reference)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/gitflow.md — whole-document reference)

 **Contributing files:**
 - SKILL.md (Interaction style — branching-model-aware tips)
@@ -42,7 +42,7 @@

 **Source:** context7:/git/htmldocs

- **Research doc:** plugins/git/docs/research/docs/git/overview.md (whole-document reference)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/overview.md — whole-document reference)

 **Contributing files:**
 - SKILL.md (Workflow — general git operation vocabulary)
@@ -53,7 +53,8 @@

 **Source:** org-internal (formerly `core/instructions/git.md` in this repo, prior to its removal)

- **Research doc:** none — org convention, not part of the plugin's research corpus (no `plugins/git/docs/research/` topic file backs this entry)
+- **Research doc:** none
+- **Basis:** core/instructions/git.md (removed in 5deed07)

 **Contributing files:**
 - references/hard-rules.md (whole file — the eight hard rules and the conflict-handling rule)
--- a/plugins/git/.apm/skills/git-worktrees/references/sources.md
+++ b/plugins/git/.apm/skills/git-worktrees/references/sources.md
@@ -9,7 +9,7 @@

 **Source:** https://git-scm.com/docs/git-worktree

- **Research doc:** plugins/git/docs/research/docs/git/worktrees.md (whole-document reference — covers `## Concept Overview`, `## Key Commands`, `## Workflow Patterns`, `## Common Gotchas`, `## Configuration`)
+- **Research doc:** plugins/git/docs/research/docs/git/sources.md (digest: plugins/git/docs/research/docs/git/worktrees.md — whole-document reference — covers `## Concept Overview`, `## Key Commands`, `## Workflow Patterns`, `## Common Gotchas`, `## Configuration`)

 **Contributing files:**
 - SKILL.md (Gotchas, Step 1 dispatch table and per-operation gates, Step 2 report format)
--- a/plugins/git/.apm/skills/pc-author/references/sources.md
+++ b/plugins/git/.apm/skills/pc-author/references/sources.md
@@ -5,7 +5,7 @@
 - **URL:** context7:/pre-commit/pre-commit.com
 - **Description:** Official pre-commit.com documentation — installation, configuration schema, CLI reference, hook authoring, advanced features, troubleshooting
 - **Contributing files:** SKILL.md, references/create-config.md, references/modify-config.md, references/hooks-by-language.md
- **Research doc:** plugins/git/docs/research/docs/pre-commit/{overview,configuration,cli-reference,hook-authoring}.md
+- **Research doc:** plugins/git/docs/research/docs/pre-commit/sources.md (digest: plugins/git/docs/research/docs/pre-commit/overview.md, plugins/git/docs/research/docs/pre-commit/configuration.md, plugins/git/docs/research/docs/pre-commit/cli-reference.md, plugins/git/docs/research/docs/pre-commit/hook-authoring.md)
 - **Status:** `extracted`

 ## pre-commit-com
@@ -13,7 +13,7 @@
 - **URL:** https://pre-commit.com/
 - **Description:** Pre-commit framework homepage — full docs covering install, config, CLI, hook authoring, stages, local hooks, meta hooks, hazmat helpers, CI integration
 - **Contributing files:** SKILL.md, references/create-config.md, references/modify-config.md, references/hooks-by-language.md
- **Research doc:** plugins/git/docs/research/docs/pre-commit/{overview,configuration,cli-reference,hook-authoring}.md
+- **Research doc:** plugins/git/docs/research/docs/pre-commit/sources.md (digest: plugins/git/docs/research/docs/pre-commit/overview.md, plugins/git/docs/research/docs/pre-commit/configuration.md, plugins/git/docs/research/docs/pre-commit/cli-reference.md, plugins/git/docs/research/docs/pre-commit/hook-authoring.md)
 - **Status:** `extracted`

 ## context7-pre-commit-hooks
@@ -21,7 +21,7 @@
 - **URL:** context7:/pre-commit/pre-commit-hooks
 - **Description:** Official pre-commit-hooks collection — all available hook IDs with options and examples
 - **Contributing files:** references/hooks-by-language.md
- **Research doc:** plugins/git/docs/research/docs/pre-commit/hooks-reference.md § pre-commit-hooks (official collection)
+- **Research doc:** plugins/git/docs/research/docs/pre-commit/sources.md (digest: plugins/git/docs/research/docs/pre-commit/hooks-reference.md § pre-commit-hooks (official collection))
 - **Status:** `extracted`

 ## pre-commit-hooks-github
@@ -29,5 +29,5 @@
 - **URL:** https://raw.githubusercontent.com/pre-commit/pre-commit-hooks/main/README.md
 - **Description:** Official pre-commit-hooks README — complete hook listing with all args, categories, deprecated hooks, and latest version (v6.0.0)
 - **Contributing files:** references/hooks-by-language.md
- **Research doc:** plugins/git/docs/research/docs/pre-commit/hooks-reference.md § pre-commit-hooks (official collection), § Deprecated hooks
+- **Research doc:** plugins/git/docs/research/docs/pre-commit/sources.md (digest: plugins/git/docs/research/docs/pre-commit/hooks-reference.md § pre-commit-hooks (official collection), § Deprecated hooks)
 - **Status:** `extracted`
--- a/plugins/git/.apm/skills/pc-run/references/sources.md
+++ b/plugins/git/.apm/skills/pc-run/references/sources.md
@@ -5,7 +5,7 @@
 - **URL:** context7:/pre-commit/pre-commit.com
 - **Description:** Official pre-commit.com documentation — installation, configuration schema, CLI reference, hook authoring, advanced features, troubleshooting
 - **Contributing files:** SKILL.md, references/install.md, references/autoupdate.md, references/clean.md, references/failure-patterns.md
- **Research doc:** plugins/git/docs/research/docs/pre-commit/{overview,cli-reference,troubleshooting}.md
+- **Research doc:** plugins/git/docs/research/docs/pre-commit/sources.md (digest: plugins/git/docs/research/docs/pre-commit/overview.md, plugins/git/docs/research/docs/pre-commit/cli-reference.md, plugins/git/docs/research/docs/pre-commit/troubleshooting.md)
 - **Status:** `extracted`

 ## pre-commit-com
@@ -13,7 +13,7 @@
 - **URL:** https://pre-commit.com/
 - **Description:** Pre-commit framework homepage — full docs covering install, config, CLI, hook authoring, stages, local hooks, meta hooks, hazmat helpers, CI integration
 - **Contributing files:** SKILL.md, references/install.md, references/autoupdate.md, references/clean.md, references/failure-patterns.md
- **Research doc:** plugins/git/docs/research/docs/pre-commit/{overview,cli-reference,troubleshooting}.md
+- **Research doc:** plugins/git/docs/research/docs/pre-commit/sources.md (digest: plugins/git/docs/research/docs/pre-commit/overview.md, plugins/git/docs/research/docs/pre-commit/cli-reference.md, plugins/git/docs/research/docs/pre-commit/troubleshooting.md)
 - **Status:** `extracted`

 ## context7-pre-commit-hooks
@@ -21,7 +21,7 @@
 - **URL:** context7:/pre-commit/pre-commit-hooks
 - **Description:** Official pre-commit-hooks collection — all available hook IDs with options and examples
 - **Contributing files:** (none)
- **Research doc:** plugins/git/docs/research/docs/pre-commit/hooks-reference.md § "pre-commit-hooks (official collection)"
+- **Research doc:** plugins/git/docs/research/docs/pre-commit/sources.md (digest: plugins/git/docs/research/docs/pre-commit/hooks-reference.md § "pre-commit-hooks (official collection)")
 - **Status:** `extracted`

 ## pre-commit-hooks-github
@@ -29,5 +29,5 @@
 - **URL:** https://raw.githubusercontent.com/pre-commit/pre-commit-hooks/main/README.md
 - **Description:** Official pre-commit-hooks README — complete hook listing with all args, categories, deprecated hooks, and latest version
 - **Contributing files:** (none)
- **Research doc:** plugins/git/docs/research/docs/pre-commit/hooks-reference.md § "pre-commit-hooks (official collection)"
+- **Research doc:** plugins/git/docs/research/docs/pre-commit/sources.md (digest: plugins/git/docs/research/docs/pre-commit/hooks-reference.md § "pre-commit-hooks (official collection)")
 - **Status:** `extracted`