Repository navigation
Open
Labels
agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.Fully specified and briefed; eligible for autonomous pickup from the frontier.
Description
Parent
Refs #15703
Source: PLAN Phase 15, topic ecosystem-specifics
Depends on
- Classify the remaining guidance rows blind and count the cuts per plugin #15730
- every per-plugin cut item that Classify the remaining guidance rows blind and count the cuts per plugin #15730 files (edges added when they are filed)
Outcome
A pull request that adds a model-read tool, library or command choice to a generic skill, agent or plugin-level reference or context file fails the portability gate, so the cut guidance cannot grow back. Surviving specifics carry an annotation naming the rule that keeps them.
Demo: stage a tool literal in an agent file and in a plugin-level reference file; the portability gate fails each, and passes once the line is annotated. On main, the gate's full audit passes.
What changes:
- Every declared-scope file lacking a
portability-scope:line gets one; every surviving specific kept under the design's rules R2, R6, R8, R9 or R10 in a skill body getsportability-ok: <rule id and reason>. - The portability gate's scope and its in-script path filter widen from skill files to agents and plugin-level context and reference files.
- The gate's token list: enable the staged literals one at a time, and add one literal per tool named in a cut row, each only when its own full audit is green; the comment names the ecosystem-resolution contract as the fix.
Method: tests first in the gate's own test suite: an agent file and a plugin-level reference file with a staged literal each fail; an annotated one passes.
Decisions
- The gate widens last: widening before the cuts land would fail unrelated pull requests on files not yet cut. Until then the guard is the review rule.
- D18: a check's output names the fix; here the gate's comment names the ecosystem-resolution contract.
- Brief finish line: merged, checked by the owner via the widened portability gate passing on
mainand the ladder contract showing the verification tier.
Key interfaces
- "The consumer's ecosystem (language, framework, tools): abstract now. Seam: the ecosystem-resolution contract and the consumer's own records."
Done when
- AC1: no generic skill ships a model-read tool, library or command choice outside the named exceptions, and the portability gate, widened to agents and plugin-level reference and context files, passes on
main. - The gate's test suite passes, including the agent-file and reference-file failure cases.
- The ladder contract shows
### Tier 3: Verification(the Brief's finish line). - The pull request body names this repository's dogfooding step.
- AC7: nothing is cut here, so no control result is owed.
- AC10: no new enforcement-placing skill is added here.
Out of scope
- Cutting guidance (the per-plugin items).
- Any new rule beyond the widened scope and the literals.
Metadata
Metadata
Assignees
Labels
agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.Fully specified and briefed; eligible for autonomous pickup from the frontier.
Type
Fields
Work status
ready
Priority
medium
Activity
github-actions commentedon Nov 13, 2026
Size: Medium
Complexity: Medium
Uncertainty: Knowable
Flags: none
Blocked by: #15730
I read this as a bounded change to the portability gate. It would add
portability-scope:andportability-ok:annotations, widen the gate from skill files to agents and plugin-level reference and context files, and enable the staged token literals one at a time. Each literal is enabled only once its own full audit is green. Tests come first: the agent-file and reference-file failure cases, plus an annotated file that passes.The issue is clear enough to work from. Its own "Depends on" section says the gate widens last, after #15730 and the per-plugin cut items it files. So it is listed as blocked by #15730 until those land. I found no duplicate among the open issues and no merged pull request that already covers it.
Automated triage. A maintainer reviews it.
melodic-automation-lanes commentedon Nov 14, 2026
Not admitted to the issue lane yet: blocker #15730 is not closed by a listed human or a merge.