Repository navigation
Open
Feature
76 / 8676 of 86 issues completed
Copy link
Labels
needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.Human-in-the-loop required; autonomous sessions must not resolve items carrying this.spec-containerSpec container: sub-issues are its work items (/work-items:decompose and /work-items:ship).Spec container: sub-issues are its work items (/work-items:decompose and /work-items:ship).
Description
TLDR
- Generic skills stop shipping model-read language, framework and tool choices; each skill reads the consumer's own records, then infers from the repository.
- Executed adapters, single-tool plugins and security floors stay; an adapter names what it cannot read instead of skipping it.
- Shipped defaults that pick a tool, command or library are retired; unattended lanes run only what the repository states or its build files imply.
- The enforcement ladder becomes the one representation of the talk's pyramid: capability-named rungs, a verification tier in third place, a proportion rule in words, and her order of work.
- The automation-gaps audit reports how a repository's enforcement is spread across the tiers; a review rule holds new enforcement-placing skills to the ladder.
Problem
- Gap: plugins ship per-language guidance and bundled defaults that give wrong or silent results in repositories nobody anticipated, and the ladder has no place for verification.
- Who / how many: every consumer repository; 1,106 ecosystem-specific items across 93 plugins, 584 read only by a model (
recommendations/design-ecosystem-specifics.mdsection 1, in the talk's slice). - Frequency: every run in an unlisted language; every pytest finding codify routes (
plugins/corrections/skills/codify/reference/finding-classes.md:93). - Trend: unknown.
- Cost: wrong tool runs (the bundled Python default runs pyright whatever the repository uses,
plugins/toolchain/reference/ecosystems/python.yaml:14); silent skips; upkeep is low and is not the reason. - Evidence: observed in the repository's files (rated: read directly), plus the workflow inventory (rated: relayed, spot-checked).
Intent
"I would be wary of shipping our skills with specific language implementations because that can all be looked up in the downstream repo ... it really should discover what the language is, what the framework is, what the ecosystem is, what the environment of the downstream system is ... Otherwise, we have to maintain and ship languages and frameworks, and then maintain that as they change."
- note: "I want to make sure that the plugin skills that we ship, whether they're new or existing, align with this pyramid ... which ones are preferred, from strongest to weakest, and which one you should have the most of versus the least of."
- note: "other skills can call other skills through the skill references, not the internals, because that breaks encapsulation."
- note: "As long as we're aligned with her talk, the facts/data/metrics and the latest /discovery:research from official, authoritative, and trusted sources."
- note: "It needs to cover her entire talk, deep dive, everything discussed -> integrated into new/existing plugins/skills ... And dogfooded into this plugins repo itself."
- note: "If there are any of these skills that would operate better, they look at the repo and generate another skill, a CLI, a tool, or a check ... It still remains user repo organization- and machine-agnostic, and it knows where things live ... so it reuses and maintains stuff that it generates and builds."
Goal
A consumer repository in any language gets correct, visible behavior from the generic skills without the marketplace shipping or maintaining that language's tool choices, and every skill that places enforcement follows one ladder that matches the talk's pyramid.
- Intent (why, in the user's words): "Otherwise, we have to maintain and ship languages and frameworks, and then maintain that as they change."
- Vision (where this heads): the whole talk integrated into plugins and skills and dogfooded here, tracked on the wayfind map for the talk.
- When goals conflict, prefer: "single responsibility ... low coupling and high cohesion ... things that change together live together ... semantically accurate names" (the owner's quality bar).
- Finish line: merged — checked by the owner via the widened portability gate passing on
mainand the ladder contract showing the verification tier. (Confirmed by the owner, 2026-11-12: "lets go w/ recommended".)
Work size
- Appetite: not stated; the owner said plan usage is not a constraint.
- Size: large; ten migration slices plus the ladder changes, one plugin per pull request for the guidance cuts.
- Uncertainty: medium; twelve questions are deferred to design and planning.
- Split signals: the slices are independent after the owner documents land; the first slice removes nothing.
Constraints
- No shipped language specifics, applied to existing content, for model-read guidance only; executed code stays.
- Security and safety floors stay; removing or narrowing one is the owner's decision each time.
/corrections:codifyonly picks the rung and proves the check;/implementation:implementbuilds the rule in the consumer's own tooling.- A skill reaches another only by
/plugin:skill, presence-gated with a stated fallback (docs/plugin-philosophy.md:101-116). - A cut to a skill ships only with eval evidence of no loss (
docs/review/skills-and-agents.md:7-9); a whole-page deletion uses a sensitivity control, every other cut keeps the detection control. - Unattended lanes: no install, no text copied from CI files, each command logged as assumed with its source; an unsure run counts as unattended.
- A lane's record pull request holds only commands that pass those limits; "a merged pull request counts as acceptance" is added for ecosystem records only.
- No new organization layer; organization conventions arrive through the repository's own synced standards.
- Mechanism-level decisions are settled at design and planning.
- Quality requirement: repeatability: the same repository run twice gets the same tool choice; target: a recorded choice is read before any inference.
Acceptance criteria
- 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.
- AC2: The enforcement ladder has no tool-named rung id, has a verification tier in third position, states the proportion in words with no numeric target, states her order of work (lint first, clean up, strengthen verification, then automate), and its five copies are in sync.
- AC3: Codify no longer routes a pytest
testing/audit/finding to a C#-specific tutorial, and its proposal names the fix-message requirement and hands the build to/implementation:implement. - AC4: Toolchain runs no bundled default command; a repository with no record and nothing inferable shows a visible unresolved skip; a source file outside every ecosystem is named, not skipped silently.
- AC5: An unattended run executes only stated or inferred commands, logs each as assumed with its source, installs nothing, writes no record, and reports a tie as unresolved.
- AC6: A lane's record pull request containing a command outside the unattended limits is refused by a deterministic check.
- AC7: Each whole-page deletion carries a sensitivity-control result; each partial cut carries a detection-control result.
- AC8: Each executed adapter names a file or value it cannot read, and an unlisted mutation tool value is accepted and reported as having no shipped adapter.
- AC9: The automation-gaps audit reports, read-only, a count per ladder tier and the rules that sit lower than they could.
- AC10: A review rule holds every new skill that recommends, places or builds enforcement or an instruction to: read the ladder, prefer the strongest tier that can decide the matter, and discover the consumer's tooling first.
- AC11: This repository's own ecosystem records exist, and its
/toolchain:checkcommand list on a fixed diff is identical before and after the change.
Captured assumptions
- Quality bar: production
- Variation intent: second variant = known (other languages and tools); existing structure: the ecosystem-commands contract, the four-step resolution order, executed adapters in six plugins; upstream: none adopted.
- The sensitivity control has no outside source; it rests on the repository's rule and judgment: revisit if a whole-page cut's control result is disputed.
- The design document's judge scores were read from the workflow result, not from the document: revisit if the design is re-run.
- Her team's numbers are unverifiable and are not targets: revisit if she publishes data.
- Decision records were not written during the interview; six decisions are candidates, not checked: revisit at design.
Out-of-scope
- The no-comments posture; the formal-verification proof of concept; the corrections counter; the live-app exploring skill and its fixture; the dotfiles rule changes (worktree rule, issue-filing wording, lessons check-first): each its own work item, tracked from the talk's wayfind map.
- The sixteen undecided menu items: decision items on that map.
- Moving the ecosystem record's home.
Deferred questions
- Q21: How does a skill that carries no ladder copy read the ladder?, defer until design; arbiter: USER-RESERVED
- Q22: Are the rule-to-enforcer inventory and the per-tier count one artifact?, defer until design; arbiter: USER-RESERVED
- Q23: Does the resolution procedure need its own contract, or does the existing ecosystem-commands contract hold it?, defer until design; arbiter: USER-RESERVED
- Q24: Does the verification tier ship in the same ladder major version as the rung rename?, defer until planning; arbiter: /planning:plan
- Q25: What stack is the live-app fixture and where does it live?, defer until the live-app skill's own work item; arbiter: USER-RESERVED
- Q26: Which models and how many runs per side does each compare use?, defer until planning; arbiter: /planning:plan
- Q27: What agreement level between two blind classifiers counts as a rule being split on?, defer until planning; arbiter: /planning:plan
- Q28: The old rung id's alias lifetime, and the order of the remaining cuts, defer until planning; arbiter: /planning:plan
- Q29: Final public names for the session's working names, defer until design; arbiter: USER-RESERVED
- Q40: Which skill writes the record a lane proposes?, defer until design; arbiter: USER-RESERVED
- Q41: Are toolchain's bundled files deleted, or kept as examples of the record's shape that never run?, defer until design; arbiter: USER-RESERVED
- Q42: Which plugins hold the synced resolution text?, defer until planning; arbiter: /planning:plan
Load-bearing assumptions
| Assumption | Source | Falsifying check | Response if false |
|---|---|---|---|
| The sensitivity control gives a usable answer for a whole-page cut | Brief | Phase 5 Sanity Check: the recorded control outcome is one of the two predicted outcomes | Major: stop Phase 14's whole-page cuts and bring the proof rule back to the owner |
| The design's judge scores are not re-read | Brief | none in this plan; no phase depends on a score | Minor: proceed and note |
| Her team's numbers are not targets | Brief | Phase 6 Sanity Check: the proportion rule's text holds no digit | Minor: proceed and note |
| Six candidate decisions were not recorded during the interview | Brief | Phase 3 Sanity Check: the one ADR file exists; Phase 6 Sanity Check: the 3.0.0 changelog entry states the tier's reason | Moderate: flag and continue |
| No shipped script reads the rung ids or the nine bundled toolchain files | plan (design B12, re-run of the search this session: only skill text, eval files and one test fixture name them) | Phase 6 and Phase 10 pre-flight consumer checks | Major: stop and replan the affected phase |
The lanes run on the opus and sonnet aliases only |
plan (docs/conventions/pr-pipeline.yaml:943, docs/conventions/pr-pipeline.yaml:960) |
each model-run phase's first work item re-reads models.profiles |
Moderate: flag and continue; add the new alias to that phase's compare |
docs/standards/README.md is at standards-contract 1.0.2 while the planning plugin's binding is 1.1.3 |
plan | none | Minor: best-effort grounding; re-run the standards setup |
Execution shape: per-item PRs
Metadata
Metadata
Assignees
Labels
needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.Human-in-the-loop required; autonomous sessions must not resolve items carrying this.spec-containerSpec container: sub-issues are its work items (/work-items:decompose and /work-items:ship).Spec container: sub-issues are its work items (/work-items:decompose and /work-items:ship).
Type
Fields
No fields configured for Feature.
Activity
76 remaining items