bootstrap

bootstrap — runtime scaffold

bootstrap stands up a project's runtime by running the stack's official scaffolder with the right flags — it does not hand-roll a directory tree. The runtime/package-manager defaults are fixed; only the framework on top is a choice.

• TypeScript / JavaScript → Bun (runtime + package manager + test runner).
• Python → uv (runtime/version + dependency + project manager).

Concrete per-framework commands and quality-gate defaults live in references/profiles.md.

Do this

1. Decide the shape — frontend, backend, or both. If a problem statement from ideate exists, infer from it; otherwise ask.
2. Pick a framework for each side (the only real config choice):
   • TS frontend: Vite (SPA), Next.js (SSR/marketing), Astro (content).
   • TS backend: Hono (APIs), or bun init (lib/CLI).
   • Python backend: FastAPI (APIs), Django (full-stack), or uv init (lib/CLI).
3. Run the scaffolder non-interactively — flags are the config (see profiles). Always Bun for TS, uv for Python.
4. Add the quality gates for the profile (formatter/linter, test runner).
5. Verify the scaffold runs — build or boot it once (bun run build / uv run …) and confirm it works before moving on. If it fails, report the output plainly; don't paper over it.
6. Layer Spark on top:
   • Generate CLAUDE.md and AGENTS.md with agents-md.
   • Install the git hooks: spark install-git-hooks.
   • Connect services and secrets with connect.
   • Land at ideate.

Guardrails

• Runtime/PM is fixed. Default to Bun for TS and uv for Python — don't fall back to npm/pnpm/node or pip/poetry without an explicit reason.
• Prefer the official scaffolder over a bespoke tree; it stays current with the framework.
• Commit the lockfile (bun.lock, uv.lock) so the runtime is reproducible.
• One concern. bootstrap stands up the runtime; it does not start implementing features — that's codify, after planning.
• Don't add dependencies the chosen profile doesn't need.

Fits the lifecycle

bootstrap and connect are the two project-setup skills: runtime + connectivity. Run them first, then enter Ideate → Plan → Generate → Solve → Ship.