From 740f631d1df214934ec0cacc3224e81624e6e0ab Mon Sep 17 00:00:00 2001 From: Defame1297 Date: Mon, 21 Sep 2026 17:28:21 +0000 Subject: [PATCH] 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 Claude-Session: https://claude.ai/code/session_01EGHFJextYtVQseaHPDDhxB --- .../.apm/skills/agentsmd-audit/references/sources.md | 3 ++- .../provider-adapter-author/references/sources.md | 5 ++++- .../.apm/skills/git-branches/references/sources.md | 8 ++++---- .../git/.apm/skills/git-commits/references/sources.md | 10 ++++++---- .../git/.apm/skills/git-history/references/sources.md | 6 +++--- .../git/.apm/skills/git-remotes/references/sources.md | 10 +++++----- .../.apm/skills/git-submodules/references/sources.md | 2 +- .../.apm/skills/git-workflow/references/sources.md | 11 ++++++----- .../.apm/skills/git-worktrees/references/sources.md | 2 +- .../git/.apm/skills/pc-author/references/sources.md | 8 ++++---- plugins/git/.apm/skills/pc-run/references/sources.md | 8 ++++---- .../.apm/skills/gitea-releases/references/sources.md | 8 ++++---- plugins/lint/.apm/skills/vale-config/SKILL.md | 1 - .../vale-config/references/configuration-reference.md | 5 ++--- .../.apm/skills/vale-config/references/sources.md | 8 -------- plugins/lint/.apm/skills/vale-run/SKILL.md | 1 - .../lint/.apm/skills/vale-run/references/sources.md | 8 -------- .../skills/vale-run/references/troubleshooting.md | 1 - 18 files changed, 46 insertions(+), 59 deletions(-) diff --git a/plugins/core/.apm/skills/agentsmd-audit/references/sources.md b/plugins/core/.apm/skills/agentsmd-audit/references/sources.md index dfd3d9a..a5cfb22 100644 --- a/plugins/core/.apm/skills/agentsmd-audit/references/sources.md +++ b/plugins/core/.apm/skills/agentsmd-audit/references/sources.md @@ -28,6 +28,7 @@ - **URL:** (org convention — not a plugin research corpus entry) - **Description:** Hard prohibition on placing secrets, API keys, tokens, or credentials in code, config, prompts, or any output. Grounds the secrets/credentials check in `scripts/validate-secrets.sh` and Step 1 of SKILL.md — AGENTS.md is committed content, so an embedded real secret is a hard-prohibition violation, not a style nit. -- **Research doc:** core/instructions/governance.md (org convention file, not a plugin research corpus entry; content is inlined here since plugins must be self-contained and this file may not exist wherever the plugin is installed) +- **Research doc:** none — org convention, not a plugin research corpus entry +- **Basis:** core/instructions/governance.md (content is inlined here since plugins must be self-contained and this file may not exist wherever the plugin is installed) - **Contributing files:** SKILL.md - **Status:** `extracted` diff --git a/plugins/core/.apm/skills/provider-adapter-author/references/sources.md b/plugins/core/.apm/skills/provider-adapter-author/references/sources.md index 654c51d..81d7268 100644 --- a/plugins/core/.apm/skills/provider-adapter-author/references/sources.md +++ b/plugins/core/.apm/skills/provider-adapter-author/references/sources.md @@ -4,6 +4,9 @@ - **URL:** (in-repo precedent — not an external source or plugin research corpus entry) - **Description:** This repo's own two-tier CLAUDE.md/AGENTS.md pattern: AGENTS.md is the provider-agnostic source of always-on rules; provider-specific files (CLAUDE.md) become thin adapters that import it (`@AGENTS.md` plus provider-specific additions). Grounds this skill's entire adapter-conversion design — the "thin adapter" shape, the `@`-import convention, and the size/duplication expectations enforced by `scripts/validate-adapter.sh`. -- **Research doc:** docs/adr/0002-two-tier-claude-md.md, docs/adr/0003-agents-md-provider-agnostic-entry-point.md, providers/claude-code/CLAUDE.md (in-repo ADRs and a live example, not a plugin research corpus entry; referenced here since this skill's design is modeled directly on an existing implementation rather than external research) +- **Research doc:** none — in-repo ADRs and a live example, not a plugin research corpus entry; this skill's design is modeled directly on an existing implementation rather than external research +- **Basis:** docs/adr/0002-two-tier-claude-md.md +- **Basis:** docs/adr/0003-agents-md-provider-agnostic-entry-point.md +- **Basis:** providers/claude-code/CLAUDE.md - **Contributing files:** SKILL.md, references/provider-matrix.md - **Status:** `extracted` diff --git a/plugins/git/.apm/skills/git-branches/references/sources.md b/plugins/git/.apm/skills/git-branches/references/sources.md index 506756c..607e3ec 100644 --- 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) diff --git a/plugins/git/.apm/skills/git-commits/references/sources.md b/plugins/git/.apm/skills/git-commits/references/sources.md index 960d8b3..4a3a2af 100644 --- 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 diff --git a/plugins/git/.apm/skills/git-history/references/sources.md b/plugins/git/.apm/skills/git-history/references/sources.md index fff5f45..7b98f21 100644 --- 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 diff --git a/plugins/git/.apm/skills/git-remotes/references/sources.md b/plugins/git/.apm/skills/git-remotes/references/sources.md index f2ad70e..31d4a78 100644 --- 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) diff --git a/plugins/git/.apm/skills/git-submodules/references/sources.md b/plugins/git/.apm/skills/git-submodules/references/sources.md index fd3adbc..fdc3c47 100644 --- 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) diff --git a/plugins/git/.apm/skills/git-workflow/references/sources.md b/plugins/git/.apm/skills/git-workflow/references/sources.md index 1d8177c..bc03e99 100644 --- 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) diff --git a/plugins/git/.apm/skills/git-worktrees/references/sources.md b/plugins/git/.apm/skills/git-worktrees/references/sources.md index 54fecc3..2a80855 100644 --- 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) diff --git a/plugins/git/.apm/skills/pc-author/references/sources.md b/plugins/git/.apm/skills/pc-author/references/sources.md index 24f21a3..424d352 100644 --- 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` diff --git a/plugins/git/.apm/skills/pc-run/references/sources.md b/plugins/git/.apm/skills/pc-run/references/sources.md index eb6a423..1cf5f18 100644 --- 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` diff --git a/plugins/gitea/.apm/skills/gitea-releases/references/sources.md b/plugins/gitea/.apm/skills/gitea-releases/references/sources.md index c701c58..6b559d7 100644 --- a/plugins/gitea/.apm/skills/gitea-releases/references/sources.md +++ b/plugins/gitea/.apm/skills/gitea-releases/references/sources.md @@ -4,7 +4,7 @@ - **URL:** https://gitea.com/gitea/gitea-mcp - **Description:** Official gitea-mcp repository; operation/*.go source files documenting the MCP tools, their parameters, and CLI flags. Originally extracted at v1.3.0; the input parameter schemas in `references/call-signatures.md` were re-verified live via `ToolSearch` against the deployed server, **last verified at v1.7.0** as reported by `get_gitea_mcp_server_version`. -- **Research doc:** plugins/gitea/docs/research/docs/gitea/api-reference.md (Releases and Tags section); plugins/gitea/docs/research/docs/gitea/troubleshooting.md (`delete_release` numeric-id gotcha, `per_page` defaults) +- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md (digested in gitea/api-reference.md, Releases and Tags section, and gitea/troubleshooting.md, `delete_release` numeric-id gotcha and `per_page` defaults) **Contributing files:** - SKILL.md (Dispatch table, Gotchas) @@ -16,7 +16,7 @@ - **URL:** https://gitea.com/gitea/gitea-mcp/raw/branch/main/operation/repo/slim.go - **Description:** Slim response shape structs from gitea-mcp source; defines exactly which fields the MCP server returns for tags and releases. -- **Research doc:** plugins/gitea/docs/research/docs/gitea/api-reference.md (Releases and Tags response shapes) +- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md (digested in gitea/api-reference.md, Releases and Tags response shapes) **Contributing files:** - references/call-signatures.md (release/tag object shapes) @@ -27,7 +27,7 @@ - **URL:** context7:/websites/gitea - **Description:** Official Gitea docs mirror on Context7 (docs.gitea.com content) — release and tag semantics, draft/prerelease behavior. -- **Research doc:** plugins/gitea/docs/research/docs/gitea/workflow-conventions.md (Release and tag conventions section) +- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md (digested in gitea/workflow-conventions.md, Release and tag conventions section) **Contributing files:** - SKILL.md (Gotchas — draft/prerelease as explicit flags) @@ -39,7 +39,7 @@ - **URL:** context7:/git_gitea_com/gitea_tea - **Description:** Official `tea` CLI (reference Gitea client) docs on Context7 — practitioner release/tag command patterns, semver tag conventions, draft/prerelease flags, release-notes-from-file conventions. -- **Research doc:** plugins/gitea/docs/research/docs/gitea/workflow-conventions.md (Release and tag conventions section) +- **Research doc:** plugins/gitea/docs/research/docs/gitea/sources.md (digested in gitea/workflow-conventions.md, Release and tag conventions section) **Contributing files:** - references/conventions.md (semver tag naming, release-notes sourcing) diff --git a/plugins/lint/.apm/skills/vale-config/SKILL.md b/plugins/lint/.apm/skills/vale-config/SKILL.md index 7ae5a67..4f83b90 100644 --- a/plugins/lint/.apm/skills/vale-config/SKILL.md +++ b/plugins/lint/.apm/skills/vale-config/SKILL.md @@ -11,7 +11,6 @@ metadata: version: "0.1.3" source_keys: - context7-websites-vale-sh - - house-vale-3-15-2-repro --- ## Gotchas diff --git a/plugins/lint/.apm/skills/vale-config/references/configuration-reference.md b/plugins/lint/.apm/skills/vale-config/references/configuration-reference.md index b572d41..5b890b6 100644 --- a/plugins/lint/.apm/skills/vale-config/references/configuration-reference.md +++ b/plugins/lint/.apm/skills/vale-config/references/configuration-reference.md @@ -2,7 +2,6 @@ topic: configuration-reference source_keys: - context7-websites-vale-sh - - house-vale-3-15-2-repro --- ## Core Settings @@ -82,7 +81,7 @@ Only *package* styles need fetching. A style whose YAML rule files are already c - `Vale.Avoid` — enforces the project's rejected vocabulary terms. - `Vale.Repetition` — flags repeated words (e.g. "the the"). -`Packages` (top-level, what `vale sync` downloads) and `BasedOnStyles` (per-glob, what activates) are separate keys: a style lints a file only once it is in both. Every row below reproduced against Vale 3.15.2 (slug `house-vale-3-15-2-repro`): +`Packages` (top-level, what `vale sync` downloads) and `BasedOnStyles` (per-glob, what activates) are separate keys: a style lints a file only once it is in both. Every row below reproduced against Vale 3.15.2: | Configuration | Result | |---|---| @@ -98,7 +97,7 @@ Only *package* styles need fetching. A style whose YAML rule files are already c ## Frontmatter Scopes -House-verified behaviour, not documented on vale.sh — reproduced locally against Vale 3.15.2 (slug `house-vale-3-15-2-repro`). +House-verified behaviour, not documented on vale.sh — reproduced locally against Vale 3.15.2. A rule scoped to `text.frontmatter.` (e.g. `text.frontmatter.description`) matches reliably when that field's value is a single physical line, and breaks on most — not all — multi-line forms. Multi-line forms spanning 2+ lines: diff --git a/plugins/lint/.apm/skills/vale-config/references/sources.md b/plugins/lint/.apm/skills/vale-config/references/sources.md index c4a918e..854fe15 100644 --- a/plugins/lint/.apm/skills/vale-config/references/sources.md +++ b/plugins/lint/.apm/skills/vale-config/references/sources.md @@ -7,11 +7,3 @@ - **Research doc:** plugins/lint/docs/research/docs/vale/sources.md - **Contributing files:** SKILL.md, references/configuration-reference.md - **Status:** `extracted` - -## house-vale-3-15-2-repro - -- **URL:** (house-verified — reproduced locally against the `vale` binary, not an external source) -- **Description:** Behaviour of Vale 3.15.2 established by running it against purpose-built fixtures in this repo, where vale.sh documents nothing: the `E100 [loadStyles]` / exit-2 failure for a `BasedOnStyles` name absent from `StylesPath`, `vale sync` reporting `Synced 0 package(s)` for a name not declared in `Packages`, the `E201` / exit-2 failure when the `StylesPath` directory does not exist, the exit-0 no-op of an empty style directory, the `E201` / exit-2 failure when a core option is written below a `[glob]` header (with `Packages` as the silent exception), and the `text.frontmatter.` scope matrix across multi-line YAML forms. -- **Research doc:** none — house-verified reproduction, not part of the plugin's research corpus (no `plugins/lint/docs/research/` topic file backs this entry) -- **Contributing files:** SKILL.md, references/configuration-reference.md -- **Status:** `extracted` diff --git a/plugins/lint/.apm/skills/vale-run/SKILL.md b/plugins/lint/.apm/skills/vale-run/SKILL.md index 5d90c43..c4c65de 100644 --- a/plugins/lint/.apm/skills/vale-run/SKILL.md +++ b/plugins/lint/.apm/skills/vale-run/SKILL.md @@ -10,7 +10,6 @@ metadata: category: lint source_keys: - context7-websites-vale-sh - - house-vale-3-15-2-repro --- ## Gotchas diff --git a/plugins/lint/.apm/skills/vale-run/references/sources.md b/plugins/lint/.apm/skills/vale-run/references/sources.md index 196d43a..279ef95 100644 --- a/plugins/lint/.apm/skills/vale-run/references/sources.md +++ b/plugins/lint/.apm/skills/vale-run/references/sources.md @@ -7,11 +7,3 @@ - **Research doc:** plugins/lint/docs/research/docs/vale/sources.md - **Contributing files:** SKILL.md, references/troubleshooting.md - **Status:** `extracted` - -## house-vale-3-15-2-repro - -- **URL:** (house-verified — reproduced locally against the `vale` binary, not an external source) -- **Description:** Behaviour of Vale 3.15.2 established by running it against purpose-built fixtures in this repo, where vale.sh documents nothing or documents it wrongly: `.mdx` has no built-in support and needs either `[formats] mdx = md` or an external `mdx2vast` binary (absent, the whole invocation exits 2 with `E100 [lintMDX]`), the inline-suppression form inverts between those two configurations, the `spelling` check's `ignore` paths resolve against `StylesPath` or the working directory but never against the rule file's own directory and fail silently when they resolve nowhere, `ls-config` reports styles and paths but never rules, and the `text.frontmatter.` scope matrix across multi-line YAML forms. -- **Research doc:** none — house-verified reproduction, not part of the plugin's research corpus (no `plugins/lint/docs/research/` topic file backs this entry) -- **Contributing files:** SKILL.md, references/troubleshooting.md -- **Status:** `extracted` diff --git a/plugins/lint/.apm/skills/vale-run/references/troubleshooting.md b/plugins/lint/.apm/skills/vale-run/references/troubleshooting.md index a00a777..d2f6dcd 100644 --- a/plugins/lint/.apm/skills/vale-run/references/troubleshooting.md +++ b/plugins/lint/.apm/skills/vale-run/references/troubleshooting.md @@ -1,7 +1,6 @@ --- source_keys: - context7-websites-vale-sh - - house-vale-3-15-2-repro --- # Vale troubleshooting reference