find-peers

Installation
SKILL.md

Find peers

A peer is a public repo that uses our dependency families or a relevant integration. Default discovery requires two shared families. A relevant XState runtime or integration can qualify without Alchemy. Peers can reveal breaking changes and useful patterns before documentation covers them.

Effect describes work with typed failures and required dependencies. Alchemy declares and deploys cloud resources through Effect programs. Effect 4 still counts as a shared dependency family after its stable release. Record version differences between beta, release candidate, and stable releases.

Run

pnpm find-peers

The script reads exact prerelease versions and the stable Effect 4 major version from workspace package.json files. It searches Sourcegraph once per dependency family. It ranks repos by the number of shared families. Scoped packages that move with their parent, such as @effect/vitest with effect, count once.

A repo missing from .brain/data/peers.json is marked new. The search takes about twenty seconds. Pass --min 1 to see repos that share only one family.

Refresh peers, versions, and tiers

Refresh the structured rows in .brain/data/peers.json after any stack bump. On every gardener pass, refresh peers whose checked date is more than 14 days old. Report stale dates; they never block other gardener work. The gardener pass owns this step. Run discovery, add new peers, and revisit existing peers even when discovery finds nothing new.

Installs
39
GitHub Stars
214
First Seen
Sep 27, 2026