code-conductor: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Code Conductor is an AI agent coordination system designed to orchestrate multiple AI coding agents (like Claude Code, Conductor, Warp) working on the same codebase. It provides GitHub-native task management with automatic conflict prevention through git worktrees.

IMPORTANT: This is a template repository. When you encounter Code Conductor files in a project, they have been imported to enable automated agent coordination. Work autonomously based on GitHub Issues with the conductor:task label and the guidance in these files.

Documentation Map

CRITICAL: When starting work on any task, check if .conductor/documentation-map.yaml exists. This file contains:

• Comprehensive project analysis and structure
• Technology stack details and dependencies
• List of completed vs. pending features
• Implementation status and critical paths
• Architectural decisions and constraints

If this file exists, load it to understand the project context before beginning work. This map is created by the [INIT] discovery task and provides essential context for all subsequent tasks.

Key Development Commands

Running Tests

# Run all tests
python -m pytest tests/ -v

# Run specific test file
python tests/test_basic.py
python tests/test_stack_detection.py

Linting and Formatting

# Check code formatting (without making changes)
black --check .conductor/scripts/ setup.py

# Apply formatting
black .conductor/scripts/ setup.py

# Run linting
flake8 .conductor/scripts/ setup.py --max-line-length=88 --extend-ignore=E203,W503

Validation Commands

# Validate conductor configuration
python .conductor/scripts/validate-config.py

# Check system dependencies
python .conductor/scripts/dependency-check.py

# Run health check
python .conductor/scripts/health-check.py

Architecture Overview

Core Components