refactor(bugs): move the .claude/bugs.md settings to docs/conventions/bugs.yaml #9730

Parent

Refs #5906

Depends on

• none: on the frontier now

Outcome

The bugs, harness-ops settings this repository keeps in .claude/bugs.md (its fenced YAML block) resolve from docs/conventions/bugs.yaml,
validated by a schema the plugin ships. The old location is read only when the YAML is absent, for one release.
The setup skill, if the plugin has one, writes the YAML.

Decisions

• ADR 0064 Decision 1: a plugin's team settings live in one docs/conventions/<concern>.yaml, validated by a
  JSON Schema at plugins/<plugin>/schemas/<concern>.schema.json (Decision 6), checked in CI by
  scripts/check-convention-yaml.sh (Decision 7). Script readers use the shared reader lib/parse-concern-value.sh.
• ADR 0075: layers are plugin default < userConfig < team <home>/<concern>.yaml < personal
  <home>/<concern>.local.<ext>; every resolver reports the layer that supplied each value.
• Migrate per-skill .claude config files to userConfig, one conventions doc, or the cascade (ADR 0018) #5906 (comment 2026-10-04): each reader keeps reading the old file for one release when the new file is
  absent, and this repository keeps its old file until the cleanup slice.

Key interfaces

• /bugs:scan's lane and filing-posture reader, plugins/bugs/reference/config.md, harness-ops' mention. The prose stays as docs/conventions/bugs.md (ADR 0075: prose in <concern>.md).

Done when

• docs/conventions/bugs.yaml carries every value of .claude/bugs.md (its fenced YAML block) and scripts/check-convention-yaml.sh --check exits 0 against plugins/bugs/schemas/bugs.schema.json.
• scripts/run-test-file.sh plugins/bugs/scripts/concat-gotchas.test.sh exits 0.
• The skill bodies that read the settings name docs/conventions/bugs.yaml first and the old location only as the one-release fallback (git grep -n "docs/conventions/bugs.yaml" -- plugins/bugs/skills prints each).
• No skill body tells an agent to read or write the old location: git grep -n for it under plugins/bugs, plugins/harness-ops prints only compatibility-read code, its tests and changelog lines.
• The PR body lists each migrated setting with its new home and schema.
• scripts/check-changelog-fragments.sh --check-required origin/main exits 0.

Out of scope

• Deleting this repository's old file or block (the cleanup slice under Migrate per-skill .claude config files to userConfig, one conventions doc, or the cascade (ADR 0018) #5906).