Method Start

internal/loop/manager.go:211–255

Start starts the loop for a specific PRD.

(name string)

// Start starts the loop for a specific PRD.
func (m *Manager) Start(name string) error {
	if m.provider == nil {
		return fmt.Errorf("manager provider is not configured")
	}

	m.mu.Lock()
	instance, exists := m.instances[name]
	m.mu.Unlock()

	if !exists {
		return fmt.Errorf("PRD %s not found", name)
	}

	instance.mu.Lock()
	if instance.State == LoopStateRunning {
		instance.mu.Unlock()
		return fmt.Errorf("PRD %s is already running", name)
	}

	// Create a new loop instance, using worktree-aware constructor if WorktreeDir is set.
	// When no worktree is configured, run from the project root (baseDir) so that
	// CLAUDE.md and other project-level files are visible to Claude.
	workDir := instance.WorktreeDir
	if workDir == "" {
		m.mu.RLock()
		workDir = m.baseDir
		m.mu.RUnlock()
	}
	instance.Loop = NewLoopWithWorkDir(instance.PRDPath, workDir, "", m.maxIter, m.provider)
	instance.Loop.buildPrompt = promptBuilderForPRD(instance.PRDPath)
	m.mu.RLock()
	instance.Loop.SetRetryConfig(m.retryConfig)
	m.mu.RUnlock()
	instance.ctx, instance.cancel = context.WithCancel(context.Background())
	instance.State = LoopStateRunning
	instance.StartTime = time.Now()
	instance.Error = nil
	instance.mu.Unlock()

	// Start the loop in a goroutine
	m.wg.Add(1)
	go m.runLoop(instance)

	return nil
}

// runLoop runs a loop instance and forwards events.
func (m *Manager) runLoop(instance *LoopInstance) {