/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](../../references/task-initialization.md).

**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 |