Skip to content

bugs: read config from the config-cascade layers, not ~/.claude #18003

Open

Description

@kyle-sexton

Summary

bugs still reads its user-global and personal gotchas from ~/.claude and .claude/. Move both to the config-cascade layers.

Current behavior

plugins/bugs/scripts/concat-gotchas.sh:

  • :87 user="${HOME:+$HOME/.claude/bugs.md}" (user-global)
  • :90 for pair in "team:docs/conventions/bugs.md" "personal override:.claude/bugs.local.md"; do (team already at the convention home; personal at the old path)

Desired behavior

Per the config-cascade layers:

Old path Layer
~/.claude/bugs.md userConfig (no user-global file layer)
<root>/.claude/bugs.local.md personal: <home>/bugs.local.md

The script reads the contract layers; a file at an old path keeps being read during a dual-read window (see the acceptance criteria) and is reported with a warning. The canonical location list (docs/contracts/config-cascade/locations.md) lands in the docs/config-locations pull request.

Key interfaces

  • concat-gotchas.sh layer list and the layer label printed per block

Acceptance criteria

  • The resolver reads the config-cascade layers (the layers).
  • Dual-read window: while an old-path file exists, it is still read and its values still apply where no new-layer file supplies that layer; each run prints one warning naming the old file and the new location to move it to. No setting in an old file is silently dropped.
  • The plugin's setup (check/apply), where it has one, names each old file it finds and after a preview and a yes, moves its settings to the new location, checks the new location resolves the same values, then deletes the old file, so migration ends in one home, never two (owner 2026-11-21: "we don't have dual approaches, and that stuff gets cleaned up"); the dual-read warning names that setup command, so normal skill use leads to the migration.
  • Removing the old-path read is a separate later change, made only once no old file is reported.
  • Tests cover: new layer only; old file only (values apply, warning printed); both present (new wins, warning names both).

Placement rule (owner decisions 2026-11-21, #18000 Q1 and #18009 Q2)

For each key in the old user-global file, choose the new home by what the key is:

  • a per-repo convention (what a repository's commits, PRs or files must look like): the team file <home>/<concern>.yaml, with the personal override for one person in one repo; no new userConfig option;
  • a per-user value userConfig can hold (string, number, boolean, directory, file, list of strings): a userConfig option;
  • a per-user structure userConfig cannot hold (a list of objects, a nested map): one file-typed userConfig option naming the user's file, which keeps the structure as it is.

If a key fits none of these, stop as design-change and name the key.

Out of scope

Other plugins' resolvers (one issue each).

Activity

  1. added
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 21, 2026
  2. added
    needs-triageNot yet classified. Floor until a type and one priority tier are set.
    on Nov 21, 2026
  3. github-actions commented on Nov 21, 2026

    @github-actions
    Contributor

    Size: Medium
    Complexity: Medium
    Uncertainty: Knowable
    Flags: none
    Blocked by: none
    Blast radius: plugins/bugs (concat-gotchas.sh, its setup skill, tests); anyone running the bugs plugin with gotchas in ~/.claude/bugs.md or .claude/bugs.local.md.
    Reversible: yes; revert the change, and the dual-read window keeps old files working meanwhile.
    Open questions: none
    I understood this as moving the bugs plugin's user-global and personal gotcha reads onto the config-cascade layers. Old-path files stay readable during a dual-read window with a warning, and the plugin's setup migrates and deletes them. The acceptance criteria and the placement rule are exact enough to work from. I found no open duplicate and no merged fix. The sibling issues (#18000, #18001, #18002, and others) cover other plugins' resolvers, which is out of scope here.

    Automated triage. A maintainer reviews it.

  4. removed
    needs-triageNot yet classified. Floor until a type and one priority tier are set.
    on Nov 21, 2026
  5. melodic-automation-lanes commented on Nov 21, 2026

    @melodic-automation-lanes
    Contributor

    {"v":1,"actor_id":337595936,"title_sha256":"eca72de7b39cd95d67915125929b108d02e3b4c482594d17bc0a1a81c6a025a6","body_sha256":"5d9f3c559da057cb52e87f3ffb3faff405c867f576718aa22620d62265f3e128"}

  6. melodic-automation-lanes commented on Nov 21, 2026

    @melodic-automation-lanes
    Contributor

    Not admitted to the issue lane: its body was edited after it was deferred, so the admission it was deferred from judged an older body. Admission takes the issue once each of those is met, when intake triages it again (.github/actions/resolve-config/admission-rules.json).

  7. removed
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 21, 2026
  8. melodic-automation-lanes commented on Nov 21, 2026

    @melodic-automation-lanes
    Contributor

    {"v":1,"actor_id":337595936,"title_sha256":"eca72de7b39cd95d67915125929b108d02e3b4c482594d17bc0a1a81c6a025a6","body_sha256":"10f258216e7c0b348288a184d83d93657c4f0b770d5e16f7f5d3213858e6ea20"}

  9. melodic-automation-lanes commented on Nov 21, 2026

    @melodic-automation-lanes
    Contributor

    No work-resolve-issue run started in the 1 hour since agent-ready was last added. work-unblock removed and added agent-ready back to start a fresh run on main's workflow files. If this run ends the same way, it re-fires the issue again, waiting longer each time.

  10. github-actions commented on Nov 21, 2026

    @github-actions
    Contributor
    No description provided.
  11. melodic-automation-lanes commented on Nov 21, 2026

    @melodic-automation-lanes
    Contributor

    The work-resolve-issue lane stopped on this issue (issue-edited-trusted): the issue's title or body changed after agent-ready was added, and every change came from a listed human or one of our listed Apps, so intake triage refines and admits the edited text again.
    It set Work status to needs-triage, so the hourly triage sweep sends it back through intake triage, and it waits on no decision from a person.

    In the run's words:

    The run did not start: the issue's title or body changed after agent-ready was added, each change by a listed account, so the runner wrote no issue file for the skill and no model ran.

    Run: https://github.com/melodic-software/claude-code-plugins/actions/runs/44959649221

  12. github-actions commented on Nov 21, 2026

    @github-actions
    Contributor

    The triage sweep dispatched intake triage for this issue (dispatch 1; 2 runs that reach intake, or 6 dispatches, hand it to a maintainer).

  13. melodic-automation-lanes commented on Nov 21, 2026

    @melodic-automation-lanes
    Contributor

    {"v":1,"actor_id":337595936,"title_sha256":"eca72de7b39cd95d67915125929b108d02e3b4c482594d17bc0a1a81c6a025a6","body_sha256":"aa43d0ac1480f028e05ce9a0cc647bd0ec903c350652c1e21ac1cb807c67868f"}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Fields

    Work status

    agent-ready

    Priority

    medium

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions