scaffold-project

name	scaffold-project
description	Scaffold a new app, API, backend, fullstack project, mobile app, polyglot service, monorepo, or starter with Better Fullstack. Use when the user wants to create, start, bootstrap, initialize, or generate a project from a stack description. Prefer the bundled Better Fullstack MCP server: guidance, schema, compatibility, plan, then create.
metadata	{"priority":9,"docs":["https://better-fullstack.dev"]}

Scaffold a Better Fullstack Project

Use the Better Fullstack MCP server as the source of truth. Do not hand-write package files, framework folders, auth wiring, database wiring, or generated project structure.

Workflow

1. Resolve intent. If major choices are unclear, ask briefly or pick conservative defaults and state them.
2. Call bfs_get_guidance.
3. Call bfs_get_schema for the current allowed values. Do not rely on a stale option list.
4. Build a full explicit config. Use "none", empty arrays, and booleans rather than omitting important fields.
5. Call bfs_check_compatibility.
6. Call bfs_plan_project. Review the dry-run output and compatibility adjustments.
7. Call bfs_create_project only after the plan matches the user request.
8. Report the selected stack, project directory, and exact install/test/dev commands.

Rules

• Set install: false for agent scaffolding unless the user explicitly asks to install dependencies.
• Use packageManager: "bun" when the user or current repo expects Bun.
• Use aiDocs: ["agents-md"] for reusable projects and aiDocs: ["none"] for benchmarks or throwaway scaffolds.
• Prefer stack graph parts for explicit multi-ecosystem stacks, but use MCP schema fields when they communicate the request more clearly.
• Treat compatibility adjustments as user-visible decisions.
• Do not start a dev server.

Common Stack Hints

• React + Vite: frontend: ["react-vite"]
• Next.js fullstack: frontend: ["next"], backend: "self"
• Hono API: backend: "hono", runtime: "bun" or "node"
• SQLite + Drizzle: database: "sqlite", orm: "drizzle"
• Python API: ecosystem: "python", then choose pythonWebFramework and related Python fields
• Rust API: ecosystem: "rust", then choose rustWebFramework and related Rust fields

Final Response

Say what command/tool path was used, what compatibility adjustments were made, where the project was created, and what the next commands are. Never claim dependencies were installed when install: false was used.