AC Config Manager

Centralized configuration management for the Auto-Claude replication skill set.

Overview

Manages all configuration for autonomous coding:

• Environment variables
• Provider settings (LLM, embeddings, memory)
• Build configuration
• Safety limits
• Path management

Quick Start

Load Configuration

from scripts.config_manager import ConfigManager

config = ConfigManager(project_dir)
settings = config.load()

# Access settings
model = settings.model  # claude-opus-4-5-20251101
max_iterations = settings.max_iterations  # 50

Create Configuration

config.create_default_config()
# Creates .claude/autonomous-config.json with defaults

Update Configuration

config.update({
    "max_iterations": 30,
    "max_cost_usd": 15.00,
    "verbose": True
})

Configuration Schema

.claude/autonomous-config.json

{
  "enabled": true,
  "objective": "Build feature X",
  "success_criteria": [
    "All tests pass",
    "Code coverage > 80%"
  ],
  "max_iterations": 50,
  "max_cost_usd": 20.00,
  "max_consecutive_failures": 3,
  "max_runtime_minutes": 480,
  "analyzer_model": "claude-sonnet-4-20250514",
  "verbose": false,
  "notify_on_complete": true
}

Environment Variables

Variable	Required	Default	Description
ANTHROPIC_API_KEY	Yes	-	API key for Claude
AUTO_BUILD_MODEL	No	claude-opus-4-5-20251101	Model for builds
DEFAULT_BRANCH	No	auto-detect	Base branch
GRAPHITI_ENABLED	No	true	Enable memory
GRAPHITI_LLM_PROVIDER	No	openai	LLM for memory
GRAPHITI_EMBEDDER_PROVIDER	No	openai	Embeddings
DEBUG	No	false	Debug logging
DEBUG_LEVEL	No	1	Verbosity (1-3)

Build Configuration

@dataclass
class BuildConfig:
    model: str = "claude-opus-4-5-20251101"
    max_thinking_tokens: dict = field(default_factory=lambda: {
        'planner': 5000,
        'coder': None,
        'qa_reviewer': 10000,
        'qa_fixer': None
    })
    max_iterations: int = 50
    max_parallel_agents: int = 4
    skip_qa: bool = False
    timeout_ms: int = 600000

Operations

1. Load Configuration

settings = config.load()
# Merges: defaults → env vars → config file → overrides

2. Validate Configuration

errors = config.validate()
if errors:
    for error in errors:
        print(f"Config error: {error}")

3. Get Provider Settings

memory_config = config.get_memory_config()
# Returns Graphiti configuration

build_config = config.get_build_config()
# Returns build settings

4. Path Management

paths = config.get_paths()
# Returns:
#   specs_dir: .auto-claude/specs/
#   worktrees_dir: .worktrees/auto-claude/
#   memory_dir: .claude/memory/
#   checkpoints_dir: .claude/checkpoints/

Default Values

Setting	Default	Description
enabled	false	Autonomous mode
max_iterations	50	Max loop iterations
max_cost_usd	20.00	Budget limit
max_consecutive_failures	3	Before escalation
max_runtime_minutes	480	8 hour limit
context_threshold	0.85	Trigger handoff
auto_checkpoint	true	Create checkpoints

Integration Points

• ac-state-tracker: Loads state config
• ac-session-manager: Gets session settings
• ac-memory-manager: Gets memory provider config
• ac-cost-optimizer: Gets budget limits
• ac-opus-analyzer: Gets analyzer model

References

• references/CONFIG-SCHEMA.md - Full schema documentation
• references/ENVIRONMENT.md - Environment variable guide

Scripts

• scripts/config_manager.py - Core ConfigManager class
• scripts/config_schema.py - Configuration schemas
• scripts/path_manager.py - Path utilities