Initializer Agent

First-session agent that sets up the foundation for autonomous coding projects.

Quick Start

Initialize a Project

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

from scripts.feature_generator import generate_features

features = await generate_features(
    spec="E-commerce platform with cart and checkout",
    count=100  # Generate 100 features
)

Initialization Workflow

┌─────────────────────────────────────────────────────────────┐
│                  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                           │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Output Artifacts

feature_list.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

#!/bin/bash
set -e

# Install dependencies
npm install

# Set up database
npx prisma migrate dev

# Start development server
npm run dev &

claude-progress.txt

# Session Progress

## Session 1 - 2025-01-15 10:00

### Accomplishments
- Analyzed project specification
- Generated 150 feature requirements
- Created project structure
- Set up development environment

### Next Steps
- Begin implementing auth-001: User signup

Feature Categories

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

Integration Points

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

References

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

Templates

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

Scripts

• 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