Skip to content

docs(upstream): re-audit the six drifted upstream pages by agent, owner only for design changes #16486

Closed
2 of 2 issues completed

Description

@kyle-sexton

Six upstream-drift issues sit untriaged, because the drift contract keeps each adoption a person's decision. Have an agent re-audit each drifted page instead, and bring the owner only a change to a skill's design.

Problem

The upstream-drift workflow filed #16403, #16404, #16405, #16406, #16407 and #16408 on 2026-11-15. All six are labeled needs-human and none is triaged. docs/contracts/upstream-drift/README.md:528-531 says "Whether to adopt an upstream change stays a person's decision". The triage sweep skips issues filed by github-actions[bot], so nothing moves them.

Owner decision, 2026-11-16 (Q190 (a), "go w/ recommendations"): an agent re-audits each drifted page and opens a PR that moves its pin. Each upstream change is marked take, adapt or reject, and only a take or adapt that changes one of this repository's skill designs goes to the owner.

Fix

  1. Update docs/contracts/upstream-drift/README.md (the paragraph at lines 528-531, and the needs-human bullet at 515) to state the new rule. An agent re-audits the drifted rows, marks each upstream change take, adapt or reject, moves the pin, and records the outcome as "When a trigger fires" requires. A take or adapt that changes a skill's design is raised to the owner. Every other outcome merges through the normal lanes.
  2. For each of the six upstreams, re-audit its docs/upstream/<page>.md rows against the new upstream head named in the issue body, using the page's own re-audit steps. Move the pin, record each change's disposition, and close the drift issue with the PR (Closes #<n>). One PR per upstream keeps each one small.

Done when

  • The drift contract states the agent re-audit rule and the owner-only case, and no longer says each adoption stays a person's decision.
  • Each of Upstream drift: addyosmani/agent-skills #16403-Upstream drift: upstash/context7 #16408 is closed by a merged PR that moves its pin and records a take, adapt or reject for every changed row.
  • Any take or adapt that changes a skill's design is listed in its PR body and raised to the owner rather than applied.

Related

Activity

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

    @github-actions
    Contributor

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

    Understood: update the upstream-drift contract so an agent re-audits drifted pages (take, adapt or reject per change, pin moved), with only skill-design changes going to the owner. Then re-audit the six drift issues #16403-#16408, one PR per upstream. The work is docs-only and the approach is clear from the issue. It is too large for one change, and it has already been split into #16487 and #16488. No duplicate or merged fix found.

    Automated triage. A maintainer reviews it.

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

    @melodic-automation-lanes
    Contributor

    Not admitted to the issue lane yet: sub-issue #16488 is open.

  5. melodic-automation-lanes commented on Nov 16, 2026

    @melodic-automation-lanes
    Contributor

    Split at intake (owner Q93). This issue is Size Large, so its done-when is split into 2 sub-issues, each holding its task-list lines as written.

    Automated split by the lanes App. Admission waits on this issue while a sub-issue is open; work-unblock closes it as completed once every sub-issue is closed as completed by a merge or a listed human and its done-when is covered.

  6. kyle-sexton commented on Nov 16, 2026

    @kyle-sexton
    MemberAuthor

    Record for the done-when items.

    • The contract states the rule. docs/contracts/upstream-drift/README.md on main reads "The issue is the to-do, and an agent works it" (line 534) and names the one owner-only case, a take or adapt that would change a skill's design. The phrase about each adoption staying a person's decision is gone (searched on main).
    • Each of the six drift issues is closed by a merged pull request that moves its pin and records a disposition per changed row:
    Drift issue Upstream Pull request Dispositions
    #16403 addyosmani/agent-skills #16526 take 3, adapt 2, reject 9, already have 39
    #16404 cursor/plugins #16525 reject 2, already have 4, 15 rows hold
    #16405 t3dotgg/tstack #16502 recorded in the pull request
    #16406 playwright/playwright #16527 take 1 (one vendored line)
    #16407 firecrawl/update #16529 already have 6, reject 1 new
    #16408 upstash/context7 #16530 take 1 (an example library id)

    The pull requests link the parent with Refs: and carry no closing keyword toward the drift issues, which are bot-written, so each issue was closed by hand with its pull request's link.

    Still owed outside this issue, listed in the pull requests' Remaining sections: the playwright probe records under playwright-cli 0.1.24 (#16527) and the context7 records under ctx7 0.11.1 (#16530). Both need a newer tool than the host that ran the re-audit has.

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

    ready

    Priority

    low

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions