Skip to content

docs(plugins): 39 plugin READMEs still point at unreachable repo-root LICENSE (fleet-wide follow-up to #426) #537

Description

@kyle-sexton

Summary

Issue #426 fixes the unreachable repo-root LICENSE pointer in the
markdown-format and playwright READMEs. That pointer is fleet-wide: 39
other plugin READMEs
carry the same "See the LICENSE file at the root of the
melodic-software/claude-code-plugins repository" sentence in their License
section. An installed consumer runs each plugin from an isolated cache and
cannot reach a file at the marketplace-repo root, so the pointer dangles
(cache-isolation rule: reference only files inside the plugin boundary).

Every affected README already states its license inline as MIT (SPDX-License-Identifier: MIT); the fix is pure deletion of the trailing
repo-root pointer sentence — no new per-plugin LICENSE-file convention.

Affected plugins (39)

actionlint, architecture, bash-format, biome-format, bug-report,
claude-config, claude-memory, claude-ops, code-tidying,
codebase-health, context7, debugging, desktop-notification,
discovery, docs-hygiene, domain-driven-design, education,
eol-normalizer, event-storming, firecrawl, guardrails,
implementation, kindle-dedrm, knowledge, machine-health, mcp-tools,
planning, playbooks, powershell-format, prototype, repo-hygiene,
review, ruff-format, songwriting, tdd, testing, toolchain,
verification, work-items

Reproduce: grep -rniE "at the root of|root of (the )?melodic" plugins/*/README.md.

Suggested fix

Per plugin: drop the "See the LICENSE file at the root of the …" sentence,
keeping the inline MIT (SPDX-License-Identifier: MIT); bump each plugin
version (patch) with a CHANGELOG entry — mirroring #426. Batch in scoped waves
rather than one mega-PR.

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    priority: mediumReal value, no hard deadline; normal backlog flow.status: readyTriaged, unblocked, and fully specified; eligible to pick up.

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions