Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions bestax-migrate/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,8 +75,9 @@ the component library), and `scripts/pack-manifest.mjs` resolves any remaining
left in `devDependencies` only with the pack hooks present. It does **not**
check which section `@allxsmith/bestax-bulma` sits in — re-adding it as a
plain-semver runtime dependency passes CI, so that one is on review. The skill lives at repo-root
`skills/bestax-migrate/`. Whether it bundles into create-bestax is contested: the original
policy was existing-sites-only, but `sync-skills.mjs` has shipped it since #345 — see #385
and don't change either side ahead of that call. When the mapping
gains or loses coverage, update `skills/bestax-migrate/references/` and the docs migration
guide in the same PR.
`skills/bestax-migrate/`. It **is** bundled into create-bestax (settled in #385): the
original existing-sites-only policy lost to one uniform bundle, and the skill sits idle
in a fresh scaffold until legacy imports show up. The canonical roster of surfaces that
must agree on bundling lives in `create-bestax/CLAUDE.md`'s sync rules — don't restate
it here. When the mapping gains or loses coverage, update
`skills/bestax-migrate/references/` and the docs migration guide in the same PR.
7 changes: 4 additions & 3 deletions create-bestax/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,10 @@ path (`-y` + flags, no TTY) must never hang or regress (#192).
package. An unlisted skill silently doesn't bundle; a delisted one silently vanishes (the
script empties the destination first, and its success line reports the array length either
way); no CI check compares the list against `skills/*`. Bundling is a per-skill policy
decision (see #385) — when adding a skill, decide it explicitly and keep the allowlist,
`skills/README.md`, `docs/docs/skills/intro.md`, and the `CLAUDE_MD` roster in
`src/constants.ts` in agreement. **Never edit the bundled copy** — change `skills/` at the
decision (bestax-migrate's was settled as bundled, #385) — when adding a skill, decide it
explicitly and keep the allowlist, `skills/README.md`, `docs/docs/skills/intro.md`, any
per-skill docs page that states bundling (`docs/docs/skills/migrate.mdx` does), and the
`CLAUDE_MD` roster in `src/constants.ts` in agreement. **Never edit the bundled copy** — change `skills/` at the
repo root; the build re-syncs.
- The `CLAUDE_MD` template in `constants.ts` is what every generated app tells its AI agents.
When library conventions, skills, or the canonical docs entrypoint change (#203), check
Expand Down
3 changes: 1 addition & 2 deletions docs/docs/skills/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,6 @@ Then explore each skill — what it does, how to install it, and live examples:
- **[Icons](./icons)** — use `Icon`/`IconText` with any of the five supported icon libraries:
per-library setup, name formats, variants, and decorative-vs-labeled accessibility.
- **[Migrate](./migrate)** — move an existing app off `react-bulma-components`: run the
`bestax-migrate` codemod, then resolve every `TODO(bestax-migrate)` it leaves. Not bundled by
`create-bestax` (it's for existing sites, not new ones).
`bestax-migrate` codemod, then resolve every `TODO(bestax-migrate)` it leaves.
- **[Optimize](./optimize)** — reduce the built CSS size: measure raw+gzip, then the cheapest
first-party lever that fits (lighter flavor, modular Sass build, import/asset hygiene).
4 changes: 2 additions & 2 deletions docs/docs/skills/migrate.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ skill teaches an agent to move an existing app from
[`bestax-migrate` codemod](../guides/getting-started/migration/react-bulma-components.md) and then
resolves everything the codemod flags.

Unlike the other skills, this one is **not** bundled by `create-bestax` — it's for existing sites,
not new ones.
Like the rest of the bundle, `create-bestax` offers to preinstall this skill; it stays idle
until the agent meets code that still imports `react-bulma-components`.

## Install

Expand Down
Loading