project-initializer

Project Initializer

Create a new project with memory structure for the 3-phase workflow.

Activation

Activate when you detect:

• "Start new project" or "Initialize project X"
• /drupal-dev-framework:new command
• Beginning development work that needs tracking

Workflow

1. Get Project Name

Ask:

What should this project be called?
(lowercase, letters, numbers, underscores only)

Validate the name matches pattern ^[a-z][a-z0-9_]*$. If invalid, ask again.

2. Get Storage Location

Read the registry at ~/.claude/drupal-dev-framework/active_projects.json. Check if projectsBase is set.

If projectsBase exists — use it as default:

Where should project files be stored?

Default: {projectsBase}/{project_name}/

Options:
1. Accept default
2. Enter custom path

Your choice:

If projectsBase is NOT set (first-time setup) — ask:

Where do you keep your project memory files?
This folder will store architecture docs, task files, and project state.

Enter the base path (all projects will be created as subfolders here):

Save the chosen base path as projectsBase in the registry (see Step 7).

Convert relative paths to absolute. Store the full path.

3. Check Path

Use Bash to check if folder exists:

ls -la {chosen_path}

If exists, ask: "Folder exists. Overwrite, use different name, or cancel?"

4. Create Structure

Use Bash to create folders:

mkdir -p {path}/{project_name}/architecture
mkdir -p {path}/{project_name}/implementation_process/in_progress
mkdir -p {path}/{project_name}/implementation_process/completed

5. Create project_state.md

Use Write tool to create {path}/{project_name}/project_state.md:

# {Project Name}

**Created:** {YYYY-MM-DD}
**Status:** Initializing
**Path:** {full_path_to_project_folder}

## Overview
{To be filled during requirements gathering}

## Scope
This project includes:
- {To be defined}

## Requirements
{Populated by requirements-gatherer}

## Current Implementation Task
Working on: None - define tasks after requirements are gathered
File: -

## Up Next
Queued: {Tasks to work on after current task}

## Completed Implementation Tasks
{Empty initially}

## Key Decisions
{Empty initially}

## Current Focus
Initial setup - gathering requirements

Notes:

• The project does NOT have a phase. Each TASK has its own phase (Research → Architecture → Implementation)
• Multiple tasks can be in implementation_process/in_progress/ simultaneously
• Task files in in_progress/ contain the task's current phase and progress
• Move completed task files to implementation_process/completed/

6. Create Empty architecture/main.md

Use Write tool:

# {Project Name} Architecture

{To be designed in Phase 2}

7. Register Project

Add project to the registry at ~/.claude/drupal-dev-framework/active_projects.json.

First, ensure the directory exists:

mkdir -p ~/.claude/drupal-dev-framework

Then read existing registry (or create new if doesn't exist) and add the project:

Registry Schema:

{
  "version": "1.1",
  "projectsBase": "{user's chosen base path for all projects}",
  "projects": [
    {
      "name": "{project_name}",
      "path": "{full_path_to_project}",
      "created": "{YYYY-MM-DD}",
      "lastAccessed": "{YYYY-MM-DD}",
      "status": "active"
    }
  ]
}

• projectsBase — set once on first project creation, reused as default for all future projects
• path — always the full absolute path to the specific project folder
• No phase field — phase is tracked per-task in task files, not per-project

Use Read to load existing registry, then Write to save updated version with new project appended.

If registry doesn't exist, create it with projectsBase and this project.

8. Invoke Requirements Gatherer

After structure is created, invoke requirements-gatherer skill to populate requirements.

9. Confirm

Show user:

Project initialized at: {full_path}

Created:
- project_state.md
- architecture/main.md
- implementation_process/in_progress/
- implementation_process/completed/

Next: Answer requirements questions to complete Phase 1 setup.

10. After Requirements Gathered

Once requirements-gatherer completes and user confirms, show:

Requirements gathering complete.

Run `/drupal-dev-framework:next` to get your next recommended action.

Do NOT manually list commands like /research or /design. Always direct to /next for intelligent routing.

Stop Points

STOP and wait for user response:

• After asking for project name
• After asking for storage location
• Before creating folders if path exists
• After showing confirmation