.env.example

# HelixSpecifier Configuration
# All variables use the HELIX_SPECIFIER_ prefix.
# Unset variables fall back to sensible defaults.

# --- Effort Classification ---

# Maximum minutes for a task to be classified as "quick".
HELIX_SPECIFIER_QUICK_MAX_MINUTES=5

# Maximum minutes for a task to be classified as "medium".
HELIX_SPECIFIER_MEDIUM_MAX_MINUTES=90

# Maximum hours for a task to be classified as "large".
# Tasks exceeding this are classified as "epic".
HELIX_SPECIFIER_LARGE_MAX_HOURS=16

# --- Ceremony Scaling ---

# Enable adaptive ceremony adjustment based on phase quality.
# When true, ceremony level can be raised or lowered mid-flow.
HELIX_SPECIFIER_ADAPTIVE_CEREMONY=true

# Ceremony boost factor. When > 0, initial ceremony is raised
# by one level. Set to 0.0 for no boost.
HELIX_SPECIFIER_CEREMONY_BOOST=0.0

# --- Debate Rounds Per Phase ---
# Number of multi-LLM debate rounds for each SpecKit phase.
# Higher values produce more refined output but take longer.

HELIX_SPECIFIER_CONSTITUTION_ROUNDS=5
HELIX_SPECIFIER_SPECIFY_ROUNDS=3
HELIX_SPECIFIER_CLARIFY_ROUNDS=3
HELIX_SPECIFIER_PLAN_ROUNDS=4
HELIX_SPECIFIER_TASKS_ROUNDS=2
HELIX_SPECIFIER_ANALYZE_ROUNDS=4
HELIX_SPECIFIER_IMPLEMENT_ROUNDS=6

# --- Caching ---

# Enable phase result caching for flow resumption.
HELIX_SPECIFIER_CACHE_ENABLED=true

# Directory for cached phase results.
HELIX_SPECIFIER_CACHE_DIR=.helixspecifier/cache

# --- Parallel Execution ---

# Maximum number of subagents running in parallel during
# the Superpowers execution phase.
HELIX_SPECIFIER_MAX_PARALLEL_AGENTS=4

# Maximum number of tasks executing in parallel.
HELIX_SPECIFIER_MAX_PARALLEL_TASKS=8

# --- Spec Memory & Learning ---

# Enable specification memory for pattern learning.
HELIX_SPECIFIER_SPEC_MEMORY_ENABLED=true

# Enable cross-project knowledge transfer.
HELIX_SPECIFIER_CROSS_PROJECT_LEARN=true

# --- Quality Thresholds ---

# Minimum overall quality score for a flow to be considered
# successful. Range: 0.0 to 1.0.
HELIX_SPECIFIER_MIN_QUALITY_SCORE=0.6

# Minimum quality score per phase. Phases below this trigger
# warning logs.
HELIX_SPECIFIER_MIN_PHASE_SCORE=0.5

# --- Circuit Breaker ---

# Number of consecutive failures before the circuit breaker
# opens and stops sending requests.
HELIX_SPECIFIER_CIRCUIT_BREAKER_THRESHOLD=5