Skip to content
13 changes: 13 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,19 @@ shipped product (see `skills/CLAUDE.md`); the MCP server serves a generated inde
`bestax-mcp/CLAUDE.md`). This file is also read by **CodeRabbit** (PR reviews)
and the **`@claude`** GitHub Action (project instructions), so keep it accurate.

## Distribution and listings

`docs/docs/guides/distribution.md` lists the registries, plugin marketplaces, directories and
curated lists we know carry Bestax, and marks which ones only change when a maintainer updates
them by hand. Third-party entries copy facts from this repo, and no check here can see them.

- Read its "What goes stale" section before a change that adds, renames or removes a skill,
changes what `bestax-mcp` offers or how it starts, ships a new major, renames or moves a
package or a bestax.io page, or changes an install command. Say in the PR which listings
that section names need a manual update.
- Update the page in the same PR when a listing is added, accepted or removed, or when how one
updates changes.

## AI development loop

**The fix loop.** Issues labeled `claude-fix` (requires triage+ access, verified live) are
Expand Down
4 changes: 4 additions & 0 deletions bestax-mcp/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,6 +109,10 @@ Independent semantic-release keyed off the `bestax-mcp` commit scope
ways that publish fails quietly are documented in `VERSIONING.md` and
`scripts/lib/pnpm-publish.mjs`.

MCP directories and lists describe what the server offers and give `npx -y bestax-mcp@1` as
its command. A change to either, to how it starts, or a new major means updating the listings
that `docs/docs/guides/distribution.md` names under "What goes stale".

Its `prepack` runs the guard and then `scripts/sync-skills.mjs`, which fills
`data/skills/` at pack time. That directory is gitignored while the manifest
`data/skills.json` is committed, so packing locally does not dirty the tree —
Expand Down
Loading
Loading