Skip to content

docs: cut restated upstream behavior left by the stamp sweep (playbooks) #15509

Open

Description

@kyle-sexton

Problem

The stamp sweep in #15461 (docs: drop stamps from pointer records (playbooks)) found these passages restating upstream behavior. Under contract 6.0.0 (#15468) restated behavior is not stamped; it is cut to a pointer or rewritten as this repository's own rule. The sweep left them unchanged because cutting them changes what a skill tells the agent.

Items

The prose below is kept and its stamp removed. A later change should cut it.

  • skills/boris/reference/orchestration.md ~L53, ~L60, ~L68, ~L75: paraphrase the blog's failure modes, the dynamic-versus-static argument, the six patterns and the use cases.
  • skills/boris/reference/autonomy.md ~L354: paraphrases how /goal checks its condition.
  • skills/boris/reference/loops.md:17, :30: paraphrase the goal docs (no turn cap; a bare /goal shows spend).
  • skills/boris/reference/foundations.md ~L193: paraphrases when PostToolBatch fires.
  • skills/boris/reference/customization.md ~L18: paraphrases which terminals take Shift+Enter.
  • skills/boris/reference/adoption.md:10: paraphrases the thread's guardrails.
  • skills/boris/SKILL.md:82: restates the Ultracode toggle on /effort.
  • skills/skill-authoring/reference/precompute-context.md ~L60-61: paraphrases the permission-checks section (a refused command aborts the skill load).
  • skills/skill-authoring/reference/skill-criteria.md:13-15: paraphrases the prompt audit's cruft criterion.
  • reference/model-adaptation/opus-4-8.md:148, sonnet-5.md:158: paraphrase the Fable guidance on over-prescription.
  • reference/model-adaptation/sonnet-5.md:51-52: paraphrases the effort page saying the scale is set per model.
  • skills/fable-5/context/verification.md (the Managed Agents automation record): restates the blog's re-check and delivery checks. It keeps its stamp for the command string.
  • skills/fable-5/context/context-economy.md:22: restates the keep:"all" behavior.
  • skills/repo-sweep/scripts/state.sh:39, tick.sh:22: describe jq.exe text-mode stdout on Windows.

Kept, unsure

  • skills/skill-authoring/SKILL.md:34: the post's 9 category names and tip titles are strings copied from the post. Whether a whole-skill restatement counts as a stored value is unsettled.
  • Sources read dates that have no figure beside them. They are a read log rather than a stamp form:
    • opus-4-8.md ~L150-152
    • haiku-5-5.md:244, :246
    • sonnet-5-5.md ~L286, ~L289
    • sonnet-5.md:183-186
    • opus-5.md:185

Kept, no anchor checked

  • skill-criteria.md:387
  • prompt-caching.md:43
  • haiku-5-5.md:208
  • sonnet-5-5.md:264

Out of scope

lib/prerequisites.{sh,mjs} and scripts/fetch-docs.sh are shared copies of the root lib/ canonicals.

docs/contracts/upstream-drift/README.md:152-156 still asks a "no docs page covers" record to keep its date. That text predates D26, which overrides it, so the contract needs its own follow-up.

Do

Per item: cut to the anchored pointer, keep as our own rule with its reason, or record why it stays. A cut that changes agent behavior needs an eval or a stated basis.

Related

Refs: #15461, #15468

Activity

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

    @github-actions
    Contributor

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

    Understood: a docs cleanup for the playbooks plugin. It lists passages left by the stamp sweep (#15461) that restate upstream behavior. Under contract 6.0.0 (#15468), each should be cut to a pointer, rewritten as this repository's own rule, or recorded as intentionally kept. The issue names the files and items and says what to do with each, so nothing is missing. Where a cut changes what a skill tells the agent, it needs an eval or a stated basis. The sibling "stamp sweep" batch issues cover other areas, so I don't treat them as duplicates. I found no merged pull request that already fixes this.

    Automated triage. A maintainer reviews it.

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

    @melodic-automation-lanes
    Contributor

    Not admitted to the issue lane: no trusted-human acceptance criteria: a listed human must put the confirmed - [ ] criteria in the body or post them as their own comment, or, on an issue a listed human filed, intake's newest refinement comment must hold them unedited. Admission takes the issue once each of those is met, when intake triages it again (.github/actions/resolve-config/admission-rules.json).

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

    @melodic-automation-lanes
    Contributor

    Refinement. A read-only run explored this repository, searched its issues and pull requests, and read the allowed docs to draft what follows. On an issue a listed human filed, it counts as the issue's spec once posted, while unedited; it is still model text, so check it.

    Intended outcome: Each listed passage in the playbooks plugin is cut to its anchored upstream pointer, rewritten as this repository's own rule with a reason, or recorded as intentionally kept.

    Related work

    Open questions

    1. For each listed passage, should the run cut it to a pointer, rewrite it as the repo's own rule, or keep it? The issue leaves this per-item choice open.
      RECOMMENDED: Cut to the existing Pointer line where one already sits under the prose (orchestration.md sections 81-84 each have one). Keep as own rule only where the text carries a repo-specific instruction. Basis: plugins/playbooks/skills/boris/reference/orchestration.md:56-78
    2. What counts as the stated basis or eval that allows a cut which changes what a skill tells the agent, and who accepts it?
      RECOMMENDED: Accept a one-line basis in the PR description naming the upstream page that still covers the behavior; require no new eval for pure pointer cuts. Basis: judgment
    3. Should the 'Kept, unsure' and 'Kept, no anchor checked' items be in scope for edits, or only recorded as kept?
      RECOMMENDED: Out of scope for edits; record each as kept with a reason, and file separate follow-ups for the unsettled stored-value question at skill-authoring/SKILL.md:34. Basis: judgment
    4. Line numbers in the issue are approximate and have drifted (for example the PostToolBatch prose is now near foundations.md:190). Should the run locate each passage by content rather than line?
      RECOMMENDED: Yes, locate by content and the issue's description of the paraphrased behavior. Basis: plugins/playbooks/skills/boris/reference/foundations.md:190-209

    Sources read

    • plugins/playbooks/skills/boris/reference/orchestration.md:50-82: sections 81-84 hold paraphrase followed by Pointer lines to the blog post
    • plugins/playbooks/skills/boris/reference/foundations.md:190-209: PostToolBatch prose with a hooks pointer nearby

    To answer, post a comment that starts with this line:

    **Decision recorded.** <answer>
    

    Automated refinement by the lanes App. Answer with a comment whose first line is **Decision recorded.**.

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

    needs-owner-decision

    Priority

    low

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions