Skip to content

[dev]: Adopt and enforce Zsh Plugin Standard 2 #557

Closed

Description

@ss-o

Outcome

Adopt the revised portable Zsh Plugin Standard across organization policy,
plugin scaffolding, review guidance, testing requirements, and CI without
duplicating the canonical technical rules from the wiki.

Scope

  • Draft a PROPOSED ADR for clean-break organization adoption.
  • Update routed Zsh plugin and scripting guidance.
  • Extend the machine-readable policy and its deterministic validator.
  • Align the plugin reviewer, new-plugin skill, entrypoint template, README
    template, PATTERNS.md, and new-repository runbook.
  • Update testing policy so maintained plugins prove lifecycle behavior.
  • Require exact released zsh-lint and ZUnit pins after those tools publish
    the necessary contracts.
  • Complete the instruction-update impact review and private route checks.

Non-goals

  • Do not create a second organization-owned technical plugin standard.
  • Do not retain legacy compatibility guidance for refactored plugins.
  • Do not claim runtime lifecycle proof from static analysis.

Acceptance criteria

  • The ADR is proposed and receives a separate maintainer acceptance decision.
  • All organization surfaces link to one canonical public contract.
  • A newly scaffolded plugin passes static and runtime checks unchanged.
  • Templates create no scattered public configuration parameters or shared
    Plugins registration.
  • Public and private instruction validators pass.
  • CI guidance uses exact released tool pins.

Activity

  1. added
    type:maintenanceNon-feature maintenance, cleanup, or org work.
    area:pluginPlugin behavior or plugin-facing work.
    breaking-changeBreaks backward compatibility or changes a public contract.
    meta:org-trackedIndicates this issue has cross-repository tracking implications (synced to Linear).
    on Aug 28, 2026
  2. moved this from Triage to Blocked in Z-shell Deliveryon Aug 28, 2026
  3. added
    status:blockedCannot proceed until an external dependency or decision changes.
    on Aug 28, 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

    area:pluginPlugin behavior or plugin-facing work.breaking-changeBreaks backward compatibility or changes a public contract.meta:org-trackedIndicates this issue has cross-repository tracking implications (synced to Linear).status:blockedCannot proceed until an external dependency or decision changes.type:maintenanceNon-feature maintenance, cleanup, or org work.

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions