Skip to content

make skeleton the only init template#240

Merged
nahiyankhan merged 1 commit into
mainfrom
nahiyankhan/skeleton-only-init
Jul 18, 2026
Merged

make skeleton the only init template#240
nahiyankhan merged 1 commit into
mainfrom
nahiyankhan/skeleton-only-init

Conversation

@nahiyankhan

Copy link
Copy Markdown
Collaborator

Category: improvement
User Impact: New packages start from one consistent skeleton instead of choosing among overlapping starter templates.
Problem: ghost init exposed multiple starter templates and legacy aliases that duplicated concepts and made the recommended starting point unclear.
Solution: Keep skeleton as the only init template, remove minimal, composition, default, and steering, and update tests and guidance to match. Full bodies such as vessel-light remain available through --body.

Validation:

  • pnpm check: passed
  • pnpm test: 181 passed, 1 skipped
  • pnpm build: passed
  • pnpm dump:cli-help: generated output has no semantic change; manifest remains in sync

Changeset: added as a major change because named templates and aliases are removed.

ghost Review:

  • ghost check --base origin/main: not available in this CLI version; deterministic repository checks passed via pnpm check
  • ghost review --base origin/main --include-memory: not run because this repository has no .ghost/checks/ package and this CLI version does not support --include-memory
File changes

.changeset/skeleton-only-init-template.md
Records the removal of public init template names as a major release change.

CLAUDE.md
Removes guidance for the retired minimal template.

apps/docs/src/content/docs/cli-reference.mdx
Presents skeleton as the sole init template and updates the command example.

apps/docs/src/content/docs/getting-started.mdx
Directs users to adapt the skeleton starter without offering the retired minimal alternative.

packages/ghost/src/scan/templates.ts
Removes the minimal and composition template payloads and the default and steering aliases.

packages/ghost/src/skill-bundle/SKILL.md
Updates the installed skill's command reference to describe only the skeleton starter.

packages/ghost/src/skill-bundle/references/capture.md
Removes the minimal-template authoring path.

packages/ghost/test/cli.test.ts
Removes retired-template coverage, verifies skeleton-only errors, and uses a focused package fixture where tests previously depended on minimal.

Screenshots/Demos: N/A

@nahiyankhan
nahiyankhan marked this pull request as ready for review July 18, 2026 23:02
@nahiyankhan
nahiyankhan merged commit feddc63 into main Jul 18, 2026
5 checks passed
@nahiyankhan
nahiyankhan deleted the nahiyankhan/skeleton-only-init branch July 18, 2026 23:02
@github-actions github-actions Bot mentioned this pull request Jul 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant