upstream-sync
Upstream-synced plugins
Some plugins are ported from external repositories and should be kept in sync with their upstream source. When asked to update one of these plugins, fetch the latest content from the upstream URL using gh api and apply any changes, then follow the standard marketplace update workflow in AGENTS.md.
Local sync targets are neutral kernels: plugin.toml, roles/, workflows/ with
TOML sidecars, skills/, contracts/ and policies/. Host-specific mechanisms
belong in adapters/; exports/ and root catalogs are generated. Upstream
agents/ and commands/ paths describe that upstream's layout, not local source.
Nothing listed under "Deliberately not vendored" in AGENTS.md belongs in the table below. Those areas were removed and delegated on purpose; do not add rows for them on a future pass. The former obra/superpowers export row was retired with the VS Code extension and stays retired.
Default upstream-update strategy
When the user asks for "upstream updates" (or similar), this is the default workflow. Do not blindly overwrite local files - most syncs need targeted merging because local has legitimate customizations.
- Check all synced plugins in parallel. For each file in the sync table below, diff the upstream against the local version. Spawn Explore agents when there are many files to parallelize the diffing. Focus the reports on: which files differ, what changed, and whether the drift is intentional or worth pulling.