Skip to content

docs: replace restated upstream facts with pointers in overengineering, performance, playgrounds, testing and 1 more #12699

Description

@kyle-sexton

Refs: #7292

Outcome

5 passages in 5 files state a fact an external source owns. Rewrite each as a pointer to the live upstream section, or remove it, so the next upstream change cannot leave a stale copy here. Plugins: overengineering, performance, playgrounds, testing, typos-format.

Done when

  • Every row below is fixed: the restated value is deleted, the local decision stays in this repository's own words, and the pointer goes to the exact upstream section with an as-of date and a recheck trigger, per .claude/rules/skill-bodies-state-current-rules.md. A record beside a restated value does not fix it. A row marked Remove has no local dependency on the fact.
  • The PR passes check-stamps.sh --trigger-less (plugins/attribution/skills/audit/scripts/check-stamps.sh) on the files it touches.
  • Each touched plugin has a changelog fragment.

Rows

overengineering

  • plugins/overengineering/skills/delta/context/recurring-wiring.md:37-38 (r350). Pointer: https://code.claude.com/docs/en/commands#all-commands Drop the claim that /loop is bundled and needs no install; keep the explicit-interval shape and the read-live scheduling pointer, and point at the commands list.

performance

playgrounds

  • plugins/playgrounds/skills/use/SKILL.md:92-93 (r377). Pointer: https://github.com/anthropics/claude-plugins-official (confirm the section) Drop the description of how the upstream skill writes and opens its HTML file; keep the decision to feature-detect the delivery path and point at the upstream playground skill.

testing

typos-format

  • plugins/typos-format/README.md:45-48 (r467). Pointer: https://github.com/crate-ci/typos#install Drop the list of package managers; keep the requirement that typos is on PATH, installed by the machine owner and never downloaded, with the existing install link.

Notes

Lines are as of 3bd42cabfe (https://github.com/melodic-software/claude-code-plugins/blob/3bd42cabfe6bdef37a05778d396869af0381bb51); locate each passage by its text if main has moved. Each rNNN is that row's number in the order of #7292's "Findings by plugin". Every row was upheld by three blind judges and survived a refutation pass, run report-only for #12072. Pointers are candidates: fetch each before writing it, and confirm the section still documents the fact.

Parent: #7292

Activity

  1. added
    needs-triageNot yet classified. Floor until a type and one priority tier are set.
    on Nov 3, 2026
  2. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor

    Proposed work class: work-class: scoped
    Basis: automated intake triage; the lanes App applied this class.

    Size: Medium
    Complexity: Low
    Uncertainty: Known
    Flags: none
    Blocked by: none

    Understood: five passages across five plugins (overengineering, performance, playgrounds, testing, typos-format) restate facts owned by upstream sources. Each should become a pointer to the live upstream section, with an as-of date and a recheck trigger. Each touched plugin also needs a changelog fragment, and check-stamps.sh --trigger-less must pass. The scope and done-when are clear. Two pointers are marked "confirm the section", so fetch them before writing. No duplicate found: the sibling docs pointer issues cover different plugins.

    Automated triage, applied by the lanes App.

  3. added
    priority: lowNice-to-have, cosmetic, or speculative; opportunistic.
    and removed
    needs-triageNot yet classified. Floor until a type and one priority tier are set.
    on Nov 3, 2026
  4. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor

    The triage sweep dispatched intake triage for this issue (attempt 2 of 2).

  5. added
    status: readyTriaged, unblocked, and fully specified; eligible to pick up.
    work-class: scopedA briefed fix or small feature; blast radius bounded by the brief, tests exist.
    on Nov 3, 2026
  6. added
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    and removed
    admission-deferredAdmitted but waiting for WIP room; the hourly work-unblock sweep labels it agent-ready.
    on Nov 3, 2026
  7. github-actions commented on Nov 3, 2026

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

    @melodic-automation-lanes
    Contributor

    This records a re-fire of an earlier refusal, not a new refusal. The lanes kill switch stopped run 41596365830, the work-resolve-issue run that agent-ready started, before it did any work; that run ended at 2026-11-03T08:44:24Z. work-unblock has now removed and added agent-ready back to start a fresh run. A kill-switch refusal is no fault in this issue or the lanes, so it never counts against later re-fires; after limits.limit-stops-per-issue of them since a person last added agent-ready or a run last reported, work-unblock waits longer before each one, up to 24 hours.

  9. added
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    and removed
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 3, 2026
  10. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor
    No description provided.
  11. github-actions commented on Nov 3, 2026

    @github-actions
    Contributor
    No description provided.
  12. removed
    status: readyTriaged, unblocked, and fully specified; eligible to pick up.
    agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.
    on Nov 3, 2026
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

    priority: lowNice-to-have, cosmetic, or speculative; opportunistic.work-class: scopedA briefed fix or small feature; blast radius bounded by the brief, tests exist.

    Type

    Fields

    Work status

    agent-ready

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions