Skip to content

docs: fix the false pinned-agents effort claim in plugin-philosophy #7099

Open

Description

@kyle-sexton

Problem

Two stale records turned up during the Claude Haiku 5.5 release sweep and are outside that sweep's scope:

  1. docs/plugin-philosophy.md, the pinned-agents record (as-of 2026-10-02, trigger "next model release"), says every named agent in this repository pins its effort. That is false. git grep -L '^effort:' -- 'plugins/*/agents/*.md' lists 11 agents with no effort pin: discovery docs-fetcher and sweep-worker; docs-hygiene compare-labeler; multi-agent docs-fetcher, drift-checker and drift-reader; review lane-verifier and stage-normalizer; testing green-fixer, green-runner and green-verifier. The trigger has fired, but the record cannot be re-dated while its claim is false.
  2. (Withdrawn: #latest-models-comparison is the live id on the rendered models-overview page. compare-models is only the raw markdown heading slug. The two links that wrongly moved to #compare-models are restored in the playbooks Haiku 5.5 chapter PR.)

Proposed fix

  • Scope the pinned-agents claim to the agents it is true for (for example, the agents skills dispatch through the Agent tool), or pin effort on the 11 agents. Then re-date the record.

Acceptance

  • The pinned-agents record's claim matches git grep -L '^effort:' output, and the record's as-of date is current.

Activity

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

    @github-actions
    Contributor

    Thanks for the report. Automated triage handed this issue to a maintainer.

    Automated triage. A maintainer reviews it.

  3. added
    needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.
    on Oct 11, 2026
  4. changed the title [-]docs: fix the false pinned-agents effort claim and a dead models-overview anchor[/-] [+]docs: fix the false pinned-agents effort claim in plugin-philosophy[/+] on Oct 11, 2026
  5. kyle-sexton commented on Oct 11, 2026

    @kyle-sexton
    ContributorAuthor

    Owner decision (2026-10-11): Narrow the pinned-agents effort claim in plugin-philosophy (docs only); pinning effort on the unpinned agents (12 on main) is not part of this.

    Recorded by the coordinating agent session with the owner's approval. Removing needs-human; implementation is queued and will link its branch here.

  6. removed
    needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.
    on Oct 11, 2026
  7. added theissue type on Oct 15, 2026
  8. added
    needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.
    and removed
    needs-triageNot yet classified. Floor until a type and one priority tier are set.
    on Oct 15, 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

    needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.

    Type

    Fields

    No fields configured for Bug.

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions