|
| 1 | +# Frequently Asked Questions |
| 2 | + |
| 3 | +## Do I need to set up a CONDUCTOR_GITHUB_TOKEN? |
| 4 | + |
| 5 | +**No!** Code Conductor uses GitHub's built-in authentication (`${{ github.token }}`) for all workflows. This token is automatically available in GitHub Actions with no setup required. |
| 6 | + |
| 7 | +You only need a Personal Access Token (PAT) if you want: |
| 8 | +- Higher API rate limits (5,000/hour vs 1,000/hour) |
| 9 | +- Cross-repository access |
| 10 | +- Ability to trigger other workflows |
| 11 | + |
| 12 | +For detailed token information, see [.conductor/GITHUB_TOKEN_SETUP.md](.conductor/GITHUB_TOKEN_SETUP.md). |
| 13 | + |
| 14 | +## Why does Code Conductor require Python? |
| 15 | + |
| 16 | +Python is required **only for the conductor orchestration scripts**, not for your project's CI/CD. Here's what this means: |
| 17 | + |
| 18 | +- ✅ **Required**: Python 3.9-3.12 to run conductor commands |
| 19 | +- ❌ **NOT added**: Python test runners (pytest) |
| 20 | +- ❌ **NOT added**: Python linters (flake8, black) |
| 21 | +- ❌ **NOT added**: Python security scanners (safety) |
| 22 | +- ❌ **NOT added**: Any Python-specific CI/CD workflows |
| 23 | + |
| 24 | +Your project's existing CI/CD remains unchanged. Code Conductor only adds three language-agnostic GitHub workflows for task orchestration. |
| 25 | + |
| 26 | +## Does Code Conductor add Python CI/CD to my JavaScript/TypeScript/Go project? |
| 27 | + |
| 28 | +**No!** Code Conductor is language-agnostic. It detects your project's technology stack and configures roles accordingly, but it does NOT add language-specific CI/CD workflows. |
| 29 | + |
| 30 | +The only workflows added are: |
| 31 | +1. `conductor.yml` - Task orchestration and health checks |
| 32 | +2. `conductor-cleanup.yml` - Stale worktree cleanup |
| 33 | +3. `pr-review.yml` - AI code reviews (if enabled) |
| 34 | + |
| 35 | +These workflows only run conductor scripts and do not test, lint, or build your code. |
| 36 | + |
| 37 | +## What if I see Python test failures in my CI? |
| 38 | + |
| 39 | +If you're seeing Python test failures like: |
| 40 | +``` |
| 41 | +============================= test session starts ============================== |
| 42 | +collected 0 items |
| 43 | +============================ no tests ran in 0.02s ============================= |
| 44 | +Error: Process completed with exit code 5. |
| 45 | +``` |
| 46 | + |
| 47 | +This is NOT from Code Conductor. Check if: |
| 48 | +1. You accidentally copied CI workflows from the Code Conductor repository itself |
| 49 | +2. You have existing Python CI workflows in your project |
| 50 | +3. Another tool added Python-specific workflows |
| 51 | + |
| 52 | +Code Conductor's template workflows do not include any Python testing commands. |
| 53 | + |
| 54 | +## Can I use Code Conductor without installing Python? |
| 55 | + |
| 56 | +Currently, Python is required because the conductor scripts are written in Python. We chose Python for: |
| 57 | +- Maximum compatibility across all platforms |
| 58 | +- Easy installation via standard package managers |
| 59 | +- Reliable YAML and JSON processing |
| 60 | +- Strong GitHub API support |
| 61 | + |
| 62 | +Future versions may offer alternative implementations, but Python remains the most universal choice. |
| 63 | + |
| 64 | +## Do I need to manage Python dependencies for my non-Python project? |
| 65 | + |
| 66 | +No, the Python dependencies are isolated to Code Conductor's functionality: |
| 67 | +- `pyyaml` - For configuration file handling |
| 68 | +- Standard library modules only |
| 69 | + |
| 70 | +These are only used by conductor scripts and do not affect your project's dependencies. |
| 71 | + |
| 72 | +## How do I know which workflows were added by Code Conductor? |
| 73 | + |
| 74 | +Code Conductor only adds workflows from its templates: |
| 75 | +- `.github/workflows/conductor.yml` |
| 76 | +- `.github/workflows/conductor-cleanup.yml` |
| 77 | +- `.github/workflows/pr-review.yml` (if code-reviewer role is enabled) |
| 78 | + |
| 79 | +Any other workflows (especially those running pytest, flake8, etc.) are from other sources. |
| 80 | + |
| 81 | +## Can I remove the Python dependency from Code Conductor? |
| 82 | + |
| 83 | +The conductor scripts require Python to run. However, you can: |
| 84 | +1. Run agents from the Conductor app (macOS) which handles Python internally |
| 85 | +2. Use containerized environments where Python is pre-installed |
| 86 | +3. Install Python in your CI environment only (not locally) |
| 87 | + |
| 88 | +The Python requirement is minimal and doesn't affect your project's runtime or deployment. |
0 commit comments