adaptationio/initializer-agent

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