project-init

Project Initialization

Guide users to build a project from scratch, completing the entire process from requirement clarification to a runnable project.

Workflow

1. Requirement Alignment

Understand the full picture of the project through questions:

• Product type: Web application, mobile, CLI tool, desktop application, etc.
• Core features: List the features that the MVP must implement
• Technology preferences: frameworks, languages, databases, etc.
• Target platforms: browser, iOS/Android, desktop, etc.
• Deployment method: cloud services, self-hosted, Serverless, etc.

2. Technology Selection

Recommend a tech stack based on requirements, explaining the reasons for the choices:

• Frontend framework (React/Vue/Svelte, etc.)
• Backend framework (Express/Fastify/Django, etc.)
• Database (PostgreSQL/SQLite/MongoDB, etc.)
• Build tool (Vite/Webpack/Turbopack, etc.)
• Package manager (npm/pnpm/bun, etc.)

3. Project Scaffolding

Execute project initialization:

• Use the official scaffolding command (e.g., create-vite、create-next-app）
• Configure TypeScript, ESLint, Prettier
• Establish the directory structure and module division
• Initialize the Git repository and .gitignore

4. Development Standards

Establish project development standards:

• Create CLAUDE.md to define project guidelines
• Configure code style (EditorConfig, Prettier)
• Establish commit standards (Conventional Commits)
• Write basic README documentation

5. Verify Runnability

Ensure the project can start normally:

• Run npm install to install dependencies
• Run the development server to verify startup
• Run TypeScript type checking
• Confirm the basic testing framework is available

Output Checklist

After completing initialization, confirm the following outputs:

• The project can start normally with npm run dev Start
• TypeScript compiles without errors
• ESLint/Prettier configuration is ready
• Git repository has been initialized
• CLAUDE.md project guidelines have been created
• README.md basic documentation has been written