initializer-agent

Initialize a Project

```python

from scripts.initializer import InitializerAgent

agent = InitializerAgent(project_dir)

result = await agent.initialize_project(

spec="Build a task management app with user auth",

tech_stack=["nextjs", "typescript", "prisma"]

)

```

Generate Feature List

```python

from scripts.feature_generator import generate_features

features = await generate_features(

spec="E-commerce platform with cart and checkout",

count=100 # Generate 100 features

)

```

```

┌─────────────────────────────────────────────────────────────┐

│ INITIALIZER WORKFLOW │

├─────────────────────────────────────────────────────────────┤

│ │

│ 1. READ PROJECT SPECIFICATION │

│ ├─ Parse requirements │

│ ├─ Identify technology stack │

│ └─ Determine project structure │

│ │

│ 2. GENERATE FEATURE LIST │

│ ├─ Create 100-200 features │

│ ├─ Categorize (functional, UI, API, etc.) │

│ ├─ Add verification steps │

│ └─ Set initial priority │

│ │

│ 3. CREATE ENVIRONMENT SCRIPT │

│ ├─ Dependency installation │

│ ├─ Database setup │

│ ├─ Environment variables │

│ └─ Development server │

│ │

│ 4. SCAFFOLD PROJECT │

│ ├─ Create directory structure │

│ ├─ Initialize package.json/pyproject.toml │

│ ├─ Create base configuration │

│ └─ Set up testing framework │

│ │

│ 5. MAKE INITIAL COMMIT │

│ ├─ git init │

│ ├─ Add all files │

│ └─ Commit: "Initial project setup" │

│ │

│ 6. SAVE STATE │

│ ├─ Write feature_list.json │

│ ├─ Write init.sh │

│ └─ Create claude-progress.txt │

│ │

└─────────────────────────────────────────────────────────────┘

```

feature_list.json

```json

[

{

"id": "auth-001",

"category": "functional",

"description": "User can sign up with email and password",

"steps": [

"Navigate to signup page",

"Enter email address",

"Enter password (min 8 chars)",

"Click submit",

"Verify account created"

],

"passes": false,

"priority": 1

}

]

```

init.sh

```bash

#!/bin/bash

set -e

# Install dependencies

npm install

# Set up database

npx prisma migrate dev

# Start development server

npm run dev &

```

claude-progress.txt

```markdown

# Session Progress

Accomplishments

• Analyzed project specification
• Generated 150 feature requirements
• Created project structure
• Set up development environment

Next Steps

• Begin implementing auth-001: User signup

```

| Category | Description | Example |

|----------|-------------|---------|

| functional | Core functionality | User login, CRUD operations |

| ui | User interface | Forms, modals, navigation |

| api | API endpoints | REST routes, GraphQL |

| database | Data layer | Models, migrations |

| integration | External services | OAuth, payments |

| performance | Speed/efficiency | Caching, optimization |

| security | Protection | Input validation, auth |

| accessibility | A11y compliance | WCAG, ARIA |

| testing | Test coverage | Unit, integration, E2E |

• autonomous-session-manager: Detects INIT session type
• context-state-tracker: Creates initial state artifacts
• coding-agent: Picks up from initializer output

• references/INITIALIZER-WORKFLOW.md - Detailed workflow
• references/FEATURE-CATEGORIES.md - Category guidelines

• templates/init.sh.template - Environment setup
• templates/feature_list.json.template - Feature structure
• templates/progress.txt.template - Progress file

• scripts/initializer.py - Main InitializerAgent
• scripts/feature_generator.py - Feature list generation
• scripts/environment_setup.py - Init script creation
• scripts/project_scaffold.py - Project scaffolding