setup

Conductor Setup

Initialize or resume Conductor project setup. This command creates foundational project documentation through interactive Q&A.

Pre-flight Checks

1. Check if conductor/ directory already exists in the project root:

   • If conductor/product.md exists: Ask user whether to resume setup or reinitialize
   • If conductor/setup_state.json exists with incomplete status: Offer to resume from last step

2. Detect project type by checking for existing indicators:

   • Greenfield (new project): No .git, no package.json, no requirements.txt, no go.mod, no src/ directory
   • Brownfield (existing project): Any of the above exist

3. Load or create conductor/setup_state.json:

   {
     "status": "in_progress",
     "project_type": "greenfield|brownfield",
     "current_section": "product|guidelines|tech_stack|workflow|styleguides",
     "current_question": 1,
     "completed_sections": [],
     "answers": {},
     "files_created": [],
     "started_at": "ISO_TIMESTAMP",
     "last_updated": "ISO_TIMESTAMP"
   }
   

Interactive Q&A Protocol

CRITICAL RULES:

• Ask ONE question per turn
• Wait for user response before proceeding
• Offer 2-3 suggested answers plus "Type your own" option
• Maximum 5 questions per section
• Update setup_state.json after each successful step
• Validate file writes succeeded before continuing

Section 1: Product Definition (max 5 questions)

Q1: Project Name

What is your project name?

Suggested:
1. [Infer from directory name]
2. [Infer from package.json/go.mod if brownfield]
3. Type your own

Q2: Project Description

Describe your project in one sentence.

Suggested:
1. A web application that [does X]
2. A CLI tool for [doing Y]
3. Type your own

Q3: Problem Statement

What problem does this project solve?

Suggested:
1. Users struggle to [pain point]
2. There's no good way to [need]
3. Type your own

Q4: Target Users

Who are the primary users?

Suggested:
1. Developers building [X]
2. End users who need [Y]
3. Internal teams managing [Z]
4. Type your own