OCTALUME: Agent for Claude Code

LIFECYCLE INITIALIZER AGENT

First-Run Setup Agent for Long-Running Projects

This agent runs once when a new project starts. It creates the complete environment that all subsequent coding agents will need to work effectively across multiple context windows.

Based on Anthropic's "Effective Harnesses for Long-Running Agents" research.

---

INITIALIZER RESPONSIBILITIES

1. Project Structure Setup

Create the complete directory structure for the lifecycle:

# Directory structure to create
project/
├── .claude/
│   ├── project-state.json          # Project state tracking
│   ├── claude-progress.txt         # Progress log
│   └── agents/                     # Agent configurations
├── docs/
│   ├── vision/                     # Phase 1 artifacts
│   ├── requirements/               # Phase 2 artifacts
│   ├── architecture/               # Phase 3 artifacts
│   ├── design/                     # Phase 3 artifacts
│   └── testing/                    # Phase 6 artifacts
├── src/
├── tests/
├── scripts/
│   └── init.sh                     # Development server startup
├── feature_list.json               # Complete feature list
├── traceability.json               # Artifact traceability
└── README.md

2. Feature List Creation

CRITICAL: Create a comprehensive feature list that expands on the user's initial prompt. This prevents agents from "declaring victory too early" or attempting to one-shot the entire project.

// feature_list.json - Template
{
  "project_name": "Project Name",
  "project_description": "Brief description",
  "features": [
    {
      "id": "F-001",
      "category": "functional",
      "phase": "phase_01_vision_strategy",
      "description": "User can register for an account",
      "acceptance_criteria": [
        "User can navigate to registration page",
        "User can enter email, password, and confirm password",
        "System validates email format",
        "System validates password strength",
        "Account is created on valid submission",
        "User receives confirmation email"
      ],
      "status": "failing",
      "priority": "P0",
      "dependencies": [],
      "assignee": "Product Owner",
      "artifacts": [],
      "verification_steps": [
        "Navigate to /register",
        "Enter [email protected] as email",
        "Enter SecurePass123! as password",
        "Submit form",
        "Verify account created",
        "Verify confirmation email sent"
      ]
    }
    // ... hundreds of features for enterprise project
  ],
  "metadata": {
    "total_features": 0,
    "completed_features": 0,
    "current_phase": "phase_01_vision_strategy",
    "created_at": "2025-01-11T00:00:00Z",
    "updated_at": "2025-01-11T00:00:00Z"
  }
}