initializing-projects

name	initializing-projects
description	Bootstraps a new project with scaffolding, tooling, and Claude Code agent system setup. Use when bootstrapping a new project from scratch. Use when user says "create project", "new project", "initialize project", "start new app".

Initializing Projects

Overview

Initializing projects IS bootstrapping with modern best practices, then optionally setting up an agent system.

Don't just create files—research current docs, confirm with the user, then build.

Core principle: Research current best practices. Don't assume—verify with official docs.

Routing

Pattern: Chain Handoff: user-confirmation Next: migrating-agent-systems（agent system 唯一入口） Chain: bootstrap

Task Initialization (MANDATORY)

Follow task initialization protocol.

Tasks:

1. Gather requirements
2. Research best practices
3. Write blueprint and get confirmation
4. Bootstrap project
5. Validate project
6. Offer agent system setup

Announce: "Created 6 tasks. Starting execution..."

Task 1: Gather Requirements

Goal: Understand what project to create.

First, ask Project Type:

Project Type	Follow-up Questions
Frontend SPA	Language, Framework, UI Library, Styling, State, Testing
Full-stack App	Above + ORM, Database, API Style, Auth
API Service	Language, Framework, ORM, Validation, Auth
CLI Tool	Language, Package Manager, Testing
Library	Language, Build Tool, Testing, Docs

Ask iteratively. Skip already-answered or N/A questions.

Verification: Have answers to all relevant questions for project type.

Task 2: Research Best Practices

Goal: Find current best practices for the chosen stack.

Use WebSearch to find:

• Latest stable version of framework
• Official CLI/init command with current flags
• Recommended project structure
• Current best practices

Important: Don't assume versions or flags from training data. Official docs change frequently.

Verification: Have official init command and current version numbers from live sources.

Task 3: Write Blueprint and Get Confirmation

Goal: Present a complete plan for user approval before creating anything.

Present the blueprint directly to the user (do NOT write to a file — the project directory doesn't exist yet).

Blueprint Format

## Stack
- Language: [name] [version]
- Framework: [name] [version]
- Package manager: [choice]

## Initialization Command
[official CLI command with flags]

## Project Structure
[Expected directory layout after init]

## Key Dependencies
[Core packages to add, with purpose]

Important: Present FULL detail. The user must see exact versions, flags, and dependency list to catch mistakes.

Ask: "這個 blueprint 正確嗎？要開始執行嗎？"

If rejected: Revise based on feedback, present again.

Verification: User has reviewed the full blueprint and explicitly approved.

Task 4: Bootstrap Project

Goal: Run the official CLI to create the project.

Process:

1. Run the official init command from blueprint
2. Install additional dependencies if needed
3. Apply any post-init configurations

Verification: Project directory exists with expected structure.

Task 5: Validate Project

Goal: Verify the project builds and runs.

Checklist:

• Project builds without errors
• Project runs without errors (dev server starts, CLI executes, tests pass)
• Directory structure matches blueprint

If validation fails: Fix issues before proceeding. Do NOT skip to agent system setup with a broken project.

Verification: All checklist items pass.

Task 6: Offer Agent System Setup

Goal: Ask the user if they want a Claude Code agent system for this project.

Present options:

• Set up agent system — invoke migrating-agent-systems（唯一入口，由該 skill 決定範圍與流程）
• Skip — no agent system

If set up:

• Invoke migrating-agent-systems skill
• It will detect maturity = None and route to the full pipeline (brainstorm → plan → apply → review)
• Agent system 的範圍（full vs minimal）由 migrating-agent-systems 內部與使用者討論決定

If Skip:

• End

Important: 不得繞過 migrating-agent-systems 直接呼叫 writing-claude-md 或其他 component skill。migrating-agent-systems 是 agent system 設定的唯一入口。

Verification: User's choice is executed or skipped.

Red Flags - STOP

These thoughts mean you're rationalizing. STOP and reconsider:

• "I know the current version"
• "Skip research, I've done this before"
• "Don't need user confirmation"
• "A brief summary is enough for confirmation"
• "Write the blueprint to a file first"
• "Skip validation, it's a fresh project"

All of these mean: You're about to create a weak foundation. Follow the process.

Common Rationalizations

Excuse	Reality
"I know the version"	Versions change monthly. Verify with official docs.
"Skip research"	Best practices evolve. Check live sources.
"Skip confirmation"	Blueprint approval prevents wasted effort.
"Brief summary"	Brief summaries hide wrong decisions. Show full detail.
"Write blueprint to file"	Project directory doesn't exist yet. Present inline.
"Fresh = working"	Fresh projects can have config issues. Validate.

Skill Chain Reference (Bootstrap)

Step	Skill	Purpose
agent system	migrating-agent-systems	唯一入口。Detects None maturity → brainstorm → plan → apply → review